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

Поддержка автоматизации пользовательского интерфейса для типа элемента управления окнами

Замечание

Эта документация предназначена для разработчиков .NET Framework, которые хотят использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в разделе API автоматизации Windows: автоматизация пользовательского интерфейса.

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

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

Требования к автоматизации пользовательского интерфейса в следующих разделах применяются ко всем элементам управления, реализующим тип элемента управления "Окно", будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.

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

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

Вид управления Просмотр содержимого
Окно Окно

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

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

Свойство автоматизации пользовательского интерфейса Ценность Примечания.
AutomationIdProperty См. заметки. Значение этого свойства должно быть уникальным для всех элементов управления в приложении.
BoundingRectangleProperty См. заметки. Самый внешний прямоугольник, содержащий весь элемент управления.
ClickablePointProperty См. заметки. Элемент управления окном должен иметь точку щелчка, которая приведет к тому, что окно будет выбрано или не выбрано.
ControlTypeProperty Окно Это значение одинаково для всех платформ пользовательского интерфейса.
IsContentElementProperty Верно Элемент управления окном всегда должен быть содержимым.
IsControlElementProperty Верно Элемент управления окна должен всегда оставаться элементом управления.
IsKeyboardFocusableProperty См. заметки. Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство.
LabeledByProperty null Элементы управления окнами не имеют статической метки окна.
LocalizedControlTypeProperty "окно" Локализованная строка, соответствующая типу элемента управления Window.
NameProperty См. заметки. Элемент управления окном всегда содержит главный элемент Window, который пользователь будет считать наиболее подходящим семантическим идентификатором элемента.

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

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

Шаблон элемента управления Поддержка Примечания.
IDockProvider Условный Поддержка обязательна, если окно может быть закреплено.
ITransformProvider Обязательно Позволяет перемещать, изменять размер или поворачивать окно на экране.
IWindowProvider Обязательно Включает определенные операции для окна.

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

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

Событие автоматизации пользовательского интерфейса Поддержка Примечания.
AsyncContentLoadedEvent Обязательно Отсутствует
AutomationFocusChangedEvent Обязательно Отсутствует
BoundingRectangleProperty событие изменения свойства. Обязательно Отсутствует
IsEnabledProperty событие изменения свойства. Обязательно Отсутствует
IsOffscreenProperty событие изменения свойства. Обязательно Отсутствует
LayoutInvalidatedEvent Обязательно Отсутствует
NameProperty событие изменения свойства. Обязательно Отсутствует
StructureChangedEvent Обязательно Отсутствует
HorizontallyScrollableProperty событие изменения свойства. Зависит Отсутствует
HorizontalScrollPercentProperty событие изменения свойства. Зависит Отсутствует
HorizontalViewSizeProperty событие изменения свойства. Зависит Отсутствует
VerticalScrollPercentProperty событие изменения свойства. Зависит Отсутствует
VerticallyScrollableProperty событие изменения свойства. Зависит Отсутствует
VerticalViewSizeProperty событие изменения свойства. Зависит Отсутствует
WindowClosedEvent Обязательно Отсутствует
WindowOpenedEvent Обязательно Отсутствует
WindowVisualStateProperty событие изменения свойства. Зависит Отсутствует

См. также

  • Last updated on