将命令按钮添加到特性选项板

要在“特性”选项板上提供工具栏样式的命令按钮，请实现 和接口。您提供一个类，该类为您定义的每个按钮实现。该界面向属性检查器提供按钮的位图、状态和样式。若要定义按钮的行为，请实现该方法。属性检查器在用户单击按钮时调用此方法。IAcPiCommandButtonIAcPiPropCommandButtonsIAcPiCommandButtonIAcPiCommandButtonIAcPiCommandButton::Execute()

属性检查器通过调用方法实现来访问按钮定义。您只需返回引用按钮定义的指针。通过此方法生成的命令按钮显示在属性检查器上的类别列表和状态栏之间。IAcPiPropCommandButtons::GetCommandButtons()SAFEARRAYIUnknown

实现命令按钮的一种更简单的方法是从模板类派生并声明命令按钮映射。模板类实现该方法。此实现在运行时生成使用命令按钮映射中指定的配置的按钮。IAcPiPropCommandButtonsImplIAcPiPropCommandButtons::GetCommandButtons()

每个映射条目为单个按钮提供以下信息：

• 按钮名称的字符串资源 ID（也用作工具提示字符串）
• 已启用的位图资源 ID
• 启用的位图类型
• 禁用的位图资源 ID
• 禁用的位图类型
• 按钮样式
• 按钮执行过程的地址

按钮可以指定两个位图：一个在启用按钮时显示，另一个在禁用按钮时显示。位图类型在 Windows PICTYPE 枚举中定义。位图分辨率以字符串格式表示。命令按钮的大小为 16 像素宽 x 15 像素高。如果位图的分辨率大于按钮，则仅显示左上角的 16° 15 像素矩阵。

按钮的样式指示它是典型的 Windows 单击按钮还是双状态切换按钮。若要定义切换按钮，请指定设置窗口定义位 （） 的类型值。否则，您应该指定。longBS_CHECKBOX0x00000002NULL

下面的示例声明了一个切换按钮，该按钮具有启用 16° 15 位图的位图类型、未禁用的位图和名为 MyButtonProc 的执行例程：

BEGIN_CMDBTN_MAP()
CMDBTN_MAP_ENTRY(IDS_CMDBTN1, “IDB_CMDBTN1ENABLED”, PICTYPE_BITMAP, NULL, PICTYPE_UNINITIALIZED, 0x00000002, MyButtonProc)
END_CMDBTN_MAP()