拆分按钮库

拆分按钮库是一个复合控件,其中包含一个主按钮,该按钮公开单个默认项或命令,以及单击后,该按钮会在互斥下拉列表中显示项或命令集合的其余部分。

详细信息

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

以下屏幕截图演示了 Microsoft 画图 中的功能区拆分按钮库。

screen shot of a splitbuttongallery control in the microsoft paint ribbon.

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

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

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

注意

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

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

属性键 备注
UI_PKEY_BooleanValue 支持 IUIFramework::GetUICommandPropertyIUIFramework::SetUICommandProperty
UI_PKEY_Categories 支持 IUIFramework::GetUICommandPropertyIUIFramework::SetUICommandProperty
UI_PKEY_Enabled 支持 IUIFramework::GetUICommandPropertyIUIFramework::SetUICommandProperty
UI_PKEY_ItemsSource 支持 IUIFramework::GetUICommandPropertyIUIFramework::SetUICommandProperty
UI_PKEY_Keytip 只能通过无效更新。
UI_PKEY_Label 只能通过无效更新。
UI_PKEY_LargeHighContrastImage 只能通过无效更新。
UI_PKEY_LargeImage 只能通过无效更新。
UI_PKEY_SelectedItem 仅对项库) 有效 (
支持 IUIFramework::GetUICommandPropertyIUIFramework::SetUICommandProperty
[!注意]
如果通过调用 IUIFramework::InvalidateUICommand 使与控件关联的命令失效,则当作为标志值传递时UI_INVALIDATIONS_VALUE,框架将查询此属性。

UI_PKEY_SmallHighContrastImage 只能通过无效更新。
UI_PKEY_SmallImage 只能通过无效更新。
UI_PKEY_TooltipDescription 只能通过无效更新。
UI_PKEY_TooltipTitle 只能通过无效更新。

SplitButtonGallery 标记元素

使用库

库示例