Коллекция In-Ribbon

  • Статья

Коллекция In-Ribbon — это элемент управления, который отображает коллекцию связанных элементов или команд на ленте. Если в коллекции слишком много элементов, отображается стрелка развертывания для отображения остальной части коллекции в развернутой области.

Сведения

На следующем снимке экрана показан элемент управления Коллекция In-Ribbon ленты в Microsoft Paint.

Снимок экрана: элемент управления inribbongallery на ленте Microsoft Paint.

Платформа ленты определяет коллекцию ключей свойств для элемента управления коллекция In-Ribbon.

Как правило, свойство коллекции In-Ribbon обновляется в пользовательском интерфейсе ленты путем аннулирования команды, связанной с элементом управления, с помощью вызова метода IUIFramework::InvalidateUICommand . Событие недействительности обрабатывается и свойство обновляется с помощью метода обратного вызова IUICommandHandler::UpdateProperty .

Метод обратного вызова IUICommandHandler::UpdateProperty не выполняется, и приложение запросит обновленное значение свойства, пока свойство не потребуется платформе. Например, при активации вкладки и отображении элемента управления в пользовательском интерфейсе ленты или при отображении подсказки.

Примечание

В некоторых случаях свойство можно получить с помощью метода 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 Может быть обновлено только через недействительность.

Библиотека элементов управления Windows Ribbon Framework

Элемент InRibbonGallery

Работа с коллекциями

Пример коллекции