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