Visão geral painel Ações

Artigo
08/08/2011

Um painel de ações é um personalizável Ações do documento painel de tarefas é anexado a um determinado documento do Word de Microsoft Office ou a pasta de trabalho do Excel de Microsoft Office. É hospedado dentro do painel de tarefas do Office, juntamente com outros painéis de tarefas interno, como o Código-fonte XML o painel de tarefas no Excel ou o estilos e formatação o painel de tarefas no Word. Você pode usar os controles do Windows Forms ou WPF para projetar a interface de usuário do painel de 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 2007 e Excel 2010; Word 2007 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 uma personalização em nível de documento para Word ou Excel. É possível criar um painel de ações em um suplemento em nível de aplicativo. For more information, see Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Observação
O painel de ações difere em painéis de tarefas personalizado. Painéis de tarefas personalizados são associados com o aplicativo, não é um documento específico. Você pode criar painéis de tarefas personalizados no nível do aplicativo add-ins para alguns aplicativos de Microsoft Office. For more information, see Visão geral sobre painéis de tarefas personalizado.

link para vídeo Para uma demonstração de vídeo relacionada, consulte Fazer como i: Usar os controles do WPF dentro de um painel de ações do Excel?.

Exibindo o painel de ações

O painel de ações é representado pela ActionsPane classe. Quando você cria um projeto de nível de documento, uma instância dessa classe está disponível para o seu código usando o ActionsPane campo de ThisWorkbook (para o Excel) ou ThisDocument (para Word) de classe no projeto. Para exibir o painel de ações, adicione um controle Windows Forms para o Controls propriedade da ActionsPane campo. O exemplo de código a seguir adiciona um controle chamado actions para o painel de ações.

Me.ActionsPane.Controls.Add(actions)

this.ActionsPane.Controls.Add(actions);

O painel de ações se torna visível em tempo de execução assim que você adicionar um controle explicitamente a ele. Depois que o painel de ações é exibido, você pode dinamicamente adicionar ou remover controles em resposta a ações do usuário. Normalmente, você adiciona o código para exibir o painel de ações no Startup o manipulador de eventos de ThisDocument ou ThisWorkbook para que o painel de ações é visível quando o usuário abre o documento. No 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 o código para o Click o evento de um controle em um documento.

Adicionando vários controles ao painel Ações

Se você estiver adicionando vários controles ao painel Ações, na maioria dos casos você deve agrupar os controles em um controle de usuário e, em seguida, adicionar o controle de usuário para o Controls propriedade. Esse processo inclui as seguintes etapas:

Criar a interface do usuário (UI) do painel de ações, adicionando um Controle de painel de ações ou O controle de usuário item ao seu projeto. Ambos esses itens incluem formulários personalizados do Windows UserControl classe. O Controle de painel de ações e O controle de usuário itens são equivalentes; a única diferença é o seu nome.

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

Observação
Você também pode adicionar controles do WPF para o painel de ações, adicionando um WPF System.Windows.Controls.UserControl para o Windows Forms UserControl. For more information, see Usando os controles WPF em soluções do Office.

Adicionar uma instância do controle de usuário personalizados para os controles que estão contidos no ActionsPane campo de ThisWorkbook (para o Excel) ou ThisDocument (para Word) de classe no projeto.

Para obter exemplos que demonstram esse processo em mais detalhes, consulte Como: Adicionar um painel de ações para documentos do Word e Como: Adicionar um painel de ações para pastas de trabalho do Excel.

Ocultar o painel de ações

Embora o ActionsPane classe tem um Hide método e um Visible propriedade, você não pode remover o painel de ações da interface do usuário usando todos os membros da ActionsPane própria classe. Chamar o Hide método ou a configuração do Visible propriedade para false oculta apenas os controles no painel Ações ele não oculta o painel de tarefas.

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

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

Limpar ações painel quando o documento é aberto.

Se o usuário salva o documento enquanto o painel de ações está visível, o painel de ações é visível sempre que o documento for aberto, independentemente de serem ou não o painel de ações contém os controles. Se você deseja o controle quando ele for exibido, chame o Clear método da ActionsPane campo o Startup manipulador de eventos de ThisDocument ou ThisWorkbook para garantir que o painel de ações não estiver visível quando o documento é aberto.

Determinar quando o painel de ações está fechado.

Não há nenhum evento que é gerado quando o painel de ações é fechado. Embora o ActionsPane classe tem um VisibleChanged evento, este evento não é disparado quando o usuário final fecha o painel de ações. Em vez disso, este evento é gerado quando os controles no painel de ações estão ocultas, chamando o Hide método ou definindo a Visible propriedade para false.

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

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

Na faixa de opções, clique no Exibir guia.
No Mostrar/ocultar de grupo, clique no Ações do documento o botão de alternância.

Programação de eventos do painel de ações

Você pode adicionar vários controles de usuário para o painel de ações e, em seguida, escrever código para responder a eventos no documento mostrando e ocultando os controles de usuário. Se você mapear os elementos do esquema XML ao documento, você pode mostrar certos controles de usuário no painel Ações, sempre que o ponto de inserção está dentro de um dos elementos XML. For more information, see Demonstra Passo a passo: Alterando o painel de ações, de acordo com o contexto de usuário, Como: Mapear esquemas aos documentos do Word dentro de Visual Studio, and Como: Mapear esquemas para planilhas dentro de Visual Studio.

Você também pode escrever código para responder a eventos de qualquer objeto, incluindo controle de host, aplicativo ou eventos de documento. For more information see Demonstra Passo a passo: Programação de eventos de um controle NamedRange.

Ligação de dados a controles no painel de ações

Os controles no painel de ações têm os mesmos recursos de ligação de dados como controles em formulários do Windows. Você pode vincular controles a fontes de dados como, por exemplo, conjuntos de dados, conjuntos de dados tipados e XML. For more information, see Ligação de dados e o Windows Forms.

Você pode vincular controles no painel de ações e controles no documento ao mesmo dataset. Por exemplo, você pode criar uma relação mestre/detalhes entre os controles no painel de ações e os controles na planilha. For more information, see Demonstra Passo a passo: A vinculação de dados a controles em um painel de ações do Excel.

Validação de dados em controles do painel de ações

Se você exibir uma caixa de mensagem no Validating o manipulador de eventos de um controle no painel de ações, o evento pode ser elevado a uma segunda vez, quando o foco é movido do controle para a caixa de mensagem. Para evitar esse problema, use um ErrorProvider controle para exibir quaisquer mensagens de erro de validação.

Ordem de empilhamento de controle de usuário

Se você estiver usando vários controles de usuário, você pode escrever código para corretamente os controles de usuário no painel de ações de pilha se ela está ancorada verticalmente ou horizontalmente. Você pode definir a ordem de empilhamento dos controles de usuário no painel de ações usando o StackStyle a enumeração da StackOrder propriedade. For more information, see Como: Gerenciar o Layout de controle nos painéis de ações

O StackOrder propriedade pode assumir o seguinte StackStyle valores de enumeração.

Estilo de empilhamento.	Definition
FromBottom	A pilha na parte inferior do painel de ações.
FromLeft	A pilha do lado esquerdo do painel de ações.
FromRight	A pilha da direita do painel de ações.
FromTop	A pilha da parte superior do painel de ações.
None	Nenhuma ordem de empilhamento definido; ordem é controlado pelo desenvolvedor.

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

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

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

Controles de ancoragem

Se o usuário redimensionar o painel de ações em tempo de execução, os controles podem redimensionar com o painel de ações. Você pode usar o Anchor propriedade de um controle Windows Forms a controles de ancoragem para o painel de ações. Você também pode ancorar os controles Windows Forms para o controle de usuário da mesma maneira. For more information, see Como: Controles de ancoragem no Windows Forms.

Redimensionar o painel de ações

Diretamente, você não pode alterar o tamanho de um ActionsPane porque a ActionsPane está incorporado no painel de tarefas. No entanto, você pode alterar programaticamente a largura do painel de tarefas, definindo a Width propriedade da CommandBar que representa o painel de tarefas. Você pode alterar a altura do painel de tarefas se ela está ancorada na horizontal ou está flutuante.

Redimensionamento programaticamente o painel de tarefas geralmente não é recomendável porque o usuário deve ser capaz de selecionar o tamanho do painel de tarefas que melhor atende às suas necessidades. No entanto, se você deve redimensionar a largura do painel de tarefas, você usaria o seguinte código para atingir essa tarefa.

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

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

O painel de ações de reposicionamento

Não é possível reposicionar a ActionsPane porque ele está incorporado no painel de tarefas. No entanto, você pode programaticamente mover o painel de tarefas, definindo a Position propriedade da CommandBar que representa o painel de tarefas.

Reposicionamento programaticamente o painel de tarefas geralmente não é recomendável porque o usuário deve ser capaz de escolher a posição do painel de tarefas na tela que melhor atenda às suas necessidades. No entanto, se você deve mover o painel de tarefas para uma posição específica, você usaria o seguinte código para atingir 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 pode reposicionar o painel de tarefas manualmente a qualquer momento. Não há nenhuma maneira de garantir que o painel de tarefas permanecerá ancorado na posição em que você indicar programaticamente. No entanto, você pode verificar as alterações de orientação e garantir que os controles no painel de ações são empilhados na direção correta. For more information, see Como: Gerenciar o Layout de controle nos painéis de ações.

Os usuários finais pode reposicionar o painel de tarefas manualmente a qualquer momento. Não há nenhuma maneira de garantir que o painel de tarefas permanecerá ancorado na posição em que você indicar programaticamente. No entanto, você pode verificar as alterações de orientação e garantir que os controles no painel de ações são empilhados na direção correta. For more information, see Como: Gerenciar o Layout de controle nos painéis de ações.

Definindo a Top e Left Propriedades da ActionsPane não altera sua posição, pois o ActionsPane objeto está incorporado no painel de tarefas.

Se o painel de tarefas não está encaixado, você pode definir o Top e Left Propriedades de CommandBar que representa o painel de tarefas. O código a seguir move um painel de tarefas desencaixada 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

Compartilhar via