Поделиться через


Коллекция разделит кнопки

Коллекция "Разделить кнопки" — это составной элемент управления, содержащий основную кнопку, которая предоставляет один элемент по умолчанию или команду, и вторичная кнопка, которая при щелчке отображает остальную часть элемента или коллекции команд в раскрывающемся списке.

Подробности

Этот элемент управления полезен для предоставления тесно связанных элементов в тех случаях, когда доступно очевидное значение по умолчанию и где отдельные элементы могут быть представлены изображением, текстом или обоими.

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

снимок экрана элемента управления splitbuttongallery на ленте microsoft paint.

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

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

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

Заметка

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

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

Ключ свойства Примечания
UI_PKEY_BooleanValue Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
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 Можно обновлять только через недопустимое обновление.

элемент разметки SplitButtonGallery

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

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