Поддержка модели автоматизации пользовательского интерфейса для типа элемента управления кнопки
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе содержатся сведения о поддержке модель автоматизации пользовательского интерфейса типа элемента управления Button. В модель автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые элемент управления должен соответствовать для использования ControlTypeProperty свойства. Условия включают конкретные рекомендации по структуре дерева модель автоматизации пользовательского интерфейса, значениям свойств модель автоматизации пользовательского интерфейса, шаблонам элементов управления и модель автоматизации пользовательского интерфейса события.
Кнопка является объектом, с которым пользователь взаимодействует для выполнения действия, таким как кнопки ОК и Отменить в диалоговом окне. Кнопка является простым элементом управления, так как она сопоставляется с одной командой, которую пользователь хочет выполнить.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса структура дерева, свойства, шаблоны элементов управления и события для типа элемента управления Button. Требования модель автоматизации пользовательского интерфейса применяются ко всем элементам управления кнопками, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.
Требуемая древовидная структура модели автоматизации пользовательского интерфейса
В следующей таблице показано представление элемента управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления кнопкой, и описывает, что можно содержать в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в модель автоматизации пользовательского интерфейса обзоре дерева.
| Представление элемента управления | Представление содержимого |
|---|---|
| Кнопка — Изображение (0 или более) - Текст (0 или более) |
Кнопка |
Требуемые свойства модели автоматизации пользовательского интерфейса
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которых особенно относится к элементам управления, реализующим тип элемента управления Button (например, элементы управления кнопкой). Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе модель автоматизации пользовательского интерфейса Свойства для клиентов.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания. |
|---|---|---|
| AcceleratorKeyProperty | См. примечания. | Элемент управления Button обычно должен поддерживать сочетание клавиш, чтобы конечный пользователь мог быстро выполнить действие, представляемое этим элементом управления, с помощью клавиатуры. |
| AutomationIdProperty | См. примечания. | Значение этого свойства должно быть уникальным среди всех элементов управления в приложении. |
| BoundingRectangleProperty | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| ClickablePointProperty | См. примечания. | Поддерживается при наличии ограничивающего прямоугольника. Если не все точки внутри ограничивающего прямоугольника являются интерактивными и выполняется специализированная проверка на наличие данных, выполните переопределение и предоставьте интерактивную точку. |
| ControlTypeProperty | Кнопка | Это значение является одинаковым для всех инфраструктур пользовательского интерфейса. |
| HelpTextProperty | См. примечания. | Текст справки может указывать, каким будет конечный результат активации кнопки. Обычно этот же тип сведений предоставляется подсказкой. |
| IsContentElementProperty | Истина | Элемент управления "Кнопка" всегда должен быть содержимым. |
| IsControlElementProperty | Истина | Элемент управления "Кнопка" всегда должен быть элементом управления. |
| IsKeyboardFocusableProperty | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| LabeledByProperty | Null |
Элементы управления "Кнопка" помечаются автоматически по их содержимому. |
| LocalizedControlTypeProperty | "кнопка" | Локализованная строка, соответствующая типу элемента управления Button. |
| NameProperty | См. примечания. | Имя элемента управления "Кнопка" — это текст, который используется в качестве его метки. Если для пометки кнопки используется изображение, необходимо предоставить альтернативный текст для кнопки в свойстве "Имя". |
Необходимые шаблоны элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления кнопками. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления | Поддержка | Примечания. |
|---|---|---|
| IInvokeProvider | См. примечания. | Все кнопки должны поддерживать шаблон элемента управления Invoke или шаблон элемента управления Toggle. Шаблон Invoke поддерживается, когда кнопка выполняет команду по запросу пользователя. Эта команда сопоставляется с одной операцией, например операцией вырезания, копирования, вставки или удаления. |
| IToggleProvider | См. примечания. | Все кнопки должны поддерживать шаблон элемента управления Invoke или шаблон элемента управления Toggle. Шаблон Toggle поддерживается, если кнопка может циклически проходить ряд состояний (до трех). Обычно это выглядит как переключатель "Вкл./Выкл." для конкретных функций. |
| IExpandCollapseProvider | См. примечания. | Если кнопка размещена как дочерний элемент разворачивающейся кнопки, то эта дочерняя кнопка может поддерживать шаблон ExpandCollapse вместо Invoke или Toggle. Шаблон ExpandCollapse может использоваться для открытия или закрытия меню или других вложенных структур, связанных с элементом управления "Кнопка". |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления кнопками. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| AutomationFocusChangedEvent | Обязательное поле | нет |
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| Событие изменения свойстваNameProperty | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |
| InvokedEvent | Зависит | Если элемент управления поддерживает шаблон элемента управления Invoke, то он должен поддерживать данное событие. |
| Событие изменения свойстваToggleStateProperty | Зависит | Если элемент управления поддерживает шаблон элемента управления Toggle, то он должен поддерживать данное событие. |