CustomTaskPaneCollection.Add (Método) (UserControl, String, Object)

Artículo
08/10/2011

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	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 O bien Microsoft.Office.Interop.Outlook.Inspector

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.