Partilhar via

Designer da faixa de opções (MFC)

  • Artigo

O Designer de fixa de opções permite criar e personalizar faixas de opções em aplicativos MFC. Uma faixa de opções é um elemento de interface do usuário que organiza comandos em grupos lógicos. Esses grupos aparecem em guias separadas em uma faixa na parte superior da janela. A faixa de opções substitui a barra de menus e as barras de ferramentas. Uma faixa de opções pode melhorar significativamente a usabilidade do aplicativo. Para obter mais informações, consulte Faixas de opções. A ilustração a seguir mostra uma faixa de opções.

MFC Ribbon Resource Control.

Em versões anteriores do Visual Studio, as faixas de opções tinham que ser criadas escrevendo código que usa as classes de faixa de opções MFC, como a Classe CMFCRibbonBar. No Visual Studio 2010 e posterior, o designer de faixa de opções fornece um método alternativo para criar faixas de opções. Primeiro, crie e personalize uma faixa de opções como um recurso. Em seguida, carregue o recurso da faixa de opções do código no aplicativo MFC. Você pode até mesmo usar recursos de faixa de opções e classes de faixa de opções MFC juntas. Por exemplo, você pode criar um recurso de faixa de opções e, em seguida, adicionar programaticamente mais elementos a ele em runtime usando código.

Noções básicas sobre o Designer de faixa de opções

O designer de faixa de opções cria e armazena a faixa de opções como um recurso. Quando você cria um recurso de faixa de opções, o designer de faixa de opções faz essas três coisas:

  • Adiciona uma entrada no script de definição de recurso do projeto (*.rc). No exemplo a seguir, IDR_RIBBON é o nome exclusivo que identifica o recurso da faixa de opções, RT_RIBBON_XML é o tipo de recurso e ribbon.mfcribbon-ms é o nome do arquivo de recurso.
    IDR_RIBBON RT_RIBBON_XML      "res\\ribbon.mfcribbon-ms"
  • Adiciona as definições de IDs de comando ao resource.h.
#define IDR_RIBBON            307
  • Cria um arquivo de recurso de faixa de opções (*.mfcribbon-ms) que contém o código XML que define os botões, controles e atributos da faixa de opções. As alterações na faixa de opções no designer de faixa de opções são armazenadas no arquivo de recurso como XML. O exemplo de código a seguir mostra parte do conteúdo de um arquivo *.mfcribbon-ms:
<RIBBON_BAR>
<ELEMENT_NAME>RibbonBar</ELEMENT_NAME>
<IMAGE>
<ID>
<NAME>IDB_BUTTONS</NAME>
<VALUE>113</VALUE>
</ID>

Para usar o recurso de faixa de opções em seu aplicativo MFC, carregue o recurso chamando CMFCRibbonBar::LoadFromResource.

Criando uma Faixa de opções usando o Designer de faixa de opções

Essas são as duas maneiras de adicionar um recurso de faixa de opções ao seu projeto MFC:

Se o projeto já tiver uma faixa de opções codificada manualmente, o MFC terá funções que você pode usar para converter a faixa de opções existente em um recurso de faixa de opções. Para obter mais informações, confira: Como converter uma faixa de opções MFC existente em um recurso da faixa de opções.

Observação

As faixas de opções não podem ser criadas em aplicativos baseados em caixa de diálogo. Para obter mais informações, consulte Tipo de Aplicativo, Assistente de Aplicativo MFC.

Personalizando faixas de opções

Para abrir uma faixa de opções no designer de faixa de opções, clique duas vezes no recurso de faixa de opções no Modo de Exibição de Recursos. No designer, você pode adicionar, remover e personalizar elementos na faixa de opções, no botão Aplicativo ou na barra de ferramentas de acesso rápido. Você também pode vincular eventos, por exemplo, eventos de botão e eventos de menu a um método em seu aplicativo.

A ilustração a seguir mostra os vários componentes no designer da faixa de opções.

MFC Ribbon Designer.

  • Caixa de ferramentas: contém controles que podem ser arrastados para a superfície do designer.

  • Superfície do Designer: contém a representação visual do recurso da faixa de opções.

  • Assistente de classe: lista os atributos do item selecionado na superfície do designer.

  • Janela do modo de exibição de recurso: exibe os recursos que incluem recursos da faixa de opções em seu projeto.

  • Barra de ferramentas do editor de Faixa de opções: contém comandos que permitem visualizar a faixa de opções e alterar seu tema visual.

Os tópicos a seguir descrevem como usar os recursos no designer de faixa de opções:

Definições de elementos da faixa de opções

MFC Ribbon.

  • Botão do aplicativo: o botão que aparece no canto superior esquerdo de uma faixa de opções. O botão Aplicativo substitui o menu Arquivo e fica visível mesmo quando a faixa de opções é minimizada. Quando o botão é clicado, um menu que tem uma lista de comandos é exibido.

  • Barra de ferramentas de acesso rápido:uUma barra de ferramentas pequena e personalizável que exibe comandos usados com frequência.

  • Categoria: o agrupamento lógico que representa o conteúdo de uma guia de faixa de opções.

  • Botão padrão da categoria: o botão que aparece na faixa de opções quando a faixa de opções é minimizada. Quando o botão é clicado, a categoria reaparece como um menu.

  • Painel: uma área da barra de faixa de opções que exibe um grupo de controles relacionados. Cada categoria de faixa de opções contém um ou mais painéis de faixa de opções.

  • Elementos da faixa de opções: controles nos painéis, por exemplo, botões e caixas de combinação. Para ver os vários controles que podem ser hospedados em uma faixa de opções, consulte Amostra RibbonGadgets: Aplicativo de gadgets da faixa de opções.

Confira também

Elementos de interface de usuário
Trabalhando com arquivos de recurso