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

Artykuł
01/08/2014

Tworzy nowy CustomTaskPane i dodaje go do bieżącego CustomTaskPaneCollection.Niestandardowe okienko zadań jest oparta 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 interfejsie użytkownika który przewiduje 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 reprezentująca nowe niestandardowe okienko zadań.

Wyjątki

Wyjątek	Warunek
ArgumentNullException	control lub title wynosi nullodwołanie o wartości null (Nothing w języku Visual Basic).
ObjectDisposedException	Dispose Została już wywołana metoda na CustomTaskPaneCollection.

Uwagi

Ta metoda służy do tworzenia nowego CustomTaskPane skojarzonego z określonego okna aplikacji.Ta metoda jest użyteczna, jeśli chcesz utworzyć niestandardowe okienka zadań widocznych 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.W poniższej tabeli przedstawiono 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 to kolekcja 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 Używanie bibliotek pochodzących z częściowo zaufanego kodu.