Metoda CustomTaskPaneCollection.Add — (UserControl, String, Object)

Artykuł
05/08/2013

Tworzy nową CustomTaskPane i dodaje go do bieżącego CustomTaskPaneCollection.Niestandardowe okienko zadań jest oparty na określonym UserControl, ma określony tytuł i wiąże się z okna określonej aplikacji.

Przestrzeń nazw: Microsoft.Office.Tools
Zestaw: Microsoft.Office.Tools.Common (w Microsoft.Office.Tools.Common.dll)

Składnia

'Deklaracja
Function Add ( _
    control As UserControl, _
    title As String, _
    window As Object _
) As CustomTaskPane

CustomTaskPane Add(
    UserControl control,
    string title,
    Object window
)

Parametry

control
Typ: System.Windows.Forms.UserControl
A UserControl , który pozwala interfejsu użytkownika nowe niestandardowe okienko zadań.

title
Typ: System.String
Tekst wyświetlany na pasku tytułu nowe niestandardowe okienko zadań.

window
Typ: System.Object
Obiekt, który reprezentuje okna aplikacji, aby skojarzyć nowe niestandardowe okienko zadań z.

Wartość zwracana

Typ: Microsoft.Office.Tools.CustomTaskPane
A CustomTaskPane , oznaczającą nowe niestandardowe okienko zadań.

Wyjątki

Wyjątek	Warunek
ArgumentNullException	controlor title is nullodwołanie o wartości null (Nothing w języku Visual Basic).
ObjectDisposedException	Dispose Metoda została już wywołana dla CustomTaskPaneCollection.

Uwagi

Metoda ta pozwala utworzyć nowy CustomTaskPane skojarzonego z kodem określonego okna aplikacji.Ta metoda jest przydatna, jeśli chcesz utworzyć niestandardowe okienka zadań, które są widoczne, z wieloma inspektorów lub eksploratorów w programie Outlook lub z wielu dokumentów w programie Word lub programu InfoPath.

Typ window parametr zależy od aplikacji.Poniższa lista zawiera prawidłowe typy window parametru.

Aplikacja	Typ parametru
Program Word	Microsoft.Office.Interop.Word.Window
Program Excel	Microsoft.Office.Interop.Excel.Window
Program PowerPoint	Microsoft.Office.Interop.PowerPoint.DocumentWindow
Program InfoPath	Microsoft.Office.Interop.InfoPath.WindowObject
Program Outlook	Microsoft.Office.Interop.Outlook.Explorer -lub- Microsoft.Office.Interop.Outlook.Inspector

Chociaż CustomTaskPaneCollection jest zbiorem CustomTaskPane obiektów, Add metoda przyjmuje UserControl obiektów, a nie CustomTaskPane obiektów.Aby uzyskać więcej informacji, zobacz Niestandardowe okienka zadań.

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..