Référence du schéma XML VSCTVSCT XML schema reference

Fournit un tableau d’éléments de schéma du compilateur de Table de commande, avec enfant autorisé éléments et attributs pour chacun.Provides a table of Command Table Compiler schema elements, with allowed child elements and attributes for each.

Un fichier de configuration (.vsct) de table de commande basé sur XML définit les éléments de commande qui fournit un VSPackage à l’environnement de développement intégré (IDE).An XML-based command table configuration (.vsct) file defines the command elements that a VSPackage provides to the integrated development environment (IDE). Ces éléments incluent les éléments de menu, des menus, des barres d’outils et des zones de liste déroulante.These elements include menu items, menus, toolbars, and combo boxes.

Note

Le compilateur VSCT peut exécuter un préprocesseur sur le fichier .vsct.The VSCT compiler can run a preprocessor on the .vsct file. Comme il s’agit en général le préprocesseur, que vous pouvez définir C++ inclut et macros qui ont la même syntaxe que celle qui est utilisée dans des fichiers 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. Des exemples sont fournis dans le fichier .vsct de fichiers qui le nouveau projet Assistant créer un projet VSPackage.Examples of this are provided in the .vsct file that the New Project wizard creates for a VSPackage project.

Éléments facultatifsOptional elements

Certains éléments VSCT sont facultatifs.Some VSCT elements are optional. Si un Parent argument n’est pas spécifié, Group_Undefined:0 sera être implicite.If a Parent argument is not specified, Group_Undefined:0 will be implied. Si un Icon argument n’est pas spécifié, guidOfficeIcon:msotcidNoIcon sera être implicite.If an Icon argument is not specified, guidOfficeIcon:msotcidNoIcon will be implied. Lorsqu’une touche de raccourci est définie, l’émulation, qui est généralement inutilisée, est facultative.When a shortcut key is defined, the emulation, which is typically unused, is optional.

Éléments de bitmap peuvent être incorporés au moment de la compilation en spécifiant l’emplacement de la bande de bitmaps dans le href argument.Bitmap items may be embedded at compile time by specifying the location of the bitmap strip in the href argument. La bande de bitmaps est copiée lors de la fusion et non extraites à partir des ressources de la DLL.The bitmap strip is copied during the merge rather than extracted from the resources of the DLL. Quand un href argument est fourni, le usedList argument devient facultatif, et tous les emplacements dans la bande de bitmaps sont considérés comme utilisé.When an href argument is provided, the usedList argument becomes optional, and all slots in the bitmap strip are considered used.

Toutes les valeurs GUID et l’ID doivent être définis à l’aide des noms symboliques.All GUID and ID values must be defined by using symbolic names. Ces noms peuvent être définies dans les fichiers d’en-tête ou dans VSCT <symboles > sections.These names may be defined in header files or in VSCT <Symbols> sections. Les noms symboliques doivent être locales, inclus dans le cadre <Include > éléments, ou référencé par <Extern > éléments.The symbolic names must be local, included through <Include> elements, or referenced by <Extern> elements. Un nom symbolique est importé à partir d’un fichier d’en-tête spécifié dans un <Extern > élément s’il suit le modèle simple de #define valeur du symbole.A symbolic name is imported from a header file specified in an <Extern> element if it follows the simple pattern of #define SYMBOL VALUE. La valeur peut être un autre symbole, que ce symbole a été défini précédemment.The value may be another symbol as long as that symbol was previously defined. Définitions de GUID doivent suivre le format OLE ou du C++.GUID definitions must follow either the OLE or C++ format. Les valeurs d’ID peuvent être chiffres décimaux ou hexadécimaux qui est précédés de 0 x, comme indiqué dans les lignes suivantes :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 } }

    Commentaires XML peuvent être utilisés, mais les outils d’interface (GUI) utilisateur graphique aller-retour peuvent les ignorer.XML comments may be used, but round-trip graphical user interface (GUI) tools might discard them. Le contenu de <Annotation > éléments sont garanties pour être conservée, quel que soit le format.The contents of <Annotation> elements are guaranteed to be maintained regardless of format.

Hiérarchie de schémaSchema hierarchy

Un fichier .vsct a les éléments principaux suivants.A .vsct file has the following major elements.

Élément CommandTableCommandTable element

Élément externExtern element

Élément IncludeInclude element

Définir l’élémentDefine element

Élément CommandsCommands element

Élément CommandPlacementsCommandPlacements element

Élément VisibilityConstraintsVisibilityConstraints element

Élément KeyBindingsKeyBindings element

Élément UsedCommandsUsedCommands element

Élément parentParent element

Élément IconIcon element

Élément StringsStrings element

Élément Command FlagCommand Flag element

Élément SymbolsSymbols element

Attributs conditionnelsConditional attributes

Voir aussiSee also

Comment VSPackages ajoute des éléments d’interface utilisateur How VSPackages add user interface elements
Routage des commandes dans VSPackagesCommand routing in VSPackages