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

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

В этом разделе содержатся сведения о поддержке моделью UI Automation элемента управления типа Window. В UI Automation тип элемента управления представляет собой набор условий, которым элемент управления должен удовлетворять, чтобы использовать свойство ControlTypeProperty. К этим условиям относятся конкретные правила для древовидной структуры UI Automation, значений свойств UI Automation и шаблонов элементов управления.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также

Ссылки

Window

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

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

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