Поддержка модели автоматизации пользовательского интерфейса для типа элемента управления Window
Примечание.
Эта документация предназначена для разработчиков .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, имеющий отношение к тому, что пользователь будет воспринимать как семантический идентификатор для этого элемента. |
Необходимые шаблоны элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться элементами управления окнами. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления | Поддержка | Примечания. |
|---|---|---|
| IDockProvider | Условный | Должен поддерживаться, если окно может быть закреплено. |
| ITransformProvider | Обязательное поле | Разрешает перемещать окно, изменять его размер и поворачивать его на экране. |
| IWindowProvider | Обязательное поле | Включает специальные операции для окна. |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления окнами. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| AsyncContentLoadedEvent | Обязательное поле | нет |
| AutomationFocusChangedEvent | Обязательное поле | нет |
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| LayoutInvalidatedEvent | Обязательное поле | нет |
| Событие изменения свойстваNameProperty | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |
| Событие изменения свойстваHorizontallyScrollableProperty | Зависит | нет |
| Событие изменения свойстваHorizontalScrollPercentProperty | Зависит | нет |
| Событие изменения свойстваHorizontalViewSizeProperty | Зависит | нет |
| Событие изменения свойстваVerticalScrollPercentProperty | Зависит | нет |
| Событие изменения свойстваVerticallyScrollableProperty | Зависит | нет |
| Событие изменения свойстваVerticalViewSizeProperty | Зависит | нет |
| WindowClosedEvent | Обязательное поле | нет |
| WindowOpenedEvent | Обязательное поле | нет |
| Событие изменения свойстваWindowVisualStateProperty | Зависит | нет |