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

Тип элемента управления таблицами

  • Статья

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

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

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

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

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

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

Представление элемента управления Представление содержимого
  • Стол
    • Текст (0 или 1)
    • Заголовок (0 или более)
    • Различные элементы управления (0 или более)
  • Стол
    • Текст (1 или более)
    • Различные элементы управления (0 или более)

 

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

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

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

Свойство автоматизации пользовательского интерфейса Ценность Примечания
UIA_AutomationIdPropertyId См. заметки. Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева автоматизации пользовательского интерфейса.
UIA_BoundingRectanglePropertyId См. заметки. Самый внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId См. заметки. Поддерживается, если существует ограничивающий прямоугольник. Если не каждая точка в ограничивающем прямоугольнике можно щелкнуть, а элемент выполняет специализированное тестирование попаданий, переопределите и укажите точку, доступную для щелчка.
UIA_ControlTypePropertyId таблицы
UIA_DescribedByPropertyId См. заметки. Если таблица аннотирована другим элементом пользовательского интерфейса (например, текстовым элементом, который содержит описание таблицы), свойство DescriptionBy должно предоставить ссылку на элемент автоматизации элемента управления текстом.
UIA_HelpTextPropertyId См. заметки. Дополнительные сведения о назначении таблицы следует предоставлять через это свойство, если оно недостаточно объяснено свойством UIA_NamePropertyId.
UIA_IsContentElementPropertyId ИСТИННЫЙ Элемент управления таблицами всегда должен отображаться в представлении содержимого дерева автоматизации пользовательского интерфейса.
UIA_IsControlElementPropertyId ИСТИННЫЙ Элемент управления таблицами всегда должен отображаться в представлении элемента управления дерева автоматизации пользовательского интерфейса.
UIA_IsKeyboardFocusablePropertyId См. заметки. Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство.
UIA_LabeledByPropertyId См. заметки. Если имеется статическое текстовое метка, это свойство должно предоставлять ссылку на элемент автоматизации элемента управления.
UIA_LocalizedControlTypePropertyId См. заметки. Локализованная строка, соответствующая типу элемента управления Table. Значение по умолчанию — table для en-US или английского языка (США).
UIA_NamePropertyId См. заметки. Элемент управления таблицей обычно получает значение для его имени из статической текстовой метки. Если нет статической текстовой метки, элемент должен назначить свойство Name, которое всегда должно быть доступно для объяснения цели таблицы.

 

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

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

Шаблон элемента управления Поддержка Примечания
IGridProvider Обязательно Так как элемент управления таблицами содержит элементы, представленные в сетке, он всегда поддерживает шаблон Grid.
IGridItemProvider Обязательный для дочерних объектов Внутренние объекты таблицы должны поддерживать gridItem и шаблоны элементов управления TableIte m. Сама таблица не должна поддерживать шаблон элемента управления GridItem или TableItem, если таблица не входит в другую таблицу.
ITableProvider Обязательно Элемент управления таблицами всегда может содержать заголовки, связанные с содержимым.
ITableItemProvider Обязательный для дочерних объектов Внутренние объекты таблицы должны поддерживать gridItem и шаблоны элементов управления TableIte m. Сама таблица не должна поддерживать шаблоны элементов управления GridItem или TableItem, если таблица не входит в другую таблицу.

 

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

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

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

 

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

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

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