Поддержка автоматизации пользовательского интерфейса для элемента управления Pane
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе содержатся сведения о поддержке модель автоматизации пользовательского интерфейса для типа элемента управления "Панель". В модель автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые элемент управления должен соответствовать для использования ControlTypeProperty свойства. Условия включают конкретные рекомендации по структуре дерева модель автоматизации пользовательского интерфейса, модель автоматизации пользовательского интерфейса значения свойств и шаблоны элементов управления.
Тип элемента управления Pane используется для представления объекта в рамке или в окне документа. Пользователи могут выполнять навигацию по элементам управления "Панель" и по содержимому текущей панели, но не могут переходить между элементами в разных панелях. Таким образом, элемент управления "Панель" представляют уровень группирования ниже, чем окна или документы, но выше, чем отдельные элементы управления. Пользователь переходит между панелями, нажимая клавишу TAB, F6 или CTRL+TAB, в зависимости от контекста. Типу элемента управления Pane не требуется специальная навигация с помощью клавиатуры.
В следующих разделах определяется необходимая модель автоматизации пользовательского интерфейса структура дерева, свойства, шаблоны элементов управления и события для типа элемента управления "Область". Требования модель автоматизации пользовательского интерфейса применяются ко всем элементам управления списками, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.
Требуемая древовидная структура модели автоматизации пользовательского интерфейса
В следующей таблице представлено представление элемента управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления панели, и описывает, что можно содержать в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в модель автоматизации пользовательского интерфейса обзоре дерева.
| Представление элемента управления | Представление содержимого |
|---|---|
| навигации | навигации |
Требуемые свойства модели автоматизации пользовательского интерфейса
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которых особенно важно для элементов управления панелью. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе модель автоматизации пользовательского интерфейса Свойства для клиентов.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания. |
|---|---|---|
| AutomationIdProperty | См. примечания. | Значение этого свойства должно быть уникальным среди всех элементов управления в приложении. |
| BoundingRectangleProperty | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| IsKeyboardFocusableProperty | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| NameProperty | См. примечания. | Значение этого свойства всегда должно быть четким, кратким и понятным заголовком. |
| ClickablePointProperty | См. примечания. | Это свойство предоставляет активную точку элемента управления "Панель", при щелчке в которой эта панель получает фокус. |
| LabeledByProperty | См. примечания. | Элементы управления "Панель" обычно не имеют статических меток. Если метка со статическим текстом присутствует, она должна предоставляться через это свойство. |
| ControlTypeProperty | навигации | Это значение является одинаковым для всех инфраструктур пользовательского интерфейса. |
| LocalizedControlTypeProperty | "панель" | Локализованная строка, соответствующая типу элемента управления Pane. |
| IsContentElementProperty | Истина | Элементы управления панелью всегда включаются в представление содержимого дерева модель автоматизации пользовательского интерфейса. |
| IsControlElementProperty | Истина | Элементы управления панели всегда включаются в представление элемента управления дерева модель автоматизации пользовательского интерфейса. |
| HelpTextProperty | "" | Текст справки для элементов управления "Панель" должен объяснять назначение этой рамки и ее связь с другими рамками. Описание необходимо, если назначение и взаимосвязь рамок не ясны из значения свойства NameProperty. " |
| AccessKeyProperty | См. примечания. | Если определенное сочетание клавиш переводит фокус в конкретную панель, сведения об этом должны предоставляться через данное свойство. |
Необходимые шаблоны элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления панелью. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления | Поддержка | Примечания. |
|---|---|---|
| ITransformProvider | Зависит | Реализуйте этот шаблон элемента управления, если элемент управления "Панель" можно перемещать, изменять его размер или поворачивать на экране. |
| IWindowProvider | Никогда | Если необходимо реализовать этот шаблон элемента управления, элемент управления должен быть основан на типе Window . |
| IDockProvider | Зависит | Реализуйте этот шаблон элемента управления, если панель управления можно закреплять. |
| IScrollProvider | Зависит | Реализуйте этот шаблон элемента управления, если панель управления можно прокручивать. |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления панелью. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка/значение | Примечания. |
|---|---|---|
| WindowClosedEvent | Никогда | нет |
| WindowOpenedEvent | Никогда | нет |
| AsyncContentLoadedEvent | Обязательное поле | нет |
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| Событие изменения свойстваHorizontallyScrollableProperty | Зависит | нет |
| Событие изменения свойстваHorizontalScrollPercentProperty | Зависит | нет |
| Событие изменения свойстваHorizontalViewSizeProperty | Зависит | нет |
| Событие изменения свойстваVerticalScrollPercentProperty | Зависит | нет |
| Событие изменения свойстваVerticallyScrollableProperty | Зависит | нет |
| Событие изменения свойстваVerticalViewSizeProperty | Зависит | нет |
| Событие изменения свойстваWindowVisualStateProperty | Никогда | нет |
| AutomationFocusChangedEvent | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |
Пример типа элемента управления Pane
На следующем рисунке показан элемент управления, реализующий тип элемента управления Pane.
| дерево модель автоматизации пользовательского интерфейса — представление элемента управления | дерево модель автоматизации пользовательского интерфейса — представление содержимого |
|---|---|
|
-Панели - Дерево (шаблон прокрутки) - TreeItem - ... Панели -Редактировать - (Шаблон прокрутки) |