Referencia del esquema XML de VSCTVSCT XML Schema Reference

Proporciona una tabla de elementos de esquema de compilador de tabla de comandos, con 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 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ú, menús, barras de herramientas y cuadros combinados.These elements include menu items, menus, toolbars, and combo boxes.

Nota

El compilador VSCT puede ejecutar un preprocesador en el archivo .vsct.The VSCT compiler can run a preprocessor on the .vsct file. Porque se trata normalmente incluye C++ preprocesador, que puede definir y macros que tienen la misma sintaxis que se utiliza 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 de los elementos VSCT son opcionales.Some VSCT elements are optional. Si un Parent argumento no se especifica, se pueden implícito Group_Undefined:0.If a Parent argument is not specified, Group_Undefined:0 will be implied. Si un Icon argumento no se especifica, se pueden implícito 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 por lo general, es opcional.When a shortcut key is defined, the emulation, which is typically unused, is optional.

Se pueden incrustar elementos de mapa de bits en tiempo de compilación mediante la especificación de la ubicación de la banda 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 franja de mapa de bits se copian durante la combinación en lugar de extraídos de los recursos de la 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 de la franja 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 ID 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, incluido 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 definió anteriormente.The value may be another symbol as long as that symbol was previously defined. Definiciones de GUID deben tener el formato del OLE o C++.GUID definitions must follow either the OLE or C++ format. Valores de identificador pueden ser dígitos decimales o dígitos hexadecimales que estén precedidos de 0 x, 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, 0x62, 0xc8}}{ 0x6d484634, 0xe53d, 0x4a2c, { 0xad, 0xcb, 0x55, 0x14, 0x5c, 0x93, 0x62, 0xc8 } }

    Comentarios XML pueden utilizarse, pero podrían descartarlos herramientas de ida y vuelta gráfica de usuario (GUI) de la interfaz.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

Include (Elemento)Include Element

Define (Elemento)Define Element

Commands (Elemento)Commands Element

CommandPlacements (Elemento)CommandPlacements Element

VisibilityConstraints (Elemento)VisibilityConstraints Element

KeyBindings (Elemento)KeyBindings Element

UsedCommands (Elemento)UsedCommands Element

Parent (Elemento)Parent 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