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

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

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

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

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

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

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

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

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

 

Релевантные свойства

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

Свойство модели автоматизации пользовательского интерфейса	Значение	Примечания
UIA_AutomationIdPropertyId	См. примечания.	Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева модель автоматизации пользовательского интерфейса.
UIA_BoundingRectanglePropertyId	См. примечания.	Внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId	См. примечания.	Элемент управления окном должен иметь доступную для щелчка точку, которая приводит к выделению или отмене выбора окна.
UIA_ControlTypePropertyId	Окно	Это значение одинаково для всех инфраструктур пользовательского интерфейса.
UIA_IsContentElementPropertyId	TRUE	Элемент управления окном всегда включается в представление содержимого дерева модель автоматизации пользовательского интерфейса.
UIA_IsControlElementPropertyId	TRUE	Элемент управления окном всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса.
UIA_IsKeyboardFocusablePropertyId	См. примечания.	Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство.
UIA_LabeledByPropertyId	NULL	Элементы управления окном не имеют статической метки окна.
UIA_LocalizedControlTypePropertyId	См. примечания.	Локализованная строка, соответствующая типу элемента управления Window . Значение по умолчанию — window для en-US или english (США).
UIA_NamePropertyId	См. примечания.	Элемент управления окном всегда содержит основной элемент окна, связанный с тем, что пользователь будет связывать как наиболее семантический идентификатор элемента.

 

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

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

Шаблон элемента управления/свойство шаблона	Поддержка/значение	Примечания
IDockProvider	Условная логика	Шаблон элемента управления Dock должен поддерживаться, если окно можно закрепить.
ITransformProvider	Обязательно	Шаблон элемента управления Преобразование позволяет перемещать, изменять размер или поворачивать окно на экране. (Не применяется к приложениям Магазина Windows.)
IWindowProvider	Обязательно	Шаблон элемента управления "Окно" позволяет выполнять определенные операции для окна.

 

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

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

Событие модель автоматизации пользовательского интерфейса	Примечания
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 , это событие должно поддерживаться.

 

Связанные темы

Основные понятия

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

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