Gerenciar layout de controle em painéis de ações

Um painel de ações é encaixado à direita de um documento ou planilha por padrão; no entanto, ele pode ser encaixado à esquerda, superior ou inferior. Se você estiver usando vários controles de usuário, poderá escrever código para empilhar corretamente os controles de usuário no painel de ações. Para obter mais informações, consulte Visão geral do painel Ações.

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento para Excel e Word. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

A ordem de pilha dos controles depende se o painel de ações está encaixado vertical ou horizontalmente.

Observação

Se o usuário redimensionar o painel de ações em tempo de execução, você poderá definir os controles para redimensionar com o painel de ações. Você pode usar a Anchor propriedade de um controle do Windows Forms para ancorar controles no painel de ações. Para obter mais informações, consulte Como: Anchor controles no Windows Forms.

Observação

Seu computador pode mostrar diferentes nomes ou locais para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, confira Personalizar o IDE do Visual Studio.

Para definir a ordem de pilha dos controles do painel de ações

  1. Abra um projeto em nível de documento para o Microsoft Office Word que inclua um painel de ações com vários controles de usuário ou controles de painel de ações aninhados. Para obter mais informações, consulte Como: Adicionar um painel de ações a documentos do Word ou pastas de trabalho do Excel.

  2. Clique com o botão direito do mouse em ThisDocument.cs ou ThisDocument.vb no Gerenciador de Soluções e clique em Exibir Código.

  3. OrientationChanged No manipulador de eventos do painel de ações, verifique se a orientação do painel de ações é horizontal.

    private void ActionsPane_OrientationChanged(object sender, EventArgs e)
    {
        if (ActionsPane.Orientation == Orientation.Horizontal)
        {
    
  4. Se a orientação for horizontal, empilhe os controles do painel de ação a partir da esquerda; caso contrário, empilha-os a partir do topo.

            this.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromLeft;
        }
        else
        {
            this.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromTop;
        }
    }
    
  5. No C#, você deve adicionar um manipulador de eventos para o ActionsPane manipulador de Startup eventos. Para obter informações sobre como criar manipuladores de eventos, consulte Como: Criar manipuladores de eventos em projetos do Office.

    private void ThisDocument_Startup(object sender, System.EventArgs e)
    {
        this.ActionsPane.OrientationChanged += new EventHandler(ActionsPane_OrientationChanged);
    }
    
  6. Execute o projeto e verifique se os controles do painel de ações estão empilhados da esquerda para a direita quando o painel de ações está encaixado na parte superior do documento e os controles são empilhados de cima para baixo quando o painel de ações está encaixado no lado direito do documento.

Exemplo

private void ThisDocument_Startup(object sender, System.EventArgs e)
{
    this.ActionsPane.OrientationChanged += new EventHandler(ActionsPane_OrientationChanged);
}

private void ActionsPane_OrientationChanged(object sender, EventArgs e)
{
    if (ActionsPane.Orientation == Orientation.Horizontal)
    {
        this.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromLeft;
    }
    else
    {
        this.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromTop;
    }
}

Compilar o código

Este exemplo requer:

  • Um projeto de nível de documento do Word com um painel de ações que contém vários controles de usuário ou controles de painel de ações aninhados.