Referencia del esquema XML de VSCTVSCT XML schema reference

Proporciona una tabla de elementos de esquema del compilador de tabla de comandos, con el elemento secundario permitido elementos y atributos para cada uno.Provides a table of Command Table Compiler schema elements, with allowed child elements and attributes for each.

Un archivo de configuración (.vsct) de la tabla de comandos basado en XML define los elementos de comando que un paquete VSPackage proporciona al entorno de desarrollo integrado (IDE).An XML-based command table configuration (.vsct) file defines the command elements that a VSPackage provides to the integrated development environment (IDE). Estos elementos incluyen elementos de menú, barras de herramientas, menús y cuadros combinados.These elements include menu items, menus, toolbars, and combo boxes.

Note

El compilador VSCT puede ejecutar un preprocesador en el archivo .vsct.The VSCT compiler can run a preprocessor on the .vsct file. Dado que normalmente es el preprocesador, que puede definir C++ incluye y macros que tienen la misma sintaxis que se usa en los archivos de C++.Because this is typically the C++ preprocessor, you can define includes and macros that have the same syntax that is used in C++ files. En el archivo .vsct se proporcionan ejemplos de este archivo que el nuevo proyecto asistente crea para un proyecto de VSPackage.Examples of this are provided in the .vsct file that the New Project wizard creates for a VSPackage project.

Elementos opcionalesOptional elements

Algunos elementos VSCT son opcionales.Some VSCT elements are optional. Si un Parent argumento no se especifica, se implicarse Group_Undefined:0.If a Parent argument is not specified, Group_Undefined:0 will be implied. Si un Icon argumento no se especifica, se implicarse guidOfficeIcon:msotcidNoIcon.If an Icon argument is not specified, guidOfficeIcon:msotcidNoIcon will be implied. Cuando se define una tecla de método abreviado, la emulación, que no se utiliza normalmente, es opcional.When a shortcut key is defined, the emulation, which is typically unused, is optional.

Se puede incrustar elementos de mapa de bits en tiempo de compilación especificando la ubicación de la franja de mapa de bits en el href argumento.Bitmap items may be embedded at compile time by specifying the location of the bitmap strip in the href argument. La Tira de mapa de bits se copian durante la combinación en lugar de extraídos de los recursos del archivo DLL.The bitmap strip is copied during the merge rather than extracted from the resources of the DLL. Cuando un href se proporciona un argumento, el usedList argumento se convierte en opcional y se consideran todas las ranuras en la Tira de mapa de bits utilizado.When an href argument is provided, the usedList argument becomes optional, and all slots in the bitmap strip are considered used.

Todos los valores GUID y el identificador deben definirse mediante el uso de nombres simbólicos.All GUID and ID values must be defined by using symbolic names. Estos nombres pueden definirse en archivos de encabezado o en VSCT <símbolos > secciones.These names may be defined in header files or in VSCT <Symbols> sections. Los nombres simbólicos deben ser locales, incluidos a través de <Include > elementos, o que se hace referencia por <Extern > elementos.The symbolic names must be local, included through <Include> elements, or referenced by <Extern> elements. Un nombre simbólico se importa desde un archivo de encabezado especificado en un <Extern > elemento si sigue el patrón simple de #define el valor de símbolo.A symbolic name is imported from a header file specified in an <Extern> element if it follows the simple pattern of #define SYMBOL VALUE. El valor puede ser otro símbolo siempre que ese símbolo se ha definido previamente.The value may be another symbol as long as that symbol was previously defined. Definiciones de GUID deben seguir el formato OLE o C++.GUID definitions must follow either the OLE or C++ format. Los valores de identificador pueden ser dígitos decimales o hexadecimales dígitos que van precedidos de 0 x, tal como se muestra en las siguientes líneas:ID values may be either decimal digits or hexadecimal digits that are preceded by 0x, as shown in the following lines:

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

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

    Se pueden usar los comentarios XML, pero las herramientas de ida y vuelta gráfica de usuario (GUI) de la interfaz podrían descartarlos.XML comments may be used, but round-trip graphical user interface (GUI) tools might discard them. El contenido de <anotación > se garantiza que los elementos se mantiene independientemente del formato.The contents of <Annotation> elements are guaranteed to be maintained regardless of format.

Jerarquía del esquemaSchema hierarchy

Un archivo .vsct tiene los siguientes elementos principales.A .vsct file has the following major elements.

CommandTable (elemento)CommandTable element

Extern (elemento)Extern element

Elemento de inclusiónInclude element

Definir el elementoDefine element

Elemento CommandsCommands element

CommandPlacements (elemento)CommandPlacements element

VisibilityConstraints (elemento)VisibilityConstraints element

KeyBindings (elemento)KeyBindings element

UsedCommands (elemento)UsedCommands element

Elemento primarioParent element

Icon (elemento)Icon element

Strings (elemento)Strings element

Command Flag (elemento)Command Flag element

Symbols (elemento)Symbols element

Atributos condicionalesConditional attributes

Vea tambiénSee also

Cómo VSPackages agregar elementos de la interfaz de usuario How VSPackages add user interface elements
Enrutamiento de comandos en VSPackagesCommand routing in VSPackages