编译功能区标记

若要使 Windows 功能区框架使用 功能区标记 文件,必须将标记文件编译为二进制格式的资源文件。 为此,Windows 软件开发工具包 (SDK) (7.0 或更高版本) 随附了专用标记编译器(UI 命令编译器 (UICC) )。 除了编译标记的二进制版本外,UICC 还会生成 ID 定义标头 (.h) 文件,该文件向功能区主机应用程序公开所有标记元素,以及用于在生成时将图像和字符串资源链接到主机应用程序的资源 (.rc) 文件。

编译器工作流

下图演示了功能区标记编译器的工作流。

显示功能区标记编译器工作流的示意图。

命令行语法

以下示例显示了功能区标记编译器的命令行语法。

UICC <ribbonFile> <binaryFile> [options]

参数和选项

下表介绍了此工具的参数和选项。

注意

列出的命令行选项必须按给定的顺序指定。

选项 说明
/header:<headerFile> 生成名为 headerFile> 的<头文件,其中包含标记命令 ID 资源符号。 如果省略,则不会生成头文件。
/res:<resourceFile> 生成名为 <resourceFile> 的资源文件,该文件在生成时将所有图像和字符串资源、二进制标记文件以及头文件链接到主机应用程序。 如果省略,则不会生成资源文件。
/name:<ribbonName> 在 resourceFile> 中<记录的二进制标记文件的资源名称。 默认值为 APPLICATION_RIBBON。
/W{0\1\2} 根据严重性筛选事件消息。
0
仅错误消息。
1
仅限错误和警告消息。
2
默认。
错误、警告和信息性消息。

示例

以下示例演示如何使用功能区标记编译器为功能区应用程序生成一组典型的资源文件。

UICC.exe RibbonMarkup.xml RibbonMarkup.bml /header:RibbonIds.h /res:RibbonUI.rc

使用功能区标记声明命令和控件

创建功能区应用程序