In-Ribbon 库
In-Ribbon 库是一个控件,用于在功能区中显示相关项或命令的集合。 如果库中的项太多,则会提供一个展开箭头,以在展开的窗格中显示集合的其余部分。
详细信息
以下屏幕截图演示了 Microsoft 画图 中的功能区 In-Ribbon 库控件。
In-Ribbon 库属性
功能区框架定义 In-Ribbon 库控件 的属性键 集合。
通常,通过调用 IUIFramework::InvalidateUICommand 方法使与控件关联的命令失效,In-Ribbon 库属性在功能区 UI 中更新。 无效事件由 IUICommandHandler::UpdateProperty 回调方法处理,并更新定义的属性。
不会执行 IUICommandHandler::UpdateProperty 回调方法,并且应用程序会查询更新的属性值,直到框架需要属性。 例如,当选项卡被激活且控件显示在功能区 UI 中时,或者当显示工具提示时。
注意
在某些情况下,可以通过 IUIFramework::GetUICommandProperty 方法检索属性,并使用 IUIFramework::SetUICommandProperty 方法进行设置。
下表列出了与 In-Ribbon 库控件关联的属性键。
属性键 | 注释 |
---|---|
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 | 只能通过失效进行更新。 |