Visão geral do painel de ações

Artigo
02/25/2013

Um painel de ações é um painel de tarefas de Ações do Documento personalizável que é anexado a um documento Microsoft Office Word ou a uma pasta de trabalho específica do Microsoft Office Excel.É hospedado dentro do painel de tarefas do Office junto com outros painéis de tarefas internos como o painel de tarefas do excel Código-fonte XML ou o painel de tarefas de Estilos e Formatação em palavras.Você pode usar controles de formulários do windows ou controles WPF para criar a interface do usuário do painel ações.

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

Você pode criar um painel de ações somente em um nível para personalização da palavra ou Excel.Você não pode criar um painel de ações em um suplemento ao aplicativo.Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Observação
O painel de ações difere dos painéis de tarefa personalizada.Os painéis de tarefa personalizada são associados com o aplicativo, não um documento específico.Você pode criar os painéis de suplementos tarefa personalizada no nível de aplicativo para alguns aplicativos do Microsoft Office.Para obter mais informações, consulte Painéis de tarefas personalizados.

link para vídeo Para uma demonstração de vídeo relacionada, consulte Como: eu faço Use controles WPF em um painel de ações do excel?.

Exibindo o painel de ações

O painel de ações é representado pela classe de ActionsPane .Quando você cria um projeto da nível de aplicativo, uma instância da classe está disponível em seu código usando o campo de ActionsPane de ThisWorkbook para o excel () ou a classe de ThisDocument para palavra () no seu projeto.Para exibir o painel de ações, adicione um controle de formulários do windows à propriedade de Controls do campo de ActionsPane .O exemplo de código a seguir adiciona um controle chamado actions o painel de ações.

Me.ActionsPane.Controls.Add(actions)

this.ActionsPane.Controls.Add(actions);

O painel de ações fica visível em tempo de execução para que você irá adicionar um controle explicitamente.Após o painel de ações é exibido, você pode dinamicamente adicionar ou remover controles em resposta às ações do usuário.Normalmente, você adicionará código para exibir o painel de ações no manipulador de eventos de Startup de ThisDocument ou de ThisWorkbook de modo que o painel de ações está visível quando o usuário abre primeiro o documento.Em o entanto, convém exibir o painel de ações somente em resposta a uma ação do usuário no documento.Por exemplo, você pode adicionar código ao evento de Click de um controle no documento.

Adicionar vários controles ao painel de ações

Se você estiver adicionando vários controles para o painel ações, na maioria dos casos você deve agrupar controles em um controle de usuário, e então adiciona o controle de usuário à propriedade de Controls .Esse processo inclui as seguintes etapas:

Crie a interface de usuário (UI) do painel ações adicionando um item de Controle do Painel Ações ou de Controle do Usuário ao seu projeto.Ambos esses itens incluem uma classe de UserControl de formulários do windows personalizado.os itens de Controle do Painel Ações e de Controle do Usuário são equivalentes; a única diferença é seu nome.

Adicionar controles de formulários do windows a UserControl usando o designer, ou escrevendo código.

Observação
Você também pode adicionar controles WPF para o painel de ações adicionando um System.Windows.Controls.UserControl UserControlWPF em formulários do windows.Para obter mais informações, consulte Usando os controles WPF em soluções do Office.

Adicione uma instância do controle de usuário personalizados para os controles que estão contidos no campo de ActionsPane de ThisWorkbook (ou) para o excel na classe de ThisDocument para palavra () no seu projeto.

Para exemplos que demonstram esse processo com mais detalhes, consulte Como: adiciona um painel de ações para documentos do Word ou planilhas do Excel.

Ocultando o painel de ações

Embora a classe de ActionsPane tem um método de Hide e uma propriedade de Visible , você não pode remover o painel de ações interface do usuário usando os membros da classe de ActionsPane próprios.Chame o método de Hide ou definir a propriedade de Visible a false ocultam somente os controles no painel ações; não oculta o painel de tarefas.

Para ocultar o painel de tarefas em sua solução, você tem várias opções:

Para palavras, defina a propriedade de Visible do objeto de TaskPane que representa o painel de tarefas de ações do documento a false.O exemplo de código se destina a ser executado da classe de ThisDocument em seu projeto.
```
Me.Application.TaskPanes(Word.WdTaskPanes.wdTaskPaneDocumentActions).Visible = False
```
```
this.Application.TaskPanes[Word.WdTaskPanes.wdTaskPaneDocumentActions].Visible = false;
```
Para o excel, defina a propriedade de DisplayDocumentActionTaskPane do objeto de Application a false.O exemplo de código se destina a ser executado da classe de ThisWorkbook em seu projeto.
```
Me.Application.DisplayDocumentActionTaskPane = False
```
```
this.Application.DisplayDocumentActionTaskPane = false;
```
Para palavra ou o excel, você também pode definir a propriedade de CommandBar.Visible da barra de comandos que representa o painel de tarefas a false.O exemplo de código se destina a ser executado da classe de ThisDocument ou de ThisWorkbook em seu projeto.
```
Me.Application.CommandBars("Task Pane").Visible = False
```
```
this.Application.CommandBars["Task Pane"].Visible = false;
```

Limpar o painel de ações quando o documento está aberto

Se o usuário salva o documento enquanto o painel de ações é visível, o painel de ações é visível cada vez que o documento está aberto, mesmo se o painel de ações contém todos os controles.Se você deseja controlar quando for exibida, chame o método de Clear do campo de ActionsPane no manipulador de eventos de Startup de ThisDocument ou de ThisWorkbook para garantir que o painel de ações não está visível quando o documento está aberto.

Determinar quando o painel de ações é fechado

Não há nenhum evento que é gerado quando o painel de ações é fechado.Embora a classe de ActionsPane têm um evento de VisibleChanged , esse evento não é gerado quando o usuário final fechar o painel de ações.Em vez de isso, este evento é gerado quando os controles no painel ações são ocultados chamando o método de Hide ou definindo a propriedade de Visible a false.

Se o usuário final fechar o painel ações, o usuário pode exibi-lo novamente executando um dos seguintes procedimentos na interface de usuário (UI) do aplicativo.

Para exibir o painel de ações usando interface de usuário do word ou do excel

Em fita, clique na guia de Modo de Visualização .
Em o grupo de Apresentação/ocultar , clique no botão de alternância de Ações do Documento .

Eventos do painel ações de programação

Você pode adicionar vários controles de usuário ao painel de ações e escrever código para responder a eventos no documento mostrando e ocultar os controles de usuário.Se você mapeia elementos de esquema XML no seu documento, você pode mostrar certos controles de usuário no painel ações sempre que o ponto de inserção é o dentro de um dos elementos XML.Para obter mais informações, consulte Como: Mapear esquemas para documentos do Word dentro de Visual Studio e Como: Mapear esquemas para planilhas dentro de Visual Studio.

Você também pode escrever código para responder a eventos de qualquer objeto, incluindo o controle do host, o aplicativo, ou eventos do documento.Para obter mais informações, consulte: Passo a passo: Programação contra eventos de um controle NamedRange.

Associando dados a controles no painel de ações

Os controles no painel de ações com os mesmos recursos de associação de dados que controles em formulários do windows.Você pode associar controles a fontes de dados como conjuntos de dados, conjuntos de dados digitados, e XML.Para obter mais informações, consulte Ligação de dados e o Windows Forms.

Você pode associar controles no painel ações e controles no documento ao mesmo conjunto de dados.Por exemplo, você pode criar um relacionamento mestre/detalhe entre os controles no painel de ações e os controles na planilha.Para obter mais informações, consulte Passo a passo: Ligação de dados a controles em um painel de ações do Excel.

Validando dados em controles de painel de ações

Se você exibe uma caixa de mensagem no manipulador de eventos de Validating de um controle no painel ações, o evento pode ser gerado uma segunda vezes em que o foco se move o controle para caixa de mensagem.Para evitar esse problema, use um controle de ErrorProvider para exibir as mensagens de erro de validação.

Controle de usuário que empilhados o pedido

Se você estiver usando vários controles de usuário, você pode escrever código para empilhar corretamente os controles de usuário no painel ações estiver conectado verticalmente ou horizontalmente.Você pode definir a ordem de empilhamento de controles de usuário no painel ações usando a enumeração de StackStyle da propriedade de StackOrder .Para obter mais informações, consulte Como: gerenciar o Layout do controle em painéis de ações

A propriedade de StackOrder pode ter os seguintes valores de enumeração de StackStyle .

Empilhamento o estilo	Definição
FromBottom	Empilhar inferior do painel ações.
FromLeft	Empilhar da esquerda do painel ações.
FromRight	Empilhar da direita do painel ações.
FromTop	Empilhar a parte superior do painel ações.
None	Nenhum pedido de empilhamento definido; a ordem é controlado pelo desenvolvedor.

O código a seguir define a propriedade de StackOrder para empilhar o controle de usuário a parte superior do painel ações.

Me.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromTop

this.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromTop;

ancorando controles

Se o usuário redimensiona o painel de ações em tempo de execução, os controles podem redimensionar com o painel de ações.Você pode usar a propriedade de Anchor de um controle de formulários do windows para ancorar controles para o painel de ações.Você também pode ancorar controles de formulários do windows no controle de usuário da mesma forma.Para obter mais informações, consulte Como: ancorar controles em Windows Forms.

Redimensionando o painel de ações

Você não pode modificar diretamente o tamanho de ActionsPane porque ActionsPane é inserido no painel de tarefas.Em o entanto, você pode alterar programaticamente a largura do painel de tarefas definindo a propriedade de Width de CommandBar que representa o painel de tarefas.Você pode alterar a altura do painel de tarefas se estiver conectado é horizontal ou flutuantes.

Programaticamente redimensionar o painel de tarefas geralmente não é recomendado porque o usuário deve poder selecione o tamanho do painel de tarefas que os melhores ternos suas necessidades.Em o entanto, se você deve redimensionar a largura do painel de tarefas, você pode usar o código a seguir para obter essa tarefa.

Me.CommandBars("Task Pane").Width = 200

this.CommandBars["Task Pane"].Width = 200;

Reposicionando o painel de ações

Você não pode diretamente reposicionar ActionsPane porque é inserido no painel de tarefas.Em o entanto, você pode mover programaticamente o painel de tarefas definindo a propriedade de Position de CommandBar que representa o painel de tarefas.

Programaticamente reposicionar o painel de tarefas geralmente não é recomendado porque o usuário deve poder escolha a posição do painel de tarefas na tela que os melhores ternos suas necessidades.Em o entanto, se você deve mover o painel de tarefas para uma posição específica, você pode usar o código a seguir para obter essa tarefa.

Me.CommandBars("Task Pane").Position = _
    Microsoft.Office.Core.MsoBarPosition.msoBarLeft

this.CommandBars["Task Pane"].Position =
    Microsoft.Office.Core.MsoBarPosition.msoBarLeft;

Observação
os usuários finais podem manualmente reposicionar o painel de tarefas a qualquer momento.Não há nenhuma maneira de garantir que o painel de tarefas permaneça inserido na posição que você indica programaticamente.Em o entanto, você pode verificar alterações de orientação e garantir que os controles no painel ações são empilhados na direção correta.Para obter mais informações, consulte Como: gerenciar o Layout do controle em painéis de ações.

os usuários finais podem manualmente reposicionar o painel de tarefas a qualquer momento.Não há nenhuma maneira de garantir que o painel de tarefas permaneça inserido na posição que você indica programaticamente.Em o entanto, você pode verificar alterações de orientação e garantir que os controles no painel ações são empilhados na direção correta.Para obter mais informações, consulte Como: gerenciar o Layout do controle em painéis de ações.

Definir as propriedades de Top e de Left de ActionsPane não altera a posição porque o objeto de ActionsPane é inserido no painel de tarefas.

Se o painel de tarefas não está conectado, você pode definir as propriedades de Top e de Left de CommandBar que representa o painel de tarefas.O código a seguir move um painel de tarefas desencaixado ao canto superior esquerdo do documento.

If Me.CommandBars("Task Pane").Position = _
    Microsoft.Office.Core.MsoBarPosition.msoBarFloating Then

    Me.CommandBars("Task Pane").Top = 0
    Me.CommandBars("Task Pane").Left = 0

End If

if (this.CommandBars["Task Pane"].Position == 
    Microsoft.Office.Core.MsoBarPosition.msoBarFloating)
{
    this.CommandBars["Task Pane"].Top = 0;
    this.CommandBars["Task Pane"].Left = 0;
}

Consulte também

Partilhar via