CustomTaskPaneCollection.Add, méthode (UserControl, String, Object)

Article
08/10/2011

Crée un nouveau CustomTaskPane et l'ajoute à la CustomTaskPaneCollection en cours. Le volet Office personnalisé est basé sur le UserControl spécifié, il a le titre spécifié et il est associé à la fenêtre d'application spécifiée.

Espace de noms : Microsoft.Office.Tools
Assembly : Microsoft.Office.Tools.Common (dans Microsoft.Office.Tools.Common.dll)

Syntaxe

'Déclaration
Function Add ( _
    control As UserControl, _
    title As String, _
    window As Object _
) As CustomTaskPane

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

Paramètres

control
Type : System.Windows.Forms.UserControl
UserControl qui fournit l'interface utilisateur pour le nouveau volet Office personnalisé.

title
Type : System.String
Texte qui apparaît dans la barre de titre du nouveau volet Office personnalisé.

window
Type : System.Object
Objet représentant la fenêtre d'application à laquelle associer le nouveau volet Office personnalisé.

Valeur de retour

Type : Microsoft.Office.Tools.CustomTaskPane
CustomTaskPane qui représente le nouveau volet Office personnalisé.

Exceptions

Exception	Condition
ArgumentNullException	control ou title est nullune référence null (Nothing en Visual Basic).
ObjectDisposedException	La méthode Dispose() a déjà été appelée dans la CustomTaskPaneCollection.

Notes

Utilisez cette méthode pour créer un CustomTaskPane associé à une fenêtre d'application spécifique. Cette méthode est utile si vous souhaitez créer des volets de tâches personnalisés visibles au moyen de plusieurs inspecteurs ou explorateurs dans Outlook, ou bien avec plusieurs documents dans Word ou InfoPath. Pour plus d'informations, consultez Gestion des volets de tâches personnalisés dans plusieurs fenêtres d'application.

Le type du paramètre window dépend de l'application. Le tableau suivant répertorie les types de paramètre window valides.

Application	Type de paramètre
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 ou Microsoft.Office.Interop.Outlook.Inspector

Bien qu'un CustomTaskPaneCollection soit une collection d'objets CustomTaskPane, la méthode Add accepte les objets UserControl au lieu des objets CustomTaskPane. Pour plus d'informations, consultez Vue d'ensemble des volets de tâches personnalisés.

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.