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


Кнопка переключения

Кнопка переключения при нажатии кнопки предоставляет входные данные для приложения. Элемент управления представляет взаимоисключающий состояние переключателя.

Подробности

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

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

Переключение свойств кнопки

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

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

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

Заметка

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

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

Ключ свойства Примечания
UI_PKEY_BooleanValue Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty. Примечание. Если команда, связанная с элементом управления, недопустима с помощью вызова IUIFramework::InvalidateUICommand, платформа запрашивает это свойство, когда UI_INVALIDATIONS_VALUE передается в качестве значения флагов .
UI_PKEY_Enabled Поддерживает IUIFramework::GetUICommandProperty и IUIFramework::SetUICommandProperty.
UI_PKEY_Keytip Можно обновлять только через недопустимое обновление.
UI_PKEY_Label Можно обновлять только через недопустимое обновление.
UI_PKEY_LabelDescription Можно обновлять только через недопустимое обновление.
UI_PKEY_LargeHighContrastImage Можно обновлять только через недопустимое обновление.
UI_PKEY_LargeImage Можно обновлять только через недопустимое обновление.
UI_PKEY_SmallHighContrastImage Можно обновлять только через недопустимое обновление.
UI_PKEY_SmallImage Можно обновлять только через недопустимое обновление.
UI_PKEY_TooltipDescription Можно обновлять только через недопустимое обновление.
UI_PKEY_TooltipTitle Можно обновлять только через недопустимое обновление.

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

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