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

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

Замечание

Эта документация предназначена для разработчиков .NET Framework, которые хотят использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в разделе API автоматизации Windows: автоматизация пользовательского интерфейса.

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

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

В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления Table. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления таблицами, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.

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

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

Вид управления Просмотр содержимого
Таблица

- Заголовок (0 или 1)
- Текст (0 или 1)
— различные элементы управления (0 или более)		 Таблица

- Текст (0 или более)
— различные элементы управления (0 или более)

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

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

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

Свойство автоматизации пользовательского интерфейса Ценность Примечания.
AutomationIdProperty См. заметки. Значение этого свойства должно быть уникальным для всех элементов управления в приложении.
BoundingRectangleProperty См. заметки. Самый внешний прямоугольник, содержащий весь элемент управления.
ClickablePointProperty См. заметки. Поддерживается, если существует ограничивающий прямоугольник. Если не на каждую точку в ограничивающем прямоугольнике можно щелкнуть, и вы проводите специализированную проверку на попадание, то переопределите и укажите точку, на которую можно щелкнуть.
IsKeyboardFocusableProperty См. заметки. Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство.
NameProperty См. заметки. Элемент управления таблицей обычно получает имя из статической текстовой метки. Если нет статической текстовой метки, необходимо назначить свойство Name, которое всегда должно быть доступно для объяснения цели таблицы.
LabeledByProperty См. заметки. Если имеется статическое текстовое метка, это свойство должно предоставлять ссылку на элемент автоматизации элемента управления.
ControlTypeProperty Таблица Это значение одинаково для всех платформ пользовательского интерфейса.
LocalizedControlTypeProperty стол Локализованная строка, соответствующая типу элемента управления Table.
HelpTextProperty См. заметки. Дополнительные сведения о назначении таблицы следует предоставлять через это свойство, если оно недостаточно объяснено путем доступа к NameProperty.
IsContentElementProperty Верно Элемент управления таблицей всегда должен содержать контент.
IsControlElementProperty Верно Элемент управления таблицей всегда должен быть управляющим элементом.

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

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

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

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

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

Событие автоматизации пользовательского интерфейса Поддержка Примечания.
BoundingRectangleProperty событие изменения свойства. Обязательно Отсутствует
IsOffscreenProperty событие изменения свойства. Обязательно Отсутствует
IsEnabledProperty событие изменения свойства. Обязательно Отсутствует
AutomationFocusChangedEvent Обязательно Отсутствует
StructureChangedEvent Обязательно Отсутствует

См. также

  • Last updated on