拆分按钮

拆分按钮是一个复合控件,用户可以选择绑定到主按钮的默认值,也可以从绑定到辅助按钮的下拉列表中显示的互斥值列表中选择。

简介

如果存在明显的默认值,以及单个项可以由图像、文本或两者表示,则此控件可用于公开密切相关的项目。

以下屏幕截图演示了功能区拆分按钮。

screen shot of a splitbutton control in a sample ribbon.

拆分按钮属性

功能区框架定义拆分按钮控件 的属性键 集合。

通常,通过调用 IUIFramework::InvalidateUICommand 方法,使与控件关联的命令失效,在功能区 UI 中更新拆分按钮属性。 无效事件由 IUICommandHandler::UpdateProperty 回调方法定义的属性更新进行处理。

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

注意

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

下表列出了与拆分按钮控件关联的属性键。

属性键 说明
UI_PKEY_Enabled 支持 IUIFramework::GetUICommandPropertyIUIFramework::SetUICommandProperty
如果禁用了所有子项,框架 会将UI_PKEY_Enabled 设置为 false (0) 。 否则,如果启用了一个或多个子项,UI_PKEY_Enabled设置为 true (-1) 。
[!重要提示]
在启用或禁用一个或多个子项后,拆分按钮控件的 UI_PKEY_Enabled 属性应失效。 这可确保框架查询更新的属性值,并在功能区 UI 中刷新拆分按钮控件的状态。


UI_PKEY_Keytip 只能通过无效更新。
UI_PKEY_TooltipDescription 只能通过无效更新。
UI_PKEY_TooltipTitle 只能通过无效更新。

Windows功能区框架控件库

SplitButton 标记元素