Поделиться через

Тип элемента управления "Группа"

  • Статья

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

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

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

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

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

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

Представление элемента управления Представление содержимого
  • Группа
    • 0 или многие элементы управления
  • Группа
    • 0 или многие элементы управления

 

Элементы управления группами обычно включают поддержку автоматизации пользовательского интерфейса для типов элементов управления, найденных ниже в поддереве, включая ListItem, TreeItemи типы элементов управления DataItem. Так как элемент управления группой является универсальным контейнером, любой тип элемента управления может находиться под элементом управления группы в дереве.

Соответствующие свойства

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

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

 

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

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

Шаблон элемента управления Поддержка Примечания
IExpandCollapseProvider Зависит Элементы управления группами, которые можно использовать для отображения или скрытия информации, должны поддерживать шаблон элемента управления ExpandCollapse.

 

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

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

Событие автоматизации пользовательского интерфейса Примечания
UIA_AutomationFocusChangedEventId
событие UIA_BoundingRectanglePropertyId изменено свойством.
UIA_ExpandCollapseExpandCollapseStatePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон управления ExpandCollapse, он должен поддерживать это событие.
событие UIA_IsEnabledPropertyId изменено свойством. Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие.
событие UIA_IsOffscreenPropertyId изменено свойством. Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие.
UIA_ToggleToggleStatePropertyId событие, измененное свойством. Если элемент управления поддерживает шаблон переключателя, он должен поддерживать это событие.
UIA_StructureChangedEventId

 

концептуальные

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

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