Тип элемента управления "Кнопка"
В этом разделе содержатся сведения о поддержке microsoft модель автоматизации пользовательского интерфейса для типа элемента управления Button.
Кнопка является объектом, с которым пользователь взаимодействует для выполнения действия, таким как кнопки ОК и Отменить в диалоговом окне. Кнопка является простым элементом управления, так как она сопоставляется с одной командой, которую пользователь хочет выполнить.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса древовидную структуру, свойства, шаблоны элементов управления и события для типа элемента управления Button. Требования к модель автоматизации пользовательского интерфейса применяются ко всем элементам управления "Кнопка", где платформа пользовательского интерфейса интегрируется модель автоматизации пользовательского интерфейса поддержки типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие подразделы.
- Типичная древовидная структура
- Релевантные свойства
- Обязательные шаблоны элементов управления
- Обязательные события
- Связанные темы
Типичная древовидная структура
В следующей таблице представлен типичный элемент управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления "Кнопка", и описывается, что может содержаться в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в разделе Общие сведения о дереве модель автоматизации пользовательского интерфейса.
| Представление элемента управления | Представление содержимого |
|---|---|
|
|
Релевантные свойства
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которых особенно важно для элементов управления, реализующих тип элемента управления Button (например, кнопки). Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе Извлечение свойств из элементов модель автоматизации пользовательского интерфейса.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания |
|---|---|---|
| UIA_AcceleratorKeyPropertyId | См. примечания. | Элемент управления "Кнопка" обычно поддерживает клавишу ускорителя, позволяющую конечному пользователю быстро выполнять действие, представленное кнопкой с клавиатуры. |
| UIA_AutomationIdPropertyId | См. примечания. | Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева модель автоматизации пользовательского интерфейса. |
| UIA_BoundingRectanglePropertyId | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| UIA_ClickablePointPropertyId | См. примечания. | Поддерживается при наличии ограничивающего прямоугольника. Если не каждая точка в ограничивающем прямоугольнике доступна для щелчка, а элемент выполняет специализированное тестирование нажатия, переопределите и укажите точку, доступную для щелчка. |
| UIA_ControlTypePropertyId | Button | |
| UIA_HelpTextPropertyId | См. примечания. | Текст справки должен указывать конечный результат активации кнопки. Как правило, это тот же тип информации, который представляется с помощью подсказки. |
| UIA_IsContentElementPropertyId | TRUE | Элемент управления "Кнопка" всегда должен быть содержимым. |
| UIA_IsControlElementPropertyId | TRUE | Элемент управления "Кнопка" всегда должен быть элементом управления . |
| UIA_IsKeyboardFocusablePropertyId | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| UIA_LabeledByPropertyId | Null | Элементы управления "Кнопка" помечаются автоматически по их содержимому. |
| UIA_LocalizedControlTypePropertyId | См. примечания. | Локализованная строка, соответствующая типу элемента управления Button . Значение по умолчанию — button для en-US или english (США). |
| UIA_NamePropertyId | См. примечания. | Имя элемента управления "Кнопка" — это текст, используемый для присвоения ему меток. Каждый раз, когда изображение используется для маркировки кнопки, для свойства Name кнопки необходимо указать альтернативный текст. |
Обязательные шаблоны элементов управления
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления "Кнопка". Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления/свойство шаблона | Поддержка/значение | Примечания |
|---|---|---|
| IExpandCollapseProvider | См. примечания. | Если кнопка размещается как дочерний элемент разделенной кнопки, она может поддерживать шаблон элемента управления ExpandCollapse вместо шаблона элемента управления Invoke или Toggle . Шаблон элемента управления ExpandCollapse можно использовать для открытия или закрытия меню или другой подструктуры, связанной с элементом кнопки. |
| IInvokeProvider | См. примечания. | Все кнопки должны поддерживать шаблон элемента управления Вызов или Переключение , но не оба. Шаблон элемента управления "Вызов" должен поддерживаться, когда кнопка выполняет команду по запросу пользователя. Эта команда сопоставляется с одной операцией, например операцией вырезания, копирования, вставки или удаления. |
| IToggleProvider | См. примечания. | Все кнопки должны поддерживать шаблон элемента управления Вызов или Переключение , но не оба. Шаблон элемента управления Toggle должен поддерживаться, если кнопка может циклически проходить по ряду до трех состояний. Обычно это выглядит как переключатель "Вкл./Выкл." для конкретных функций. |
Обязательные события
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые требуются для поддержки элементов управления кнопками. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| Событие модель автоматизации пользовательского интерфейса | Примечания |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId событие изменения свойства. | |
| UIA_Invoke_InvokedEventId | Если элемент управления поддерживает шаблон элемента управления Invoke , он должен поддерживать это событие. |
| UIA_IsEnabledPropertyId событие изменения свойства. | Если элемент управления поддерживает свойство IsEnabled , он должен поддерживать это событие. |
| UIA_IsOffscreenPropertyId событие изменения свойства. | Если элемент управления поддерживает свойство IsOffscreen , он должен поддерживать это событие. |
| UIA_NamePropertyId событие изменения свойства. | |
| UIA_StructureChangedEventId | |
| UIA_ToggleToggleStatePropertyId событие изменения свойства. | Если элемент управления поддерживает шаблон элемента управления Toggle , он должен поддерживать это событие. |
Связанные темы
-
Основные понятия
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса
-
Общие сведения о модели автоматизации пользовательского интерфейса