Compartilhar via


Designer de Faixa de Opções

O Designer de Faixa de Opções é uma interface de design visual. Use o Designer da Faixa de Opções para adicionar guias, grupos e controles personalizados à faixa de opções de um aplicativo do Microsoft Office.

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de suplemento VSTO para os seguintes aplicativos: Excel; InfoPath 2013 e InfoPath 2010; Outlook; PowerPoint; Project; Visio; Word. Para obter mais informações, consulte Os recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.

Para abrir o Designer da Faixa de Opções, adicione um item Faixa de Opções (Designer Visual) ao seu projeto. Em seguida, você pode usar as ferramentas de design para as seguintes tarefas:

Observação

Há algumas tarefas que você não pode realizar usando o Designer da Faixa de Opções. Para obter mais informações sobre essas tarefas e como você pode realizá-las, consulte Visão Geral da Faixa de Opções.

Adicionar um item de Faixa de Opções (Visual Designer) a um projeto

Para usar o Designer da Faixa de Opções, adicione um novo item de Faixa de Opções (Designer Visual) ao seu projeto. Para obter mais informações, consulte Como: Introdução à personalização da faixa de opções.

Quando você adiciona um novo item da Faixa de Opções (Visual Designer), o Visual Studio adiciona automaticamente os seguintes arquivos ao seu projeto:

  • Um arquivo de código Ribbon. Esse arquivo tem o nome que você especificar para o item Faixa de Opções (Designer Visual) na caixa de diálogo Adicionar Novo Item. Adicione código para manipular eventos da Faixa de Opções a esse arquivo.

  • Um arquivo de código do Designer da Faixa de Opções. Esse arquivo contém o código gerado pelo Designer da Faixa de Opções e não deve ser editado diretamente.

  • Um arquivo de recurso. Esse arquivo contém os valores das propriedades de cada controle na faixa de opções.

    Se você já tiver um item Ribbon (Designer Visual) de um outro projeto, poderá reutilizá-lo em seu projeto atual, usando a caixa de diálogo Add Existing Item.

Criar uma fita

Há três maneiras de abrir o Designer da Faixa de Opções:

  • No Gerenciador de Soluções, clique duas vezes no arquivo de código do Ribbon.

  • No Gerenciador de Soluções, clique com o botão direito do mouse no arquivo de código da Faixa de Opções e clique em Exibir Designer.

  • No Gerenciador de Soluções, selecione o arquivo de código da Faixa de Opções e clique em Designer no menu Exibir .

    O Designer da Faixa de Opções contém uma guia e um grupo padrão. Você pode remover a guia e o grupo padrão do Designer da Faixa de Opções. Para remover o grupo padrão, clique com o botão direito do mouse em Group1 e clique em Excluir. Para remover a guia padrão, clique com o botão direito do mouse em uma área vazia da superfície de design e clique em Remover Guia da Faixa de Opções.

    Você também pode adicionar guias, grupos e controles personalizados ao Designer da Faixa de Opções. Você pode encontrar esses controles na Caixa de Ferramentas, no grupo Controles da Faixa de Opções do Office . Há três maneiras de adicionar controles do grupo Controles da Faixa de Opções do Office ao Designer da Faixa de Opções:

  • Arraste um controle para uma área apropriada no Designer da Faixa de Opções.

  • Clique em um controle e clique em uma área apropriada no Designer da Faixa de Opções.

  • Selecione uma área apropriada no designer e clique duas vezes em um controle na Caixa de Ferramentas.

Fluxo de trabalho de design da faixa de opções

Siga estas etapas básicas para projetar o layout da Faixa de Opções:

  1. Adicione uma guia personalizada à faixa de opções.

  2. Adicione grupos à guia.

  3. Adicione controles aos grupos.

    Os controles só podem ser colocados em grupos; você não pode arrastar um controle diretamente para uma guia ou para a barra de ferramentas. Os grupos podem ser descartados somente em guias; você não pode arrastar um grupo diretamente para uma Ribbon.

    Organize os controles arrastando-os para as posições corretas. Você pode definir as propriedades de um controle usando a janela Propriedades .

    Não é possível arrastar controles de uma guia para a outra na barra de ferramentas. Se você quiser mover um controle para outra guia, deverá usar o comando Recortar para remover o controle de uma guia e colar o controle em outra guia. Se você cortar o controle e colá-lo, o manipulador de eventos deixará de funcionar. Você pode reconectar o manipulador de eventos na janela Propriedades . Para obter mais informações, consulte a janela Propriedades.

Adicionar guias personalizadas à faixa de opções

Há três maneiras de adicionar uma guia personalizada à faixa de opções:

  • Adicione uma guia da Caixa de Ferramentas.

  • Clique com o botão direito do mouse no Designer da Faixa de Opções e clique em Adicionar Guia da Faixa de Opções.

  • Abra o Editor de Coleção de Guias e clique em Adicionar.

    Para abrir o Editor de Coleção de Guias, na janela Propriedades, selecione a propriedade Guias e clique no botão de elipses botão de elipses do Designer Móvel do ASP.NET.

    Depois de adicionar uma guia, você pode adicionar grupos que contenham controles.

Remover guias personalizadas da faixa de opções

Há três maneiras de remover uma guia personalizada da faixa de opções:

  • Clique com o botão direito do mouse no designer e clique em Remover Guia da Faixa de Opções.

  • No painel Comandos da janela Propriedades, clique em Remover Guia da Faixa de Opções.

  • Abra o Editor de Coleção de Guias, selecione a guia e clique em Remover.

Alterar a posição de uma guia na faixa de opções

Você pode alterar a ordem das guias personalizadas em uma faixa de opções. Você também pode posicionar guias personalizadas antes ou depois de uma guia incorporada na faixa de opções. Para obter mais informações, consulte Como alterar a posição de uma guia na faixa de opções.

Personalizar guias internas na faixa de opções

Uma guia interna é uma guia que já está na faixa de opções de um aplicativo do Microsoft Office. Por exemplo, a guia Dados é uma guia interna no Excel.

Você pode adicionar grupos e controles a uma guia interna. Por padrão, um grupo personalizado aparece como o último grupo em uma guia interna, embora você possa movê-lo antes ou depois de qualquer grupo interno na guia.

Você não pode remover grupos internos.

Para obter detalhes sobre como personalizar uma guia interna, consulte Como personalizar uma guia interna.

Adicionar grupos a uma guia

Os grupos organizam controles logicamente na Barra de Ferramentas Ribbon. Adicione grupos a guias. Adicione todos os outros controles ao grupo.

Adicionar controles a grupos

Adicione um ou mais controles a um grupo. A tabela a seguir descreve cada controle.

Controle Description
Caixa Um contêiner que organiza controles em um grupo. Você pode adicionar qualquer controle a uma caixa, exceto um separador, um grupo ou uma guia. Uma caixa pode ser horizontal ou vertical.
Botão Um botão que inicia uma ação. Você pode adicionar um botão a um grupo, um grupo de botões, uma lista suspensa, uma galeria, um menu ou um botão dividido.
ButtonGroup Um grupo que contém um ou mais botões, botões de alternância, menus, botões divididos e galerias. Você pode adicionar um grupo de botões a um grupo ou a um menu.
Caixa de Seleção Uma caixa selecionada ou desmarcada para ativar ou desativar uma opção.
ComboBox Uma caixa de edição com uma caixa de listagem anexada. Os usuários podem digitar ou selecionar sua escolha. A caixa exibe a seleção atual. Use a propriedade Items para adicionar e remover itens em tempo de execução antes ou depois que o Ribbon for carregado no aplicativo do Office.
DropDown Uma lista de itens que o usuário pode selecionar. O usuário não pode digitar um novo item em uma lista suspensa.

Use a propriedade Items para adicionar itens à lista. Você pode adicionar e remover itens em tempo de execução.

Use a propriedade Buttons para adicionar botões à lista. No entanto, você não pode adicionar e remover botões em tempo de execução depois que a faixa de opções é carregada no aplicativo do Office.
EditBox Uma caixa na qual o usuário pode digitar texto.
Galeria Um menu que apresenta uma matriz ou grade de opções visuais das quais os usuários podem selecionar. Você pode controlar o layout das seleções no menu. Use o ColumnCount e as RowCount propriedades para especificar o número de linhas e colunas que exibirão os itens e botões da galeria.
Rótulo Texto que você pode usar para identificar controles na faixa de opções.
Menu Uma lista suspensa que pode conter qualquer um dos seguintes controles:

-Botão
- Caixa de seleção
-Galeria
-Menu
- Botão Dividido
- Botão de alternância
- Separador

Para adicionar um controle a um menu no Designer da Faixa de Opções, clique na seta para baixo no menu para expor a superfície de design do menu. Em seguida, você pode arrastar os controles da Faixa de Opções do Toolbox para o menu. Para organizar controles, arraste-os para as posições desejadas.

Para adicionar controles à RibbonMenu faixa de opções após o carregamento da faixa de opções no aplicativo do Office, você deve definir a Dynamic propriedade como true antes que a faixa de opções seja carregada. Para obter informações sobre como fazer isso, consulte a visão geral do modelo de objeto da Faixa de Opções.
Separador Uma barra fina usada para separar itens em uma lista. Quando adicionada a um grupo, a barra é vertical. Quando adicionado a um menu, a barra é horizontal.
Botão Dividido Um botão com um menu anexado. Um botão de divisão pode conter qualquer um dos seguintes controles:

-Botão
- Caixa de seleção
-Galeria
-Menu
- Botão Dividido
- Botão de alternância
- Separador

Assim como o menu, o botão de divisão tem sua própria superfície de design. No entanto, ao contrário de um menu, você só pode atualizar os itens em um botão de divisão antes que a faixa de opções seja carregada no aplicativo do Office. Para obter informações sobre como atualizar os itens em um botão dividido, consulte a visão geral do modelo de objeto da Faixa de Opções.
Botão de alternância Um botão que aparece pressionado ou não pressionado.

Manipular eventos e definir propriedades

O Designer da Faixa de Opções permite que você defina as propriedades de controle no momento do design usando a janela Propriedades. Além disso, a faixa de opções expõe um modelo de objeto fortemente tipado que você pode usar para obter e definir as propriedades dos controles da Faixa de Opções em tempo de execução.

Você pode clicar duas vezes em qualquer controle no designer para abrir um manipulador de eventos para o evento padrão do controle. Você pode criar manipuladores de eventos para todos os outros eventos de controle usando a janela Propriedades .

Os eventos e as propriedades da faixa de opções estão localizados no namespace Microsoft.Office.Tools.Ribbon. O item Faixa de Opções (Designer Visual) adiciona automaticamente uma referência a esse assembly no projeto e insere a instrução apropriada usando ou Imports na parte superior do arquivo de código da Faixa de Opções.

Para obter informações sobre como lidar com eventos da Faixa de Opções e definir as propriedades dos controles da Faixa de Opções em tempo de execução, consulte a visão geral do modelo de objeto da Faixa de Opções.

Personalizar o modo de exibição Backstage

Você pode usar o Designer da Faixa de Opções para adicionar controles ao menu aberto quando clicar na guia Arquivo . Esse menu é chamado de modo de exibição Backstage.

Você não pode posicionar controles antes ou depois de controles internos usando o designer da Faixa de Opções. Um controle embutido é um controle que já aparece na exibição Backstage. Se você quiser posicionar os controles antes ou depois dos controles internos, deverá usar o XML da Faixa de Opções. Para obter mais informações sobre a Faixa de Opções (XML), consulte O XML da Faixa de Opções. Para obter mais informações sobre como personalizar o modo de exibição Backstage, consulte Introdução ao modo de exibição Backstage do Office 2010 para desenvolvedores e personalize o modo de exibição Backstage do Office 2010 para desenvolvedores.

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de suplemento VSTO para os seguintes aplicativos: Excel; InfoPath 2013 e InfoPath 2010; Outlook; PowerPoint; Project; Visio; Word. Para obter mais informações, consulte Os recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.

Para obter informações sobre como adicionar controles ao modo de exibição Backstage, consulte Como adicionar controles ao modo de exibição Backstage.

Acessibilidade no Designer da Faixa de Opções

Você pode usar atalhos de teclado para mover controles no Designer da Faixa de Opções. Alguns atalhos de teclado se aplicam a todos os controles e outros se aplicam apenas a controles que têm menus.

Os atalhos de teclado que se aplicam a todos os controles são mostrados na tabela a seguir.

Ação Atalho de teclado
Mova um controle antes do controle anterior na lista. Ctrl+Seta Para Cima

Ctrl+Esquerda
Mova um controle para depois do próximo controle na lista. Ctrl+Baixo

Ctrl+Direita
Mova a seleção de um controle para outro no mesmo grupo. Para um painel suspenso, navegue entre o controle principal e os controles no painel suspenso. Acima

para baixo
Percorrer todos os controles. Tab
Iterar para o inverso por meio de todos os controles. Turno+Guia
Exclua o controle selecionado ou o conjunto de controles. excluir
Copie os controles selecionados. Ctrl+C
Corte os controles selecionados. Ctrl+X
Cole os controles da Área de Transferência. Ctrl+V
Selecione a Caixa de Ferramentas. Ctrl+Alt+X
Selecione o componente pai. Esc

Os atalhos de teclado que se aplicam somente ao Menu RibbonMenudo Microsoft Office e RibbonSplitButton são mostrados na tabela a seguir.

Ação Atalho de teclado
Selecione o controle pai se o painel suspenso estiver aberto e houver um controle selecionado no painel suspenso. Left
Feche o painel suspenso se o painel suspenso estiver aberto e o controle pai estiver selecionado. Left
Abra o painel suspenso. Right
Selecione o primeiro controle no painel suspenso se o painel suspenso estiver aberto. Right
Feche um painel suspenso. Esc