Drop-Down 库
Drop-Down 库包含一个按钮,当单击时,该按钮显示包含互斥项或命令集合的下拉列表。
详
此控件可用于公开没有明显默认值的相关项或命令,并且单个项可以由图像、文本或两者都表示。
通过 DropDownGallery.MenuLayout 元素提供对垂直和角控手柄或调整手柄大小的支持。
以下屏幕截图演示了 Microsoft Paint 中的功能区 Drop-Down 库。
Drop-Down 库属性
功能区框架为 Drop-Down 库控件定义 属性键的集合。
通常,通过调用 IUIFramework::InvalidateUICommand 方法使与控件关联的命令失效,在功能区 UI 中更新 Drop-Down 库属性。 无效事件由 IUICommandHandler::UpdateProperty 回调方法处理并定义属性更新。
不会执行 IUICommandHandler::UpdateProperty 回调方法,并且应用程序会查询更新的属性值,直到框架需要该属性。 例如,当选项卡被激活,并在功能区 UI 中显示控件或显示工具提示时。
注意
在某些情况下,可以通过 IUIFramework::GetUICommandProperty 方法检索属性,并使用 IUIFramework::SetUICommandProperty 方法进行设置。
下表列出了与 Drop-Down 库控件关联的属性键。
属性键 | 笔记 |
---|---|
UI_PKEY_Categories | 支持 IUIFramework::GetUICommandProperty 和 IUIFramework::SetUICommandProperty。 |
UI_PKEY_Enabled | 支持 IUIFramework::GetUICommandProperty 和 IUIFramework::SetUICommandProperty。 |
UI_PKEY_ItemsSource | 支持 IUIFramework::GetUICommandProperty 和 IUIFramework::SetUICommandProperty。 |
UI_PKEY_Keytip | 只能通过无效更新。 |
UI_PKEY_Label | 只能通过无效更新。 |
UI_PKEY_LargeHighContrastImage | 只能通过无效更新。 |
UI_PKEY_LargeImage | 只能通过无效更新。 |
UI_PKEY_SelectedItem(仅对项库有效) |
支持 IUIFramework::GetUICommandProperty 和 IUIFramework::SetUICommandProperty。
注意: 如果通过调用 IUIFramework::InvalidateUICommand使与控件关联的命令失效,则当 UI_INVALIDATIONS_VALUE 作为 标志的值传递时,框架将查询此属性。 |
UI_PKEY_SmallHighContrastImage | 只能通过无效更新。 |
UI_PKEY_SmallImage | 只能通过无效更新。 |
UI_PKEY_TooltipDescription | 只能通过无效更新。 |
UI_PKEY_TooltipTitle | 只能通过无效更新。 |