Compartilhar via


Referência do esquema XML VSCT

Fornece uma tabela de elementos de esquema do Compilador de Tabela de Comandos, com elementos e atributos filho permitidos para cada um.

Um arquivo de configuração de tabela de comando (.vsct) baseado em XML define os elementos de comando que um VSPackage fornece ao ambiente de desenvolvimento integrado (IDE). Esses elementos incluem itens de menu, menus, barras de ferramentas e caixas de combinação.

Observação

O compilador VSCT pode executar um pré-processador no arquivo .vsct. Como esse é normalmente o pré-processador C++, você pode definir inclusões e macros que têm a mesma sintaxe usada em arquivos C++. Exemplos disso são fornecidos no arquivo .vsct que o assistente para Novo projeto cria para um projeto VSPackage.

Elementos opcionais

Alguns elementos VSCT são opcionais. Se um Parent argumento não for especificado, Group_Undefined:0 será implícito. Se um Icon argumento não for especificado, guidOfficeIcon:msotcidNoIcon será implícito. Quando uma tecla de atalho é definida, a emulação, que normalmente não é usada, é opcional.

Os itens de bitmap podem ser incorporados em tempo de compilação especificando o local da faixa de bitmap no href argumento. A faixa de bitmap é copiada durante a mesclagem em vez de extraída dos recursos da DLL. Quando um href argumento é fornecido, o usedList argumento se torna opcional e todos os slots na faixa de bitmap são considerados usados.

Todos os valores de GUID e ID devem ser definidos usando nomes simbólicos. Esses nomes podem ser definidos em arquivos de cabeçalho ou em seções de símbolos> VSCT<. Os nomes simbólicos devem ser locais, incluídos por meio de elementos Include ou referenciados por <<elementos Extern>.> Um nome simbólico é importado de um arquivo de cabeçalho especificado em um <elemento Extern> se seguir o padrão simples de #define SYMBOL VALUE. O valor pode ser outro símbolo, desde que esse símbolo tenha sido definido previamente. As definições de GUID devem seguir o formato OLE ou C++. Os valores de ID podem ser dígitos decimais ou dígitos hexadecimais precedidos por 0x, conforme mostrado nas seguintes linhas:

  • {6D484634-E53D-4A2C-ADCB-55145C9362C8}

  • { 0x6d484634, 0xe53d, 0x4a2c, { 0xad, 0xcb, 0x55, 0x14, 0x5c, 0x93, 0x62, 0xc8 } }

    Comentários XML podem ser usados, mas ferramentas de interface gráfica do usuário (GUI) de ida e volta podem descartá-los. O conteúdo dos elementos de <anotação> é garantido para ser mantido independentemente do formato.

Hierarquia de esquema

Um arquivo .vsct tem os seguintes elementos principais.

Confira também