Compartilhar via


Compilar a marcação da faixa de opções

Para que a estrutura da Faixa de Opções do Windows consuma o arquivo de marcação da Faixa de Opções , o arquivo de marcação deve ser compilado em um arquivo de recurso de formato binário. Um compilador de marcação dedicado, o UICC (Compilador de Comandos de Interface do Usuário), está incluído no SDK (Software Development Kit) do Windows (7.0 ou posterior) para essa finalidade. Além de compilar a versão binária da marcação, o UICC gera um arquivo de cabeçalho de definição de ID (.h) que expõe todos os elementos de marcação para o aplicativo host da Faixa de Opções e um arquivo de recurso (.rc) que é usado para vincular recursos de imagem e cadeia de caracteres ao aplicativo host no momento da compilação.

Fluxo de trabalho do compilador

O fluxo de trabalho do compilador de marcação da Faixa de Opções é ilustrado no diagrama a seguir.

diagrama mostrando o fluxo de trabalho do compilador de marcação da faixa de opções.

Sintaxe da linha de comando

A sintaxe de linha de comando para o compilador de marcação da Faixa de Opções é mostrada no exemplo a seguir.

UICC <ribbonFile> <binaryFile> [options]

Argumentos e opções

Os argumentos e as opções dessa ferramenta são descritos na tabela a seguir.

Observação

As opções de linha de comando listadas devem ser especificadas na ordem fornecida.

Opção Descrição
/header:<headerFile> Gere um arquivo de cabeçalho chamado <headerFile> que contém os símbolos de recurso de ID de Comando de marcação. Se omitido, um arquivo de cabeçalho não será gerado.
/res:<resourceFile> Gere um arquivo de recurso chamado <resourceFile que vincula> todos os recursos de imagem e cadeia de caracteres, o arquivo de marcação binária e o arquivo de cabeçalho ao aplicativo host no momento da compilação. Se omitido, um arquivo de recurso não será gerado.
/name:<ribbonName> O nome do recurso para o arquivo de marcação binária registrado no <resourceFile>. O padrão é APPLICATION_RIBBON.
/W{0\1\2} Filtre as mensagens de evento com base na gravidade.
0
Mensagens de erro somente.
1
Somente mensagens de erro e aviso.
2
Padrão.
Mensagens de erro, aviso e informativas.

Exemplo

O exemplo a seguir demonstra como usar o compilador de marcação da Faixa de Opções para gerar um conjunto típico de arquivos de recurso para um aplicativo da Faixa de Opções.

UICC.exe RibbonMarkup.xml RibbonMarkup.bml /header:RibbonIds.h /res:RibbonUI.rc

Declarando comandos e controles com marcação de faixa de opções

Criando um aplicativo de faixa de opções