Référence du schéma XML VSCT

Article
05/17/2015

Fournit un tableau des éléments de schéma du compilateur de Tableau de commande, avec les éléments enfants et attributs autorisés pour chaque.

Un fichier de configuration de tableau de commande XML (.vsct) définit les éléments de commande qu'un VSPackage fournit à l'environnement de développement intégré (IDE). Ces éléments sont des éléments de menu, des menus, barres d'outils, et les zones de liste déroulante.

Notes

Le compilateur de VSCT peut exécuter un préprocesseur dans un fichier de .vsct.Comme il s'agit généralement du préprocesseur C++, vous pouvez définir inclut et les macros qui ont la même syntaxe utilisée dans des fichiers C++.Des exemples de procédure sont fournis dans le fichier de .vsct que l'Assistant de Nouveau projet le crée pour un projet d'un VSPackage.

éléments facultatifs

les éléments d'un certain VSCT sont facultatifs. si un argument d' Parent n'est pas spécifié, Group_Undefined : 0 sera implicite. si un argument d' Icon n'est pas spécifié, guidOfficeIcon : le msotcidNoIcon sera implicite. Lorsqu'une touche de raccourci est définie, l'émulation, qui est généralement non utilisée, est facultative.

Les éléments de bitmap peuvent être incorporés au moment de la compilation en spécifiant l'emplacement de la bande de bitmap dans l'argument d' href . La bande de bitmap est copiée lors de la fusion plutôt qu'extraite des ressources de la DLL. Lorsqu'un argument d' href est fourni, l'argument d' usedList est facultatif, et tous les emplacements de la bande de bitmap sont considérés comme utilisés.

Tous les GUID et valeurs d'ID doivent être définis à l'aide de noms symboliques. Ces noms peuvent être définis dans les fichiers d'en-tête ou dans des <Symbols> sections de VSCT. Les noms symboliques doivent être des éléments traversants <Include> , ou référencés locaux et inclus par <Extern> les éléments. Un nom symbolique est importé à partir d'un fichier d'en-tête spécifié dans <Extern> un élément s'il suit le modèle simple de la VALEUR de SYMBOLE #define. la valeur peut être un autre symbole tant que ce symbole a été précédemment défini. Les définitions de GUID doivent suivre OLE ou le format C++. Les valeurs d'ID peuvent être des chiffres décimaux ou les chiffres hexadécimaux qui sont précédés par 0x, comme indiqué dans les lignes suivantes :

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

Les commentaires XML peuvent être utilisés, mais les outils aller-retour (GUI) d'interface utilisateur graphique peuvent être ignorés. Le contenu <Annotation> des éléments est obligatoirement géré indépendamment du format.