Referência de esquema XML VSCT

Artigo
05/18/2015

Fornece uma tabela de elementos de esquema do compilador de tabela de comando, com filho permitido elementos e atributos para cada um.

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

Dica

O compilador VSCT pode executar um pré-processador no arquivo .vsct.Como isso é normalmente o C++ pré-processador, que você pode definir inclui e macros que tenham a mesma sintaxe que é usada em arquivos do C++.São fornecidos exemplos do .vsct de arquivos que o Novo projeto assistente cria um projeto VSPackage.

Elementos opcionais

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

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

Todos os valores GUID e ID devem ser definidos usando nomes simbólicos. Esses nomes podem ser definidos em arquivos de cabeçalho ou em VSCT <Symbols> seções. Os nomes simbólicos devem ser locais, incluída por meio de <Include> elementos, ou referenciado pelo <Extern> elementos. Um nome simbólico é importado de um arquivo de cabeçalho especificado em <Extern> elemento se ele segue o padrão de simple de # definem o SÍMBOLO de valor. O valor pode ser outro símbolo, desde que o símbolo foi definido anteriormente. Definições de GUID devem seguir o formato do OLE ou C++. Valores de ID podem ser dígitos decimais ou dígitos hexadecimais que são precedidos por 0x, como mostrado nas linhas a seguir:

{6D484634-E53D-4a2c-ADCB-55145C9362C8}
{0x6d484634, 0xe53d, 0x4a2c, {0xad, 0xcb, 0x55, 0x14, 0x5c, 0x93, 0x62, 0xc8}}

Comentários XML podem ser usados, mas as ferramentas de ida e volta graphical user interface (GUI) podem descartá-las. O conteúdo de <Annotation> elementos são garantia ser mantidos, independentemente do formato.