Visão geral de painéis de tarefas Personalizar

Artigo
08/25/2010

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e aplicativos do Microsoft Office. Tipo de Projeto Projetos de nível de aplicativo Aplicativo do Microsoft Office O Excel 2007 InfoPath 2007 Outlook 2007 PowerPoint 2007 Word 2007 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e aplicativos do Microsoft Office.

Tipo de Projeto

Projetos de nível de aplicativo

Aplicativo do Microsoft Office

O Excel 2007
InfoPath 2007
Outlook 2007
PowerPoint 2007
Word 2007

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Os painéis de tarefas estão painéis de interface do usuário que normalmente são encaixados em um dos lados de uma janela em um aplicativo do Microsoft Office.Painéis de tarefas Personalizars oferecem uma maneira de criar seu próprio painel de tarefas e fornecer aos usuários uma interface familiar para acessar recursos de sua solução.Por exemplo, a interface pode conter controles que executa o código para modificar documentos ou exibir dados de uma Origem de dados.

Você pode criar um painel de tarefas Personalizar apenas um aplicativo-nível Adicionar - in para um dos aplicativos do Microsoft Office listados acima.Não é possível criar um painel de tarefas personalizado em uma personalização de nível de documento.For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Observação:
Um painel de tarefas Personalizar é diferente do painel de ações.O painel de ações é parte de personalizações em nível de documento para Microsoft Office Word e Microsoft Office Excel.Para obter mais informações, consulte Visão geral painel Ações.

Benefícios de painéis de tarefas Personalizars

Painéis de tarefas Personalizar permitem integrar seus recursos em uma interface do usuário familiar.Você pode criar um painel de tarefas Personalizar rapidamente usando ferramentas do Visual Studio.

Interface do usuário familiar

Os usuários de aplicativos no Microsoft Office Sistema já estiver familiarizados com usar painéis de tarefas, como os estilos de E painel de tarefas de formatação no Word.Painéis de tarefas Personalizars se comportam como outros painéis de tarefas no Microsoft Office Sistema.Os usuários podem encaixar os painéis de tarefas Personalizars para diferentes lados da janela do aplicativo, ou podem arrastar os painéis de tarefas Personalizars em qualquer local na janela.Você pode criar um Adicionar - no que exibe Múltiplo Personalizar tarefas painéis ao mesmo tempo e os usuários podem controlar cada painel de tarefas individualmente.

Windows Forms Support

A interface de usuário de um painel de tarefas Personalizar que você criar usando Ferramentas do Visual Studio para o Office se baseia em controles Windows Forms.Você pode usar Windows Forms Designer familiar para projetar a interface do usuário para um painel de tarefas Personalizar.Você também pode usar o suporte de ligação de dados no Windows Forms vincular uma Origem de dados a controles no painel de tarefas.

Criar um painel de tarefas Personalizar

Você pode criar um Basic painel de tarefas Personalizar em duas etapas:

Criar uma interface de usuário para seu painel de tarefas Personalizar adicionando controles Windows Forms a um objeto de UserControl.
Instanciar o painel de tarefas Personalizar, passando o Controlarar de usuário para o objeto CustomTaskPaneCollection na sua Adicionar - in.Esta coleção retorna um objeto CustomTaskPane novo que você pode usar para modificar a aparência do painel de tarefas e responder a eventos do usuário.

Para obter um procedimento passo a passo, consulte Como: Adicionar um painel de tarefas Personalizar a um aplicativo.

Criar a interface do usuário

Tudo painéis de tarefas Personalizar que são criados usando Ferramentas do Visual Studio para o Office contêm um objeto UserControl.Esse Controlarar de usuário fornece a interface de usuário do painel de tarefas Personalizar.Você pode criar o Controlarar de usuário em tempo de design ou em tempo de execução.Se você criar o Controlarar de usuário em tempo de design, você pode usar o Windows Forms Designer para construir a interface do usuário do seu painel de tarefas.

Instanciar o painel de tarefas Personalizar

Depois de criar um Controlarar de usuário que contém a interface do usuário do painel de tarefas Personalizar, você precisa instanciar um CustomTaskPane.Para fazer isso, passe o Controlarar de usuário para o CustomTaskPaneCollection na sua Adicionar - in, chamando um dos métodos Add.Esta coleção é exposta como o campo CustomTaskPanes da classe ThisAddIn.O exemplo de código a seguir destina-se a ser executado a partir da classe 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 CustomTaskPane.Você pode usar esse objeto para modificar a aparência do painel de tarefas e para responder a eventos do usuário.

Controlar o painel de tarefas no Windows Múltiplo

Painéis de tarefas Personalizars associados a uma janela de quadro do documento, que apresenta um Exibir de um documento ou item para o usuário.O painel de tarefas fica visível somente quando a janela associada está visível.

Para determinar qual janela exibe o painel de tarefas Personalizar, use o método apropriado Add sobrecarga quando você Criar o painel de tarefas:

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

O Outlook, Word e o InfoPath exigem instruções explícitas para quando criar ou exibir o painel de tarefas quando houver mais de uma janela é Abrir.Isso torna importante considerar onde instanciar o painel de tarefas Personalizar em seu código para garantir que o painel de tarefas é exibido com o apropriado documentos ou itens em que o aplicativo.For more information, see Gerenciamento de painéis de tarefas Personalizars em Múltiplo aplicativos Windows.

Acessando o aplicativo de painel de tarefas

Se você quiser automatizar o Aplicativo de Controlarar de usuário, você diretamente pode acessar o modelo de objeto usando Globals.ThisAddIn.Application em seu código.A classe estático Globals fornece Acessar ao objeto ThisAddIn.O campo Application deste objeto é o ponto de entrada no modelo do objeto do aplicativo.

Para obter mais informações sobre o campo Application do objeto ThisAddIn , consulte Programação Application-Nível Adicionar-ins.Para um explicação passo a passo que demonstra como automatizar um aplicativo de um painel de tarefas Personalizar, consulte Demonstra Passo a passo: Automatizar um aplicativo a partir de um painel de tarefas Personalizar.For more information about the Globals class, see Global Acessar a objetos no Visual Studio Tools para 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 do objeto CustomTaskPane para controlar a interface do usuário do painel de tarefas e para responder quando o usuário altera o painel de tarefas.

Tornar o painel de tarefas Personalizar visível

Por padrão, o painel de tarefas não está visível.Para tornar o painel de tarefas Visível, você deve definir a propriedade Visible a true.

Os usuários podem feche um painel de tarefas a a a qualquer hora clicando no botão de fechar (X) no canto do painel de tarefas.No entanto, não é possível padrão para os usuários a abrir o painel de tarefas Personalizar novamente.Se um usuário fecha um painel de tarefas Personalizar, este usuário não é possível exibir o painel de tarefas Personalizar novamente, a menos que você fornecer uma maneira para exibi-la.

Se você criar um painel de tarefas Personalizar no seu suplemento, você também deve criar um elemento de interface do usuário, tal como um botão, o que os usuários podem Clique para exibir ou ocultar o painel de tarefas Personalizar.Se você criar um painel de tarefas personalizado em um aplicativo do Microsoft Office que ofereça suporte a personalização da Faixa de Opções, você pode adicionar um AAgruparar de Controlarar à Faixa de Opções com o botão que exibe ou oculta o painel de tarefas personalizado.Para um explicação passo a passo que demonstra como fazer isso, consulte Demonstra Passo a passo: Sincronizando um painel de tarefas Personalizar com um botão da Faixa de Opções.

Se você criar um painel de tarefas personalizado em um aplicativo do Microsoft Office que não oferece suporte a personalização da Faixa de Opções, você pode adicionar um CommandBarButton que exibe ou oculta o painel de tarefas personalizado.

Modificar a aparência do painel de tarefas

Você pode controlar o tamanho e a localização de um painel de tarefas Personalizar usando propriedades do objeto CustomTaskPane.Você pode fazer muitos Outro altera para a aparência de um painel de tarefas Personalizars usando propriedades do objeto UserControl que está contido no painel de tarefas Personalizar.Por exemplo, você pode especificar uma imagem de plano de fundo para um painel de tarefas Personalizar usando a propriedade BackgroundImage do Controlarar de usuário.

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

Tarefa	Propriedade
Para alterar o tamanho do painel de tarefas	Height Width
Para alterar o local do painel de tarefas	DockPosition
Para ocultar o painel de tarefas ou torná-lo visível	Visible
Para impedir que o usuário alterar o local do painel de tarefas	DockPositionRestrict

Programação de eventos de painel de tarefas Personalizar

Talvez seja conveniente o Adicionar-in para responder quando o usuário modifica o painel de tarefas Personalizar.Por exemplo, se o usuário alterar a orientação do painel de vertical para horizontal, convém reposicionar os controles.

A tabela a seguir lista os eventos que você pode manipular para responder a alterações feitas pelo usuário para o painel de tarefas Personalizar.

Tarefa	Evento
Para responder quando o usuário altera o local do painel de tarefas.	DockPositionChanged
Para responder quando o usuário oculta o painel de tarefas ou torna visível.	VisibleChanged

Recursos usados pelo painel de tarefas de limpeza

Depois de criar um painel de tarefas Personalizar, o objeto CustomTaskPane permanece na memória enquanto o Adicionar-in estiver Executando.O objeto permanece na memória mesmo após o usuário clicar no botão de fechar (X) no canto do painel de tarefas.

Para Apagar recursos utilizados pelo painel de tarefas enquanto o Adicionar-in está ainda Executando, use o Remove ou RemoveAt métodos.Esses métodos remover o objeto especificado CustomTaskPane de a coleção CustomTaskPanes e chame o método de Dispose do objeto.

O Tempo de execução Ferramentas do Visual Studio para o Office limpa automaticamente recursos utilizados pelo painel de tarefas Personalizar quando o Adicionar - in é descarregado.Não chame os métodos de Remove ou RemoveAt no manipulador de eventos ThisAddIn_Shutdown no projeto.Esses métodos lançará um ObjectDisposedException, porque o tempo de execução Ferramentas do Visual Studio para o Office limpa os recursos usados pelo objeto CustomTaskPane antes de ser chamado ThisAddIn_Shutdown.Para obter mais informações sobre o ThisAddIn_Shutdown, consulte O Visual Studio Tools for Office Projeto eventos.