将命令按钮添加到类别行

如果实现，还可以在属性检查器网格中显示特定于类别的命令按钮。这些按钮类似于“特性”选项板的常规命令按钮。一个区别是位置。特性调色板命令按钮显示在“属性检查器”网格和状态栏之间。类别命令按钮与类别名称显示在同一行中。IAcPiCategorizeProperties

创建类别命令按钮需要两个基本步骤：

• 对于每个按钮，创建一个实现接口的对象。IAcPiCommandButton
• 通过实现方法将每个类别的按钮对象传递给属性检查器。IAcPiCategorizeProperties::GetCommandButtons()

或者，类别命令按钮可以通过声明类别命令按钮映射来实现。模板类查找此映射，如果找到，则使用其数据在运行时生成按钮。IAcPiCategorizePropertiesImpl

在类别命令按钮映射中指定的第一个按钮属性是类别的 PROPCAT 标识符。此 ID 与用于在 OPMPROP 映射中指定类别的 ID 相同。其余按钮属性与将命令按钮添加到“特性选项板”部分中描述的属性相同。

类别命令按钮和“特性”选项板命令按钮在大小和分辨率上也有所不同。类别命令按钮的大小为 13 像素宽 x 12 像素高。如果位图的分辨率大于按钮，则仅显示左上角的 13° 12 像素矩阵。

典型的类别命令按钮映射如下所示：

BEGIN_CATCMDBTN_MAP()
CATCMDBTN_MAP_ENTRY(PROPCAT_Data, 0, “IDB_CATCMDBTN1ENABLED”,
PICTYPE_BITMAP, NULL, PICTYPE_UNINITIALIZED, 0x00000002,
MyCatButtonProc)
END_CATCMDBTN_MAP()

此映射创建一个切换按钮，其中启用了 13° 12 的位图，没有禁用的位图，以及一个名为 MyCatButtonProc 的执行过程。此按钮显示在属性检查器的“数据”类别行中。