Тип элемента управления "Окно"
В этом разделе содержатся сведения о поддержке службы автоматизации пользовательского интерфейса Майкрософт для типа элемента управления window.
Элемент управления окном состоит из рамки окна, которая содержит дочерние объекты, такие как строка заголовка, клиент и другие объекты.
В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления Window. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления окна, где платформа и платформа пользовательского интерфейса интегрирует поддержку автоматизации пользовательского интерфейса для типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие разделы.
- типичная структура дерева
- соответствующие свойства
- обязательные шаблоны элементов управления
- обязательные события
- связанные разделы
Типичная структура дерева
В следующей таблице представлено типичное представление элемента управления и содержимого дерева автоматизации пользовательского интерфейса, относящегося к элементам управления окнами и описывающее, что можно содержать в каждом представлении. Дополнительные сведения о дереве автоматизации пользовательского интерфейса см. в обзоре дерева автоматизации пользовательского интерфейса.
| Представление элемента управления | Представление содержимого |
|---|---|
|
|
Соответствующие свойства
В следующей таблице перечислены свойства автоматизации пользовательского интерфейса, значения или определения которых особенно важны для элементов управления окнами. Дополнительные сведения о свойствах автоматизации пользовательского интерфейса см. в получения свойств из элементов автоматизации пользовательского интерфейса.
| Свойство автоматизации пользовательского интерфейса | Ценность | Примечания |
|---|---|---|
| UIA_AutomationIdPropertyId | См. заметки. | Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева автоматизации пользовательского интерфейса. |
| UIA_BoundingRectanglePropertyId | См. заметки. | Самый внешний прямоугольник, содержащий весь элемент управления. |
| UIA_ClickablePointPropertyId | См. заметки. | Элемент управления окном должен иметь точку щелчка, которая приводит к тому, что окно будет выбрано или не выбрано. |
| UIA_ControlTypePropertyId | окна | Это значение одинаково для всех платформ пользовательского интерфейса. |
| UIA_IsContentElementPropertyId | ИСТИННЫЙ | Элемент управления окном всегда включается в представление содержимого дерева автоматизации пользовательского интерфейса. |
| UIA_IsControlElementPropertyId | ИСТИННЫЙ | Элемент управления окном всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса. |
| UIA_IsKeyboardFocusablePropertyId | См. заметки. | Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство. |
| UIA_LabeledByPropertyId | НЕДЕЙСТВИТЕЛЬНЫЙ | Элементы управления окнами не имеют метки статического окна. |
| UIA_LocalizedControlTypePropertyId | См. заметки. | Локализованная строка, соответствующая типу элемента управления Window. Значением по умолчанию является окно для en-US или английского языка (США). |
| UIA_NamePropertyId | См. заметки. | Элемент управления окном всегда содержит основной элемент окна, связанный с тем, что пользователь будет связывать в качестве наиболее семантического идентификатора элемента. |
Обязательные шаблоны элементов управления
В следующей таблице перечислены шаблоны элементов управления автоматизации пользовательского интерфейса, которые должны поддерживаться элементами управления окнами. Дополнительные сведения о шаблонах элементов управления см. в шаблонах элементов управления автоматизации пользовательского интерфейса.
| Управление шаблоном или свойством шаблонов | Поддержка и значение | Примечания |
|---|---|---|
| IDockProvider | Условный | Шаблон элемента управления док-станции должен поддерживаться, если окно может быть закреплено. |
| ITransformProvider | Обязательно | Шаблон элемента управления преобразования позволяет перемещать, изменять размер окна или поворачиваться на экране. (Не применяется к приложениям Магазина Windows.) |
| IWindowProvider | Обязательно | Шаблон окна включает определенные операции для окна. |
Обязательные события
В следующей таблице перечислены события автоматизации пользовательского интерфейса, необходимые для поддержки элементов управления Window. Дополнительные сведения о событиях см. в обзоре событий автоматизации пользовательского интерфейса.
| Событие автоматизации пользовательского интерфейса | Примечания |
|---|---|
| UIA_AsyncContentLoadedEventId | |
| UIA_AutomationFocusChangedEventId | |
| событие UIA_BoundingRectanglePropertyId изменено свойством. | |
| событие UIA_IsEnabledPropertyId изменено свойством. | Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие. |
| событие UIA_IsOffscreenPropertyId изменено свойством. | Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие. |
| UIA_LayoutInvalidatedEventId | |
| событие UIA_NamePropertyId изменено свойством. | |
| событие UIA_ScrollHorizontallyScrollablePropertyId изменено свойством. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| событие UIA_ScrollHorizontalScrollPercentPropertyId изменено свойством. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| UIA_ScrollHorizontalViewSizePropertyId событие, измененное свойством. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| событие UIA_ScrollVerticallyScrollablePropertyId изменено свойством. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| событие UIA_ScrollVerticalScrollPercentPropertyId изменено свойством. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| UIA_ScrollVerticalViewSizePropertyId событие изменения свойства. | Если элемент управления поддерживает шаблон элемента управления Scroll, он должен поддерживать это событие. |
| UIA_StructureChangedEventId | |
| UIA_Window_WindowClosedEventId | |
| UIA_Window_WindowOpenedEventId | |
| событие UIA_WindowWindowVisualStatePropertyId изменено свойством. | Если элемент управления поддерживает свойство WindowVisualState шаблона элемента управления Window, это событие должно поддерживаться. |
Связанные разделы
-
концептуальные
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса