Разворачивающаяся кнопка

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

Введение

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

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

Снимок экрана: элемент управления splitbutton в примере ленты.

Свойства кнопки split

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

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

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

Примечание

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

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

Ключ свойства Примечания
UI_PKEY_Enabled Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
Если все дочерние элементы отключены, платформа задает для UI_PKEY_Enabled значение false (0). В противном случае, если включен один или несколько дочерних элементов, UI_PKEY_Enabled имеет значение true (-1). Внимание!
Свойство UI_PKEY_Enabled элемента управления "Кнопка разбиения" должно быть недействительным после включения или отключения одного или нескольких дочерних элементов. Это гарантирует, что платформа запрашивает обновленное значение свойства и обновляет состояние элемента управления "Разбиение кнопки" в пользовательском интерфейсе ленты.
UI_PKEY_Keytip Может быть обновлен только через недействительность.
UI_PKEY_TooltipDescription Может быть обновлен только через недействительность.
UI_PKEY_TooltipTitle Может быть обновлен только через недействительность.

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

Элемент разметки SplitButton