Drop-Down 库

Drop-Down 库由一个按钮组成,单击该按钮时会显示包含互斥项或命令集合的下拉列表。

详细信息

此控件可用于公开没有明显默认值且各个项可由图像和/或文本表示的相关项或命令。

通过 DropDownGallery.MenuLayout 元素提供对垂直和角手柄条或调整控点大小的支持。

以下屏幕截图演示了 Microsoft 画图 中的功能区 Drop-Down 库。

microsoft paint 功能区中下拉列表控件的屏幕截图。

功能区框架定义 Drop-Down 库控件 的属性键 集合。

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

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

注意

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

下表列出了与 Drop-Down 库控件关联的属性键。

属性键 注释
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 只能通过失效进行更新。

Windows 功能区框架控件库

DropDownGallery 标记元素

使用库

库示例