Тип элемента управления "Кнопка"

В этом разделе содержатся сведения о поддержке службы автоматизации пользовательского интерфейса Майкрософт для типа элемента управления Button.

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

В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления Button. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления, где платформа и платформа пользовательского интерфейса интегрирует поддержку автоматизации пользовательского интерфейса для типов элементов управления и шаблонов элементов управления.

В этом разделе содержатся следующие разделы.

• типичная структура дерева
• соответствующие свойства
• обязательные шаблоны элементов управления
• обязательные события
• связанные разделы

Типичная структура дерева

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

Представление элемента управления	Представление содержимого
Пуговица Изображение (0 или более) Текст (0 или более)	Пуговица

 

Соответствующие свойства

В следующей таблице перечислены свойства автоматизации пользовательского интерфейса, значения или определения которых особенно важны для элементов управления, реализующих тип элемента управления Button (например, элементы управления кнопкой). Дополнительные сведения о свойствах автоматизации пользовательского интерфейса см. в получения свойств из элементов автоматизации пользовательского интерфейса.

Свойство автоматизации пользовательского интерфейса	Ценность	Примечания
UIA_AcceleratorKeyPropertyId	См. заметки.	Элемент управления кнопкой обычно поддерживает клавишу акселератора, чтобы пользователь мог быстро выполнить действие, представленное кнопкой с клавиатуры.
UIA_AutomationIdPropertyId	См. заметки.	Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева автоматизации пользовательского интерфейса.
UIA_BoundingRectanglePropertyId	См. заметки.	Самый внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId	См. заметки.	Поддерживается, если существует ограничивающий прямоугольник. Если не каждая точка в ограничивающем прямоугольнике можно щелкнуть, а элемент выполняет специализированное тестирование попаданий, переопределите и укажите точку, доступную для щелчка.
UIA_ControlTypePropertyId	кнопки
UIA_HelpTextPropertyId	См. заметки.	Текст справки должен указывать конечный результат активации кнопки. Обычно это тот же тип информации, который представлен с помощью подсказки.
UIA_IsContentElementPropertyId	ИСТИННЫЙ	Элемент управления кнопкой всегда должен быть содержимым.
UIA_IsControlElementPropertyId	ИСТИННЫЙ	Элемент управления кнопкой всегда должен быть элементом управления.
UIA_IsKeyboardFocusablePropertyId	См. заметки.	Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство.
UIA_LabeledByPropertyId	Недействительный	Элементы управления кнопками самозаметятся содержимым.
UIA_LocalizedControlTypePropertyId	См. заметки.	Локализованная строка, соответствующая типу элемента управления Button. Значение по умолчанию — "button" для en-US или английского языка (США).
UIA_NamePropertyId	См. заметки.	Имя элемента управления кнопкой — это текст, используемый для его метки. Всякий раз, когда изображение используется для метки кнопки, для свойства имени кнопки необходимо указать альтернативный текст.

 

Обязательные шаблоны элементов управления

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

Управление шаблоном или свойством шаблонов	Поддержка и значение	Примечания
IExpandCollapseProvider	См. заметки.	Если кнопка размещена в качестве дочернего элемента кнопки разделения, она может поддерживать шаблон элемента управления ExpandCollapse вместо шаблона элемента управления Invoke или Переключатель элемента управления. Шаблон элемента управления ExpandCollapse можно использовать для открытия или закрытия меню или другой вложенной структуры, связанной с элементом кнопки.
IInvokeProvider	См. заметки.	Все кнопки должны поддерживать шаблон элемента управления Invoke или шаблон переключателя, но не оба. Шаблон элемента управления Invoke должен поддерживаться, когда кнопка выполняет команду по запросу пользователя. Эта команда сопоставляется с одной операцией, например "Вырезать", "Копировать", "Вставка" или "Удалить".
IToggleProvider	См. заметки.	Все кнопки должны поддерживать шаблон элемента управления Invoke или шаблон переключателя, но не оба. Шаблон элемента управления "Переключатель" должен поддерживаться, если кнопка может циклироваться по ряду до трех состояний. Как правило, этот параметр рассматривается как переключатель включено или выключение для определенных функций.

 

Обязательные события

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

Событие автоматизации пользовательского интерфейса	Примечания
UIA_AutomationFocusChangedEventId
событие UIA_BoundingRectanglePropertyId изменено свойством.
UIA_Invoke_InvokedEventId	Если элемент управления поддерживает шаблон элемента управления Invoke, он должен поддерживать это событие.
событие UIA_IsEnabledPropertyId изменено свойством.	Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие.
событие UIA_IsOffscreenPropertyId изменено свойством.	Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие.
событие UIA_NamePropertyId изменено свойством.
UIA_StructureChangedEventId
UIA_ToggleToggleStatePropertyId событие, измененное свойством.	Если элемент управления поддерживает шаблон переключателя, он должен поддерживать это событие.

 

Связанные разделы

концептуальные

Общие сведения о типах элементов управления автоматизации пользовательского интерфейса

Обзор автоматизации пользовательского интерфейса