Freigeben über


CustomTaskPaneCollection.Add-Methode (UserControl, String, Object)

Erstellt einen neuen CustomTaskPane und fügt ihn der aktuellen CustomTaskPaneCollection hinzu.Der benutzerdefinierte Aufgabenbereich basiert auf dem angegebenen UserControl, verfügt über den angegebenen Titel und ist dem angegebenen Anwendungsfenster zugeordnet.

Namespace:  Microsoft.Office.Tools
Assembly:  Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Syntax

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

Parameter

  • title
    Typ: System.String
    Der Text, der in der Titelleiste des neuen benutzerdefinierten Aufgabenbereichs angezeigt wird.
  • window
    Typ: System.Object
    Ein Objekt, das das Anwendungsfenster darstellt, dem der neue benutzerdefinierte Aufgabenbereich zugeordnet werden soll.

Rückgabewert

Typ: Microsoft.Office.Tools.CustomTaskPane
Ein CustomTaskPane, der den neuen benutzerdefinierten Aufgabenbereich darstellt.

Ausnahmen

Ausnahme Bedingung
ArgumentNullException

control oder title ist nullein Nullverweis (Nothing in Visual Basic).

ObjectDisposedException

Die Dispose-Methode wurde bereits für die CustomTaskPaneCollection aufgerufen.

Hinweise

Verwenden Sie diese Methode, um einen neuen CustomTaskPane zu erstellen, der einem bestimmten Anwendungsfenster zugeordnet ist.Diese Methode ist nützlich, wenn Sie benutzerdefinierte Aufgabenbereiche erstellen möchten, die mit mehreren Inspektoren oder Explorern in Outlook bzw. mit mehreren Dokumenten in Word oder InfoPath angezeigt werden.

Der Typ des window-Parameters ist anwendungsspezifisch.In der folgenden Tabelle werden die gültigen Typen des window-Parameters aufgeführt.

Anwendung

Parametertyp

Word

Microsoft.Office.Interop.Word.Window

Excel

Microsoft.Office.Interop.Excel.Window

PowerPoint

Microsoft.Office.Interop.PowerPoint.DocumentWindow

InfoPath

Microsoft.Office.Interop.InfoPath.WindowObject

Outlook

Microsoft.Office.Interop.Outlook.Explorer

- oder -

Microsoft.Office.Interop.Outlook.Inspector

Obwohl eine CustomTaskPaneCollection eine Auflistung von CustomTaskPane-Objekten ist, akzeptiert die Add-Methode UserControl-Objekte anstelle von CustomTaskPane-Objekten.Weitere Informationen finden Sie unter Benutzerdefinierte Aufgabenbereiche.

.NET Framework-Sicherheit

Siehe auch

Referenz

CustomTaskPaneCollection Schnittstelle

Add-Überladung

Microsoft.Office.Tools-Namespace

Weitere Ressourcen

Benutzerdefinierte Aufgabenbereiche