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

  • Статья

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

Сведения

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

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

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

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

Как правило, свойство Коллекция разбиения кнопок обновляется в пользовательском интерфейсе ленты путем отмены команды, связанной с элементом управления, путем вызова метода 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

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

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