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

Artigo
05/21/2013

Cria um novo CustomTaskPane e adicioná-lo a CustomTaskPaneCollectionatual.O painel de tarefa personalizada é baseado em UserControlespecificado, tem o título especificado, e é associado com a janela especificada do aplicativo.

Namespace: Microsoft.Office.Tools
Assembly: Microsoft.Office.Tools.Common (em Microsoft.Office.Tools.Common.dll)

Sintaxe

'Declaração
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 fornece a interface de usuário para o novo painel de tarefa personalizada.

title
Tipo: System.String
O texto que aparece na barra de título do novo painel de tarefa personalizada.

window
Tipo: System.Object
Um objeto que representa a janela do aplicativo para associar o novo painel de tarefa customizada com.

Valor de retorno

Tipo: Microsoft.Office.Tools.CustomTaskPane
CustomTaskPane que representa o novo painel de tarefa personalizada.

Exceções

Exceção	Condição
ArgumentNullException	control ou title são nulluma referência nula (Nothing no Visual Basic).
ObjectDisposedException	O método de Dispose tiver sido chamado já CustomTaskPaneCollection.

Comentários

Use este método para criar uma nova CustomTaskPane que está associado com uma janela específica do aplicativo.Este método é útil se você desejar criar os painéis de tarefa personalizada que são visíveis com vários inspectores ou exploradores no Outlook, ou com múltiplos documentos em Word ou em InfoPath.

O tipo de parâmetro de window depende do aplicativo.A tabela a seguir lista os tipos válidos de parâmetro de window .

Application	Tipo de parâmetro
Palavra	Microsoft.Office.Interop.Word.Window
O excel	Microsoft.Office.Interop.Excel.Window
O Powerpoint	Microsoft.Office.Interop.PowerPoint.DocumentWindow
InfoPath	Microsoft.Office.Interop.InfoPath.WindowObject
Outlook	Microsoft.Office.Interop.Outlook.Explorer - ou - Microsoft.Office.Interop.Outlook.Inspector

Embora CustomTaskPaneCollection é uma coleção de objetos de CustomTaskPane , o método de Add aceita objetos de UserControl em vez de objetos de CustomTaskPane .Para obter mais informações, consulte Painéis de tarefas personalizados.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.