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


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

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

Знакомство

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

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

снимок экрана с элементом управления splitbutton на образце ленты.

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

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

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

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

Заметка

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

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

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

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

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