Painéis de tarefas personalizados

Os painéis de tarefas são os painéis de interface do usuário que estão conectados normalmente um lado de uma janela em um aplicativo do Microsoft Office.Os painéis de tarefa personalizada oferecem uma maneira de criar seu próprio painel de tarefas e de fornecer aos usuários uma interface familiar para acessar os recursos da solução.Por exemplo, a interface pode conter controles que executam código para modificar documentos ou exibir dados de uma fonte de dados.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de aplicativo para Outlook 2013 e Outlook 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Observação
Um painel de tarefa personalizada difere do painel de ações.O painel de ações é parte da personalizações de nível para o Microsoft Office Word e Microsoft Office Excel.Para obter mais informações, consulte Visão geral do painel de ações.

Benefícios de painéis de tarefa personalizada

Os painéis de tarefa personalizada permitem que você integrar seus recursos em uma interface do usuário familiarizado.Você pode criar um painel de tarefa personalizada rapidamente usando ferramentas do Visual Studio.

Interface do usuário familiar

Os usuários de aplicativos no Microsoft Office system já estão familiarizados com o uso dos painéis de tarefas como o painel de tarefas de Estilos e Formatação em palavras.Os painéis de tarefa personalizada se comportam como outros painéis de tarefas no Microsoft Office system.Os usuários podem inserir os painéis de tarefas diferentes personalizada para os lados da janela do aplicativo, ou podem arrastar os painéis de tarefa adequada para qualquer lugar na janela.Você pode criar um suplemento que exibe vários painéis de tarefa personalizada ao mesmo tempo, e os usuários podem controlar cada painel de tarefas individualmente.

Suporte de formulários do windows

A interface do usuário de um painel de tarefa personalizada que você cria usando as ferramentas de desenvolvimento do Office no Visual Studio é baseada em controles dos formulários do windows.Você pode usar o windows forms designer de familiar para criar a interface do usuário para um painel de tarefa personalizada.Você também pode usar o suporte a associação de dados em formulários do windows para associar uma fonte de dados a controles no painel de tarefas.

Criando um painel de tarefa personalizada

Você pode criar um painel básico de tarefa personalizada em duas etapas:

1. Criar uma interface de usuário para o painel de tarefa personalizada adicionando controles de formulários do windows a um objeto de UserControl .

2. Crie uma instância do painel de tarefa personalizada passando o controle de usuário ao objeto de CustomTaskPaneCollection no suplemento.Esta coleção retorna um novo objeto de CustomTaskPane que você pode usar para alterar a aparência do painel de tarefas e responder a eventos do usuário.

Para obter mais informações, consulte Como: adiciona um painel de tarefas personalizado a um aplicativo.

Criando a interface do usuário

Todos os painéis de tarefa personalizada que são criados usando as ferramentas de desenvolvimento do Office no Visual Studio contém um objeto de UserControl .Este controle de usuário fornece a interface do usuário de seu painel de tarefa personalizada.Você pode criar o controle de usuário em tempo de design ou em tempo de execução.Se você criar um controle de usuário em tempo de design, você pode usar o windows forms designer para construir a interface do usuário do painel de tarefas.

Criar uma instância do painel de tarefa personalizada

Depois de criar um controle de usuário que contém a interface do usuário do painel de tarefa personalizada, você precisa criar uma instância CustomTaskPane.Para fazer isso, passe o controle de usuário a CustomTaskPaneCollection no suplemento chamando um dos métodos de Add .Esta coleção expostos como o campo de CustomTaskPanes da classe de ThisAddIn .O exemplo de código é executado da classe de ThisAddIn .

myUserControl1 = New MyUserControl
myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl1, "My Task Pane")
myCustomTaskPane.Visible = True

myUserControl1 = new MyUserControl();
myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1, "My Task Pane");
myCustomTaskPane.Visible = true;

os métodos de Add retornam um novo objeto de CustomTaskPane .Você pode usar esse objeto para alterar a aparência do painel de tarefas e responder a eventos do usuário.

Controlando o painel em várias tarefas do windows

Os painéis de tarefa personalizada são associados com uma janela de quadro do documento, que apresenta uma visão de um documento ou de um item para o usuário.o painel de tarefas é visível somente quando a janela associado é visível.

Para determinar qual janela exibe o painel de tarefa personalizada, use a sobrecarga apropriada do método de Add quando você cria o painel de tarefas:

• Para associar o painel de tarefas com a janela ativa, use o método de CustomTaskPaneCollection.Add(UserControl, String) .

• Para associar o painel de tarefas com um documento que é hospedado por uma janela especificada, use o método de CustomTaskPaneCollection.Add(UserControl, String, Object) .

Alguns aplicativos exigem do Office declarações explícitas para que quando criar ou exibe o painel de tarefas quando mais de uma janela é aberta.Isso torna importante considerar onde instanciar o painel de tarefa personalizada em seu código para garantir que o painel de tarefas exibido com os documentos ou itens apropriadas no aplicativo.Para obter mais informações, consulte Gerenciando os painéis de tarefa personalizada em janelas do aplicativo.

Acessando o aplicativo do painel de tarefas

Se você deseja automatizar o aplicativo do controle de usuário, você pode acessar diretamente o modelo de objeto usando Globals.ThisAddIn.Application no seu código.A classe de Globals estático fornece acesso ao objeto de ThisAddIn .O campo de Application de esse objeto é o ponto de entrada no modelo de objeto do aplicativo.

Para obter mais informações sobre o campo de Application do objeto de ThisAddIn , consulte Os suplementos de nível de aplicativo de programação..Para uma explicação passo a passo que demonstra como automatizar um aplicativo de um painel de tarefa personalizada, considere Passo a passo: Automatizando um aplicativo a partir de um painel de tarefas personalizado.Para obter mais informações sobre a classe Globals, consulte Acesso global a objetos em projetos do Office.

Gerenciando a interface do usuário do painel de tarefas

Depois de criar o painel de tarefas, você pode usar propriedades e eventos de CustomTaskPane objeto para controlar a interface do usuário do painel de tarefas e responder quando o usuário altera o painel de tarefas.

Fazendo o painel de tarefa personalizada visível

Por padrão, o painel de tarefas não estiver visível.para fazer o painel de tarefas visível, você deve definir a propriedade de Visible a true.

Os usuários podem fechar um painel de tarefas a qualquer momento clicando no botão de Fechar (X) no canto do painel de tarefas.Em o entanto, não há nenhuma maneira padrão para que os usuários abrir o painel de tarefa personalizada novamente.Se um usuário fecha um painel de tarefa personalizada, o usuário não pode exibir o painel de tarefa personalizada novamente a menos que você forneça uma maneira de exibir.

Se você criar um painel de tarefa personalizada no suplemento, você também deve criar um elemento de interface do usuário, como um botão, os usuários podem clicar para exibir ou ocultar o painel de tarefa personalizada.Se você criar um painel de tarefa personalizada em um aplicativo do Microsoft Office que suporta personalizar a fita, você pode adicionar um grupo de controles para fita com um botão que exibe ou ocultá-lo o painel de tarefa personalizada.Para uma explicação passo a passo que demonstra como fazer isso, considere Passo a passo: Sincronizando um painel de tarefas personalizado com o botão da faixa de opções.

Se você criar um painel de tarefa personalizada em um aplicativo do Microsoft Office que não oferece suporte personalizar a fita, você pode adicionar CommandBarButton que exibe ou oculta o painel de tarefa personalizada.

Alterando a aparência do painel de tarefas

Você pode controlar o tamanho e local de um painel de tarefa personalizada usando as propriedades do objeto de CustomTaskPane .Você pode fazer várias outras alterações na aparência de um painel de tarefa personalizada usando propriedades de UserControl para o objeto que está contida no painel de tarefa personalizada.Por exemplo, você pode especificar uma imagem de plano de fundo para um painel de tarefa personalizada usando a propriedade de BackgroundImage do controle de usuário.

A tabela a seguir lista as alterações que você pode fazer um painel de tarefa personalizada usando propriedades de CustomTaskPane .

Eventos do painel de tarefa de programação personalizada

Você pode querer que o suplemento ao responder quando o usuário altera o painel de tarefa personalizada.Por exemplo, se o usuário altera a orientação do painel de vertical a horizontal, convém reposicionar os controles.

A seguinte tabela lista os eventos que você pode manipular para responder às alterações que o usuário fizer o painel de tarefa personalizada.

Limpando recursos usados pelo painel de tarefas

Depois de criar um painel de tarefa personalizada, o objeto de CustomTaskPane permanece na memória enquanto o suplemento está sendo executado.O objeto permanece na memória mesmo após o usuário clica no botão de Fechar (X) no canto do painel de tarefas.

Para limpar os recursos usados pelo painel de tarefas quando o suplemento ainda executar, use os métodos de Remove ou de RemoveAt .Esses métodos remove o objeto especificado de CustomTaskPane de coleção de CustomTaskPanes , e chamar o método de Dispose do objeto.

Visual Studio Tools for Office Runtime faz automaticamente os recursos usados pelo painel de tarefa personalizada quando o suplemento é descarregado.Não chamar os métodos de Remove ou de RemoveAt no manipulador de eventos de ThisAddIn_Shutdown em seu projeto.Esses métodos irão acionar ObjectDisposedException, porque Visual Studio Tools for Office Runtime limpa os recursos usados pelo objeto de CustomTaskPane antes que ThisAddIn_Shutdown seja chamado.Para obter mais informações sobre ThisAddIn_Shutdown, consulte Eventos em projetos do Office

Gerenciando os painéis de tarefa personalizada no windows de várias aplicativo

Quando você cria um painel de tarefa personalizada em um aplicativo que usa várias janelas para exibir documentos e outros itens, você precisará executar etapas adicionais para garantir que o painel de tarefas é visível quando o usuário espera ser.

Os painéis de tarefa personalizada em todos os aplicativos são associados com uma janela de quadro do documento, que apresenta uma visão de um documento ou de um item para o usuário.o painel de tarefas é visível somente quando a janela associado é visível.Em o entanto, nem todas as janelas de quadro de documento dos aplicativos usam a mesma maneira.

Os seguintes grupos de aplicativo têm requisitos diferentes de desenvolvimento:

• Outlook

• Palavras, InfoPath, e o Powerpoint

Para uma demonstração de vídeo relacionada, consulte Como: eu faço Gerenciar os painéis de tarefas em suplementos do word?.

Outlook

Quando você cria um painel de tarefa personalizada para Outlook, o painel de tarefa personalizada está associado com uma janela específica de Explorer ou de inspector.Os exploradores são janelas que exibe o conteúdo de uma pasta, e os inspectores são janelas que exibem um item como uma mensagem de email ou uma tarefa.

Se você deseja exibir um painel de tarefa customizada com várias do windows Explorer ou de inspector, você precisa criar uma nova instância do painel de tarefa personalizada quando uma janela do Explorer ou de inspector abre.Para fazer isso, manipular um evento que é gerado quando uma janela do Explorer ou de inspector é criada, e para criar no painel de tarefas no manipulador de eventos.Você também pode manipular eventos de Explorer e de inspector para ocultar ou exibir os painéis de tarefas dependendo da janela é visível.

Para associar o painel de tarefas com Explorer ou inspector específico, usar o método de CustomTaskPaneCollection.Add(UserControl, String, Object) para criar o painel de tarefas, e passe o objeto de Explorer ou de Inspector para o parâmetro de window .Para obter mais informações sobre como criar os painéis de tarefa personalizada, consulte Painéis de tarefas personalizados.

Para uma explicação passo a passo que demonstra como criar um painel de tarefas para cada mensagem de email que é aberta, consulte Passo a passo: Exibindo os painéis de tarefas personalizados com mensagens de email no Outlook.

Eventos do Outlook

Para monitorar o estado do windows Explorer, você pode manipular os seguintes eventos relacionados ao:

• NewExplorer

• Activate

• Close

• Deactivate

Para monitorar o estado do windows de inspector, você pode manipular os seguintes eventos Inspector- relacionados:

• NewInspector

• Activate

• Close

• Deactivate

Evitando várias instâncias de um painel de tarefa personalizada no Outlook

Para impedir que o windows do Outlook exibam várias instâncias de um painel de tarefa personalizada, remover explicitamente o painel de tarefa de coleção personalizada de CustomTaskPanes da classe de ThisAddIn quando cada janela é fechada.Chame o método de Remove em um evento que é gerado quando uma janela é fechada, como ExplorerEvents_10_Event.Close ou InspectorEvents_10_Event.Close.

Se você não remover explicitamente o painel de tarefa personalizada, janelas do Outlook podem exibir várias instâncias do painel de tarefa personalizada.Outlook recicla às vezes o windows, e janelas recicladas manter referências a todos os painéis de tarefa personalizada que eles sejam anexados.

Palavras, InfoPath, e o Powerpoint

Exibição da palavra, de InfoPath, e o Powerpoint cada documento em uma janela diferente de quadro do documento.Quando você cria um painel de tarefa personalizada para esses aplicativos, o painel de tarefa personalizada está associado com apenas um documento específico.Se o usuário abrir um documento diferente, o painel de tarefa personalizada está oculta até que o documento anterior está visível novamente.

Se você deseja exibir um painel de tarefa customizada com vários documentos, crie uma nova instância do painel de tarefa personalizada quando o usuário cria um novo documento ou abrir um documento existente.Para fazer isso, o manipular eventos que são gerados quando um é criado ou documento aberto, e criar no painel de tarefas nos manipuladores de eventos.Você também pode manipular eventos do documento para ocultar ou exibir os painéis de tarefas dependendo do documento é visível.

Para associar o painel de tarefas com uma janela do documento específica, usar o método de CustomTaskPaneCollection.Add(UserControl, String, Object) para criar o painel de tarefas, e passar Microsoft.Office.Interop.Word.Window (para word), Microsoft.Office.Interop.InfoPath.WindowObject (para InfoPath), ou Microsoft.Office.Interop.PowerPoint.DocumentWindow () para o Powerpoint para o parâmetro de window .

Eventos do word

Para monitorar o estado do windows do documento em palavras, você pode manipular os eventos a seguir:

• DocumentBeforeClose

• DocumentOpen

• NewDocument

• WindowActivate

• WindowDeactivate

eventos de InfoPath

Para monitorar o estado do windows do documento em InfoPath, você pode manipular os eventos a seguir:

• NewXDocument

• WindowActivate

• WindowDeactivate

• XDocumentBeforeClose

• XDocumentOpen

Eventos do Powerpoint

Para monitorar o estado do windows do documento no Powerpoint, você pode manipular os eventos a seguir:

• AfterNewPresentation

• AfterPresentationOpen

• NewPresentation

• PresentationOpen

• WindowActivate

• WindowDeactivate

Consulte também

Tarefas

Como: adiciona um painel de tarefas personalizado a um aplicativo

Passo a passo: Automatizando um aplicativo a partir de um painel de tarefas personalizado

Passo a passo: Sincronizando um painel de tarefas personalizado com o botão da faixa de opções

Passo a passo: Exibindo os painéis de tarefas personalizados com mensagens de email no Outlook