Partilhar via


Compilação do código de marcação da faixa de opções

Para que a estrutura do Ribbon no Windows utilize o arquivo de marcação do Ribbon, o arquivo de marcação deve ser compilado num ficheiro de recursos em formato binário. Um compilador de marcação dedicado, o Compilador de Comandos da Interface do Utilizador (UICC), está incluído no Windows Software Development Kit (SDK) (7.0 ou posterior) para esta finalidade. Além de compilar a versão binária do markup, o UICC gera um ficheiro de cabeçalho de definição de ID (.h) que expõe todos os elementos do markup à aplicação anfitriã da Faixa de Opções, e um ficheiro de recursos (.rc) que é usado para fazer a ligação de recursos de imagem e texto à aplicação anfitriã 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 que mostra o fluxo de trabalho do compilador de marcação em fita.

Command-Line Sintaxe

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 opções para esta ferramenta são descritos na tabela a seguir.

Observação

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

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 é gerado.
/res:<ficheiroDeRecursos> Gere um arquivo de recurso chamado <resourceFile> que vincula todos os recursos de imagem e cadeia de caracteres, o arquivo de marcação binário e o arquivo de cabeçalho ao aplicativo host no momento da compilação. Se omitido, um arquivo de recurso não é gerado.
/name:<ribbonNome> O nome do recurso para o arquivo de marcação binário que é registrado no <resourceFile>. O padrão é APPLICATION_RIBBON.
/W{0\1\2} Filtre as mensagens de evento com base na gravidade.
0
Apenas mensagens de erro.
1
Apenas mensagens de erro e aviso.
2
Inadimplência.
Mensagens de erro, aviso e informações.

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 recursos 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 da faixa de opções

Criando uma aplicação de faixa de opções