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

Artigo
01/09/2014

Cria um novo CustomTaskPane e adicioná-lo a CustomTaskPaneCollectionatual. O painel de tarefa personalizada é baseado em UserControlespecificado, tem o título especificado, e está 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 personalizada 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 um novo 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 inspetores ou exploradores em Outlook, ou com múltiplos documentos no 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
O Word	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 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 tarefa 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ável.