Группа (Windows Ribbon Framework)
Группа упорядочивает связанные команды и элементы управления в tab.
Подробности
На следующем снимке экрана показан элемент управления "Группа ленты".
Свойства группы
Платформа ленты определяет коллекцию ключей свойств для элемента управления 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 | Можно обновлять только через недопустимое обновление. |