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

Artikel
08/10/2011

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

control
Typ: System.Windows.Forms.UserControl
Das UserControl, das die Benutzeroberfläche für den neuen benutzerdefinierten Aufgabenbereich bereitstellt.

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 nullNULL-Verweis (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. Weitere Informationen finden Sie unter Verwalten von benutzerdefinierten Aufgabenbereichen in mehreren Anwendungsfenstern.

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 Übersicht über benutzerdefinierte Aufgabenbereiche.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.