Group (Windows Ribbon Framework)

Группа упорядочивает связанные команды и элементы управления на вкладке.

Сведения

На следующем снимке экрана показан элемент управления Группа ленты.

снимок экрана с выносками, показывающими группу.

Свойства группы

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

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

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

Примечание

В некоторых случаях свойство можно получить с помощью метода IUIFramework::GetUICommandProperty и задать с помощью метода IUIFramework::SetUICommandProperty .

В следующей таблице перечислены ключи свойств, связанные с элементом управления Group.

Ключ свойства Примечания
UI_PKEY_Keytip Может быть обновлен только через недействительность. Примечание: Платформа требует, чтобы значение UI_PKEY_Keytip для элемента управления Group начиналось с буквы Z в верхнем регистре. Если значение, предоставленное приложением в методе обратного вызова IUICommandHandler::UpdateProperty , не начинается с буквы Z, это значение игнорируется и вместо этого создается значение платформой. Значение платформы — это буква Z, за которой следует числовое значение, начинающееся с 1 и последовательно увеличивающееся по мере необходимости для последующих элементов управления Group (Z1, Z2, ..., Zx).
UI_PKEY_Label Может быть обновлен только через недействительность.
UI_PKEY_LargeHighContrastImage Может быть обновлен только через недействительность.
UI_PKEY_LargeImage Может быть обновлен только через недействительность.
UI_PKEY_SmallHighContrastImage Может быть обновлен только через недействительность.
UI_PKEY_SmallImage Может быть обновлен только через недействительность.
UI_PKEY_TooltipDescription Может быть обновлен только через недействительность.
UI_PKEY_TooltipTitle Может быть обновлен только через недействительность.

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

Элемент Group