Поддержка автоматизации пользовательского интерфейса для типа элемента управления Group
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе содержатся сведения о модель автоматизации пользовательского интерфейса поддержке типа элемента управления Group. В модель автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые элемент управления должен соответствовать для использования ControlTypeProperty свойства. Условия включают конкретные рекомендации по структуре дерева модель автоматизации пользовательского интерфейса, значениям свойств модель автоматизации пользовательского интерфейса и модель автоматизации пользовательского интерфейса шаблонов элементов управления.
Элемент управления "Группа" представляет узел в иерархии. Тип элемента управления Group создает разделение в дереве модель автоматизации пользовательского интерфейса, чтобы элементы, сгруппированные вместе, имели логическое разделение в дереве модель автоматизации пользовательского интерфейса.
В следующих разделах определяется необходимая модель автоматизации пользовательского интерфейса структура дерева, свойства, шаблоны элементов управления и события для типа элемента управления Group. Требования модель автоматизации пользовательского интерфейса применяются ко всем элементам управления группами, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.
Требуемая древовидная структура модели автоматизации пользовательского интерфейса
В следующей таблице представлено представление элемента управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления группами и описывающее, что можно содержать в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в модель автоматизации пользовательского интерфейса обзоре дерева.
| Представление элемента управления | Представление содержимого |
|---|---|
| Групповой — 0 или многие элементы управления |
Групповой — 0 или многие элементы управления |
Обычно элементы управления группы имеют поддержку модель автоматизации пользовательского интерфейса типа элемента управления ListItem, модель автоматизации пользовательского интерфейса поддержку типа элемента управления TreeItem или модель автоматизации пользовательского интерфейса поддержка типов элементов управления DataItem, найденных под ними в поддереве. Так как "Группа" представляет собой универсальный контейнер, под элементом управления "Группа" в дереве может находиться любой тип элемента управления.
Требуемые свойства модели автоматизации пользовательского интерфейса
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которых особенно относится к элементам управления группами. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе модель автоматизации пользовательского интерфейса Свойства для клиентов.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания. |
|---|---|---|
| AutomationIdProperty | См. примечания. | Значение этого свойства должно быть уникальным среди всех элементов управления в приложении. |
| BoundingRectangleProperty | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| ClickablePointProperty | См. примечания. | Поддерживается при наличии ограничивающего прямоугольника. Если не все точки внутри ограничивающего прямоугольника являются интерактивными и выполняется специализированная проверка на наличие данных, выполните переопределение и предоставьте интерактивную точку. |
| IsKeyboardFocusableProperty | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| NameProperty | См. примечания. | Элемент управления "Группа" обычно получает свое имя из текста метки элемента управления. |
| LabeledByProperty | См. примечания. | Обычно элементы управления "Группа" получают метки автоматически. В таких случаях возвратите здесь значение null . При наличии статической текстовой метки для группы она должна возвращаться как значение свойства LabeledBy. |
| ControlTypeProperty | Групповой | Это значение является одинаковым для всех инфраструктур пользовательского интерфейса. |
| LocalizedControlTypeProperty | "группа" | Локализованная строка, соответствующая типу элемента управления Group. |
| IsContentElementProperty | Истина | Элемент управления группой всегда включается в представление содержимого дерева модель автоматизации пользовательского интерфейса. |
| IsControlElementProperty | Истина | Группа календарей всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса. |
Необходимые шаблоны элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться для типа элемента управления Group. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления | Поддержка | Примечания. |
|---|---|---|
| IExpandCollapseProvider | Зависит | Элементы управления "Группа", которые можно использовать для отображения или скрытия сведений, должны поддерживать шаблон Expand Collapse. |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления группами. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| Событие изменения свойстваExpandCollapseStateProperty | Зависит | нет |
| Событие изменения свойстваToggleStateProperty | Зависит | нет |
| AutomationFocusChangedEvent | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |