CustomTaskPaneCollection.Add (Método) (UserControl, String, Object)
Crea un nuevo CustomTaskPane y lo agrega a la CustomTaskPaneCollection actual. El panel de tareas personalizado se basa en el UserControl especificado, que tiene el título especificado y está asociado a la ventana de aplicación especificada.
Espacio de nombres: Microsoft.Office.Tools
Ensamblado: Microsoft.Office.Tools.Common (en Microsoft.Office.Tools.Common.dll)
Sintaxis
'Declaración
Function Add ( _
control As UserControl, _
title As String, _
window As Object _
) As CustomTaskPane
CustomTaskPane Add(
UserControl control,
string title,
Object window
)
Parámetros
- control
Tipo: System.Windows.Forms.UserControl
UserControl que proporciona la interfaz de usuario del nuevo panel de tareas personalizado.
- title
Tipo: System.String
Texto que aparece en la barra de título del nuevo panel de tareas personalizado.
- window
Tipo: System.Object
Objeto que representa la ventana de aplicación a la que se va a asociar el nuevo panel de tareas personalizado.
Valor devuelto
Tipo: Microsoft.Office.Tools.CustomTaskPane
CustomTaskPane que representa el nuevo panel de tareas personalizado.
Excepciones
Excepción | Condición |
---|---|
ArgumentNullException | El valor de control o title es nullreferencia null (Nothing en Visual Basic). |
ObjectDisposedException | Ya se ha llamado al método Dispose() en CustomTaskPaneCollection. |
Comentarios
Utilice este método para crear un nuevo panel CustomTaskPane que esté asociado a una ventana de la aplicación específica. Este método es útil si desea crear paneles de tareas personalizados que estén visibles con varios inspectores o exploradores de Outlook, o con varios documentos de Word o InfoPath. Para obtener más información, vea Administrar paneles de tareas personalizados en varias ventanas de la aplicación.
El tipo del parámetro window dependerá de la aplicación. En la siguiente tabla se recogen los tipos válidos del parámetro window.
Aplicación |
Tipo de parámetro |
---|---|
Word |
|
Excel |
|
PowerPoint |
Microsoft.Office.Interop.PowerPoint.DocumentWindow |
InfoPath |
|
Outlook |
Microsoft.Office.Interop.Outlook.Explorer O bien |
Aunque un objeto CustomTaskPaneCollection es una colección de objetos CustomTaskPane, el método Add acepta objetos UserControl en lugar de objetos CustomTaskPane. Para obtener más información, vea Información general sobre los paneles de tareas personalizados.
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.
Vea también
Referencia
CustomTaskPaneCollection Interfaz
Microsoft.Office.Tools (Espacio de nombres)
Otros recursos
Información general sobre los paneles de tareas personalizados
Administrar paneles de tareas personalizados en varias ventanas de la aplicación