In-Ribbon 库

In-Ribbon 库是显示功能区中相关项或命令集合的控件。如果库中的项目太多，则会提供展开箭头，以在展开窗格中显示集合的其余部分。

详

以下屏幕截图演示了 Microsoft Paint 中的功能区 In-Ribbon 库控件。

microsoft 油漆功能区中一个 inbbongallery 控件的屏幕截图。

功能区框架为 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	只能通过无效更新。