组合框 (Windows 功能区框架)

组合框包含一个单列列表框,其中包含一组相互排斥的项或命令,与静态控件或编辑控件和下拉箭头组合在一起。 当用户单击下拉箭头时,将显示控件的列表框部分。

列表框中当前选定的项或命令(如果有)显示在静态控件或编辑控件中。 使用编辑控件时,如果用户键入现有项或命令的初始字符,列表框将突出显示具有这些初始字符的第一个项目,并自动完成编辑控件中的条目。

仅支持垂直手柄条或调整手柄大小。

此控件可用于公开简单、密切相关的文本项。

以下屏幕截图演示了 Live Movie Maker 中的功能区组合框。

microsoft 画区中组合框控件的 屏幕截图。

组合框属性

功能区框架定义组合框控件 属性键的集合。

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

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

注意

在某些情况下,可以通过 IUIFramework::GetUICommandProperty 方法检索属性,并使用 IUIFramework::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
UI_PKEY_SmallHighContrastImage 只能通过无效更新。
UI_PKEY_SmallImage 只能通过无效更新。
UI_PKEY_StringValue 支持 IUIFramework::GetUICommandPropertyIUIFramework::SetUICommandProperty注意: 如果通过调用 IUIFramework::InvalidateUICommand使与控件关联的命令失效,则当 UI_INVALIDATIONS_VALUE 作为 标志的值传递时,框架将查询此属性。
UI_PKEY_TooltipDescription 只能通过无效更新。
UI_PKEY_TooltipTitle 只能通过无效更新。

Windows 功能区框架控件库

ComboBox 标记元素

使用库

库示例