Drop-Down 按钮

Drop-Down 按钮包含一个按钮,当单击时,该按钮将显示互斥项的下拉列表。

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

以下屏幕截图演示了示例功能区中的功能区 Drop-Down 按钮。

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

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

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

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

注意

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

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

属性键 笔记
UI_PKEY_Categories 支持 IUIFramework::GetUICommandPropertyIUIFramework::SetUICommandProperty
UI_PKEY_Enabled 支持 IUIFramework::GetUICommandPropertyIUIFramework::SetUICommandProperty
如果禁用了所有子项,框架会将 UI_PKEY_Enabled 设置为 false (0)。 否则,如果启用了一个或多个子项,则UI_PKEY_Enabled设置为 true(-1)。 重要提示:
在启用或禁用一个或多个子项后,应使 Drop-Down 按钮控件的 UI_PKEY_Enabled 属性失效。 这可确保框架查询更新的属性值并刷新功能区 UI 中 Drop-Down 按钮控件的状态。
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 功能区框架控件库

DropDownButton 标记元素