切换按钮
单击时，“切换按钮”为应用程序提供输入。 控件表示互斥的切换状态。
详细信息
以下屏幕截图演示了功能区切换按钮。
切换按钮属性
功能区框架定义切换按钮控件 的属性键 集合。
通常，通过调用 IUIFramework：：InvalidateUICommand 方法使与控件关联的命令失效，从而在功能区 UI 中更新切换按钮属性。 无效事件由 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 | 只能通过失效进行更新。 |