复选框

复选框是一个控件，用户可以单击它来向应用程序提供输入。控件提供以可视方式表示的切换状态。

详细信息

复选框不支持第三种状态或不确定状态。

以下屏幕截图演示了功能区复选框元素。

microsoft paint 功能区中复选框控件的屏幕截图。

功能区框架定义复选框控件的属性键集合。

通常，通过调用 IUIFramework：：InvalidateUICommand 方法使与控件关联的命令失效，从而在功能区 UI 中更新 Check Box 属性。无效事件由 IUICommandHandler：：UpdateProperty 回调方法处理，并更新定义的属性。

IUICommandHandler：：UpdateProperty 回调方法不会执行，应用程序会查询更新的属性值，直到框架需要该属性。例如，在功能区 UI 中激活选项卡和显示控件时，或显示工具提示时。

注意

在某些情况下，可以通过 IUIFramework：：GetUICommandProperty 方法检索属性，并使用 IUIFramework：：SetUICommandProperty 方法进行设置。

下表列出了与复选框控件关联的属性键。

属性键	注释
UI_PKEY_BooleanValue	支持 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。注意：如果通过调用 IUIFramework：：InvalidateUICommand 使与控件关联的命令失效，框架将在作为标志的值传递时`UI_INVALIDATIONS_VALUE`查询此属性。
UI_PKEY_Enabled	支持 IUIFramework：：GetUICommandProperty 和 IUIFramework：：SetUICommandProperty。
UI_PKEY_Keytip	只能通过失效进行更新。
UI_PKEY_Label	只能通过失效进行更新。
UI_PKEY_LabelDescription	只能通过失效进行更新。
UI_PKEY_LargeHighContrastImage	只能通过失效进行更新。
UI_PKEY_LargeImage	只能通过失效进行更新。
UI_PKEY_SmallHighContrastImage	只能通过失效进行更新。
UI_PKEY_SmallImage	只能通过失效进行更新。
UI_PKEY_TooltipDescription	只能通过失效进行更新。
UI_PKEY_TooltipTitle	只能通过失效进行更新。