Visão geral painel Ações

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 as versões do Microsoft Office. Tipo de Projeto Projetos de nível de documento Versão do Microsoft Office Microsoft Office Sistema de 2007 Microsoft Office 2003 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 as versões do Microsoft Office.

Tipo de Projeto

Projetos de nível de documento

Versão do Microsoft Office

Microsoft Office Sistema de 2007
Microsoft Office 2003

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

Um painel de ações é um painel de tarefas de ações do documento personalizável que é anexado a um documento específico do Microsoft Office Word ou a pasta de trabalho do Microsoft Office Excel.Ele está hospedado no painel de tarefas Office junto com outros painéis de tarefas interno, como o painel de tarefas Código-Origem XML no Excel ou os estilos de E o painel de tarefas formatação no Word.Você pode usar controles Windows Forms ou controles do WPF para Design interface do usuário do painel Ações.

Você pode criar um painel de ações somente em uma personalização de nível de documento para Word ou Excel.Não é possível criar um painel de ações em um nível de aplicativo Adicionar - in.For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Observação:
O painel de ações difere de painéis de tarefas Personalizars .Painéis de tarefas Personalizars estão associados ao aplicativo, não um documento específico.Você pode adicionar os painéis de tarefas Personalizars aos suplementos de nível de aplicativo para o Microsoft Office Sistema de 2007.Para obter mais informações, consulte Visão geral de painéis de tarefas Personalizar.

Exibir o painel de ações

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

Me.ActionsPane.Controls.Add(actions)

this.ActionsPane.Controls.Add(actions);

O painel de ações ficará visível em tempo de execução assim que você adicionar um Controlarar explicitamente a ele.Depois que o painel de ações for exibido, você pode dinamicamente adicionar ou remover controles em resposta às ações do usuário.Normalmente, você Adicionar o código para exibir o painel de ações no manipulador de eventos StartupThisDocument ou ThisWorkbook para que o painel de ações fique visível quando o usuário abre o documento pela Primeiro vez.No entanto, convém exibir o painel de ações apenas em resposta a ação de um usuário no documento.Por exemplo, você pode Adicionar o código para o evento Click de um Controlarar no documento.

Adicionando Múltiplo controles ao painel de ações

Se você estiver adicionando Múltiplo controles ao painel de 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 a propriedade Controls.Esse processo inclui as seguintes etapas:

Criar a interface de usuário (UI) do painel de ações, adicionando um de Controlarar do painel de ações ou Item de User Controlar ao seu projeto.Dois desses itens Incluir uma clAmbosse de UserControl Personalizar do Windows Forms.O de Controlarar do painel de ações e Controlarar de usuário itens são equivalentes; a única diferença é seu nome.

Controles de formulários Windows Adicionar para 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 controles do WPF em soluções Office.

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

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

Ocultar o painel de ações

Embora a classe ActionsPane tenha um método de Hide e uma propriedade de Visible , você não pode remover o painel de ações da interface do usuário usando os membros da classe ActionsPane propriamente dito.Chamar o método Hide ou Configuração a propriedade Visible a false oculta somente os controles no painel de ações; ele não Ocultar 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 propriedade Visible do objeto TaskPane que representa o painel de tarefas Ações do documento para false.O exemplo de código a seguir destina-se a ser executado a partir de classe ThisDocument no seu projeto.
```
Me.Application.TaskPanes(Word.WdTaskPanes.wdTaskPaneDocumentActions).Visible = False
```
```
this.Application.TaskPanes[Word.WdTaskPanes.wdTaskPaneDocumentActions].Visible = false;
```
Para que o Excel, defina a propriedade de DisplayDocumentActionTaskPane do objeto Application a false.O exemplo de código a seguir destina-se a ser executado a partir de classe ThisWorkbook no seu projeto.
```
Me.Application.DisplayDocumentActionTaskPane = False
```
```
this.Application.DisplayDocumentActionTaskPane = false;
```
Para Word ou Excel, como alternativa você pode definir a propriedade de CommandBar.Visible da barra de comando que representa o painel de tarefas para false.O exemplo de código a seguir destina-se a ser executar a partir da ThisDocument ou classe de ThisWorkbook no seu projeto.
```
Me.Application.CommandBars("Task Pane").Visible = False
```
```
this.Application.CommandBars["Task Pane"].Visible = false;
```

Limpar o 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 estará visível sempre que o documento for aberto, se o painel de ações contém os controles ou não.Se você deseja controlar quando ele for exibido, chame o método de Clear do campo ActionsPane no manipulador de eventos Startup de ThisDocument ou ThisWorkbook para garantir que o painel de ações não seja visível quando o documento é aberto.

Determinar quando o painel de ações é Fechada

Não há nenhum evento que é disparado quando o painel de ações é Fechada.Embora a classe ActionsPane tenha um evento de VisibleChanged, esse evento não é disparado quando o usuário final fecha o painel de ações.Em vez disso, este evento é aumentado quando os controles no painel de ações são ocultos por chamar o método Hide ou Configuração a propriedade Visible a false.

Se o usuário final fecha o painel de ações, o usuário poderá Exibir-lo novamente executando 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 2007 ou Excel 2007

Na faixa de opções, clique na guia de De Exibir.
No AAgruparar de De Mostrar/Ocultar, clique no botão de Alternar de ações do documento.

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

No menu Exibir, clique em do painel de tarefas.
Se um painel de tarefas seja o Ações do documento painel de tarefas é exibido, clique o botão de De outros painéis de tarefas próximo a parte superior do painel de tarefas e clique em Ações do documento.

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

Você pode adicionar Múltiplo controles de usuário para o painel de ações e, em seguida, Gravar código para responder a eventos no documento mostrando e ocultando os controles de usuário.Se você mapear elementos do esquema XML para o seu documento, você pode mostrar certos controles de usuário no painel de ações sempre que o ponto de inserção estiver dentro de um dos elementos XML.Para obter mais informações, consulte Demonstra Passo a passo: Alterar o painel de ações de acordo com para o contexto de usuário, Como: Mapear esquemas para documentos do Word dentro do Visual Studio e Como: Mapear esquemas para planilhas dentro do Visual Studio.

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

Vinculando dados a controles no painel de ações

Os controles no painel de ações têm mesmos recursos de ligação de dados como controles no Windows Forms.Você pode Ligar controles a fontes de dados, como conjuntos de dados, conjuntos de dados tipados e XML.For more information, see Ligação de dados e o Windows Forms.

Você pode Ligar 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: Vincular dados a controles em um painel de ações do Excel.

Validando dados em controles do painel de ações

Se você exibir uma caixa de mensagem no manipulador de eventos Validating de um Controlarar no painel de ações, o evento pode ser gerado um segundo tempo quando foco se move do Controlarar para a caixa de mensagem.Para evitar que esse problema, use um Controlarar ErrorProvider para exibir quaisquer mensagens de erro de validação.

Ordem de empilhamento de Controlarar de usuário

Se você estiver usando Múltiplo controles de usuário, você pode Gravar código para os controles de usuário no painel de ações da pilha corretamente se ela estiver encaixada verticalmente ou horizontalmente.Você pode definir a ordem de empilhamento dos controles de usuário no painel de ações usando a enumeração de StackStyle da propriedade StackOrder.Para mais informações, consulte: Como: Gerenciar o layout do Controlarar em painéis de ações.

A propriedade StackOrder pode aceitar as seguintes enumerações.

Estilo de empilhamento	Definição
FromBottom	Pilha da parte inferior do painel de ações.
FromLeft	Pilha a partir da esquerda do painel de ações.
FromRight	Pilha do Direito do painel de ações.
FromTop	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 a propriedade StackOrder para os controles de usuário da parte superior do painel de ações da pilha.

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

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

A ancoragem de controles

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 a propriedade Anchor de um controle Windows Forms para controles de âncora 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: Âncora Controls on Windows Forms.

Redimensionando o painel de ações

Você não pode alterar o tamanho de um ActionsPane diretamente porque o ActionsPane está incorporado em painel de tarefas.No entanto, você pode alterar programaticamente a largura do painel de tarefas por Configuração a propriedade Width a CommandBar que representa o painel de tarefas.Você pode alterar a altura do painel de tarefas se ele está encaixado na horizontal ou está flutuante.

Redimensionamento por meio de programação o painel de tarefas geralmente não é recomendável porque o usuário deve ser capazes de selecionar o tamanho do painel de tarefas que melhor atenda às necessidades de suas própria.No entanto, se você precisa redimensionar a largura do painel de tarefas, você pode usar o código a seguir para obter esta tarefa.

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

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

Reposicionar o painel de ações

Diretamente você não pode reposicionar o ActionsPane porque ele está incorporado em painel de tarefas.Entretanto, você pode mover o painel de tarefas por programaticamente Configuração a propriedade Position a CommandBar que representa o painel de tarefas.

Reposicionar através de programação o painel de tarefas geralmente não é recomendado pois o usuário deve ser capaz de escolher a posição do painel de tarefas na tela que melhor atenda às necessidades de suas própria.No 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 esta 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 manualmente o painel de tarefas a a a qualquer hora.Não é possível para garantir que o painel de tarefas será permaneçam encaixado na posição você indicar programaticamente.No entanto, y ou pode Marcar alterações de orientação e garantir que os controles no painel de ações são empilhados na direção correta.Para obter mais informações, consulte Como: Gerenciar o layout do Controlarar em painéis de ações.

Os usuários finais pode reposicionar manualmente o painel de tarefas a a a qualquer hora.Não é possível para garantir que o painel de tarefas será permaneçam encaixado na posição você indicar programaticamente.No entanto, y ou pode Marcar alterações de orientação e garantir que os controles no painel de ações são empilhados na direção correta.Para obter mais informações, consulte Como: Gerenciar o layout do Controlarar em painéis de ações.

Definindo a Top e Left propriedades do ActionsPane não Alterar posição porque o objeto ActionsPane é incorporado no painel de tarefas.

Se o painel de tarefas não está encaixado, você pode definir os Top e as propriedades Left a CommandBar que representa o painel de tarefas.O código a seguir move um painel de tarefas desencaixado para a superior Esquerda canto 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.msoBarLeft)
{
    this.CommandBars["Task Pane"].Top = 0;
    this.CommandBars["Task Pane"].Left = 0;
}