VSCT XML 架构参考

提供一个命令表编译器架构元素,其中包含每个元素的允许子元素和属性。

基于 XML 的命令表配置 (.vsct) 文件定义 VSPackage 提供给集成开发环境(IDE)的命令元素。 这些元素包括菜单项、菜单、工具栏和组合框。

注意

VSCT 编译器可以在 .vsct 文件上运行预处理器。 由于这通常是 C++ 预处理器,因此可以定义包含和宏,这些语法与 C++ 文件中使用的语法相同。 在为 VSPackage 项目创建的新项目向导创建的 .vsct 文件中提供了此示例。

可选元素

某些 VSCT 元素是可选的。 Parent如果未指定参数,Group_Undefined:0 将隐含。 Icon如果未指定参数,则 guid办公室Icon:msotcidNoIcon 将隐含。 定义快捷键时,通常未使用的仿真是可选的。

通过在参数中 href 指定位图条的位置,可以在编译时嵌入位图项。 位图条在合并期间复制,而不是从 DLL 的资源中提取。 href提供参数时,参数usedList变为可选,位图条中的所有槽都被视为使用。

必须使用符号名称定义所有 GUID 和 ID 值。 这些名称可以在头文件或 VSCT <符号> 部分中定义。 符号名称必须是本地名称,必须通过 <Include> 元素包含,或由 <Extern> 元素引用。 如果符号名称遵循 #define SYMBOL VALUE 的简单模式,则从 Extern> 元素中指定的<头文件导入符号名称。 该值可以是另一个符号,只要之前定义了该符号。 GUID 定义必须遵循 OLE 或 C++ 格式。 ID 值可以是十进制数字或以 0x 开头的十六进制数字,如以下行所示:

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

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

    可以使用 XML 注释,但往返图形用户界面(GUI)工具可能会取消卡它们。 无论格式如何,都保证保留 Annotation> 元素的内容<。

架构层次结构

.vsct 文件具有以下主要元素。

另请参阅