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

Artigo
08/01/2011

Cria um novo CustomTaskPane e o adiciona à atual CustomTaskPaneCollection. O painel de tarefas personalizado é baseado no usuário UserControl, tem o título especificado e está associado com a janela do aplicativo especificado.

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
A UserControl que fornece a interface do usuário para o novo painel de tarefas personalizado.

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

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

Valor de retorno

Tipo: Microsoft.Office.Tools.CustomTaskPane
A CustomTaskPane que representa o novo painel de tarefas personalizado.

Exceções

Exceção	Condição
ArgumentNullException	controlor title is nulluma referência nula (Nothing no Visual Basic).
ObjectDisposedException	O Dispose() método já foi chamado de CustomTaskPaneCollection.

Comentários

Use esse método para criar uma nova CustomTaskPane que está associado uma janela de aplicativo específico. Esse método é útil se você deseja criar painéis de tarefas personalizados que são visíveis com vários Inspectors Explorers no Outlook, ou com vários documentos do Word ou do InfoPath. For more information, see Gerenciando os painéis de tarefas personalizados em várias janelas de aplicativo.

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

Application	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 - ou - Microsoft.Office.Interop.Outlook.Inspector

Embora um CustomTaskPaneCollection é uma coleção de CustomTaskPane objetos, o Add método aceita UserControl objetos em vez de CustomTaskPane objetos. For more information, see Visão geral sobre painéis de tarefas personalizado.

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.