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

Článek
08/23/2008

Aktualisiert: November 2007

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.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)

Syntax

'Declaration
Public Function Add ( _
    control As UserControl, _
    title As String, _
    window As Object _
) As CustomTaskPane
'Usage
Dim instance As CustomTaskPaneCollection
Dim control As UserControl
Dim title As String
Dim window As Object
Dim returnValue As CustomTaskPane

returnValue = instance.Add(control, title, _
    window)

public 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 hierzu 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 2007	Microsoft.Office.Interop.Word.Window
Excel 2007	Microsoft.Office.Interop.Excel.Window
PowerPoint 2007	Microsoft.Office.Interop.PowerPoint.DocumentWindow
InfoPath 2007	Microsoft.Office.Interop.InfoPath.WindowObject
Outlook 2007	Microsoft.Office.Interop.Outlook.Explorer - oder - Microsoft.Office.Interop.Outlook.Inspector

Obwohl die CustomTaskPaneCollection-Klasse eine Auflistung von CustomTaskPane-Objekten ist, akzeptiert die Add-Methode UserControl-Objekte anstelle von CustomTaskPane-Objekten. Weitere Informationen hierzu finden Sie unter Übersicht über benutzerdefinierte Aufgabenbereiche.

Berechtigungen

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.