Тип элемента управления "Таблица"
В этом разделе содержатся сведения о поддержке microsoft модель автоматизации пользовательского интерфейса для типа элемента управления "Таблица".
Элементы управления таблицами содержат строки и столбцы текста и, при необходимости, заголовки строк и столбцов.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса древовидной структуры, свойств, шаблонов элементов управления и событий для типа элемента управления Таблица. Требования к модель автоматизации пользовательского интерфейса применяются ко всем элементам управления таблицами, где платформа пользовательского интерфейса интегрируется модель автоматизации пользовательского интерфейса поддержки типов элементов управления и шаблонов элементов управления.
В этом разделе содержатся следующие подразделы.
- Типичная древовидная структура
- Релевантные свойства
- Обязательные шаблоны элементов управления
- Обязательные события
- Связанные темы
Типичная древовидная структура
В следующей таблице представлен типичный элемент управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, которое относится к элементам управления таблицами и описывает, что может содержаться в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в разделе Общие сведения о дереве модель автоматизации пользовательского интерфейса.
| Представление элемента управления | Представление содержимого |
|---|---|
|
|
Если элемент управления таблицами содержит заголовки строк или столбцов, они должны быть представлены в представлении элемента управления дерева модель автоматизации пользовательского интерфейса. Представлению содержимого не нужно предоставлять эти сведения, так как доступ к ним можно получить с помощью IUIAutomationTablePattern.
Релевантные свойства
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которых особенно важно для элементов управления таблицами. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе Извлечение свойств из элементов модель автоматизации пользовательского интерфейса.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания |
|---|---|---|
| UIA_AutomationIdPropertyId | См. примечания. | Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева модель автоматизации пользовательского интерфейса. |
| UIA_BoundingRectanglePropertyId | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| UIA_ClickablePointPropertyId | См. примечания. | Поддерживается при наличии ограничивающего прямоугольника. Если не каждая точка в ограничивающем прямоугольнике доступна для щелчка, а элемент выполняет специализированное тестирование нажатия, переопределите и укажите точку, доступную для щелчка. |
| UIA_ControlTypePropertyId | Таблица | |
| UIA_DescribedByPropertyId | См. примечания. | Если у таблицы имеется заметка, предоставляемая другим элементом пользовательского интерфейса (например, текстовым элементом, содержащим описание таблицы), свойство DescribedBy должно предоставлять ссылку на элемент автоматизации элемента управления "Текст". |
| UIA_HelpTextPropertyId | См. примечания. | Дополнительные сведения о назначении таблицы следует предоставлять через это свойство, если оно недостаточно объяснено свойством UIA_NamePropertyId . |
| UIA_IsContentElementPropertyId | TRUE | Элемент управления таблицами всегда должен отображаться в представлении содержимого дерева модель автоматизации пользовательского интерфейса. |
| UIA_IsControlElementPropertyId | TRUE | Элемент управления таблицами всегда должен отображаться в представлении элемента управления дерева модель автоматизации пользовательского интерфейса. |
| UIA_IsKeyboardFocusablePropertyId | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| UIA_LabeledByPropertyId | См. примечания. | Если статическая текстовая метка присутствует, это свойство должно предоставлять ссылку на элемент автоматизации элемента управления. |
| UIA_LocalizedControlTypePropertyId | См. примечания. | Локализованная строка, соответствующая типу элемента управления Таблица . Значение по умолчанию — table для en-US или english (США). |
| UIA_NamePropertyId | См. примечания. | Элемент управления таблицами обычно получает значение для своего имени из статической текстовой метки. Если статическая текстовая метка отсутствует, элементу необходимо назначить свойство Name, которое всегда должно быть доступно для объяснения назначения таблицы. |
Обязательные шаблоны элементов управления
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления таблицами. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления | Поддержка | Примечания |
|---|---|---|
| IGridProvider | Обязательно | Поскольку элемент управления "Таблица" содержит элементы, представленные в сетке, он всегда поддерживает шаблон элемента управления Сетка . |
| IGridItemProvider | Требуется для дочерних объектов | Внутренние объекты таблицы должны поддерживать шаблоны элементов управления GridItem и TableItem . Сама таблица не должна поддерживать шаблон элемента управления GridItem или TableItem, если таблица не является частью другой таблицы. |
| ITableProvider | Обязательно | Элемент управления "Таблица" всегда может иметь заголовки, связанные с содержимым. |
| ITableItemProvider | Требуется для дочерних объектов | Внутренние объекты таблицы должны поддерживать шаблоны элементов управления GridItem и TableItem . Сама таблица не обязательно должна поддерживать шаблоны элементов управления GridItem или TableItem, если она не является частью другой таблицы. |
Обязательные события
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, для поддержки которых требуются элементы управления таблицами. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| Событие модель автоматизации пользовательского интерфейса | Примечания |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId событие изменения свойства. | |
| UIA_IsEnabledPropertyId событие изменения свойства. | Если элемент управления поддерживает свойство IsEnabled , он должен поддерживать это событие. |
| UIA_IsOffscreenPropertyId событие изменения свойства. | Если элемент управления поддерживает свойство IsOffscreen , он должен поддерживать это событие. |
| UIA_StructureChangedEventId |
Связанные темы
-
Основные понятия
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса
-
Общие сведения о модели автоматизации пользовательского интерфейса