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

Статья
08/11/2011

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

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

В данном разделе содержатся сведения о поддержке UI Automation для типа элемента управления Table. В UI Automation тип элемента управления представляет собой набор условий, которым элемент управления должен удовлетворять, чтобы использовать свойство ControlTypeProperty. К этим условиям относятся конкретные правила для древовидной структуры UI Automation, значений свойств UI Automation и шаблонов элементов управления.

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

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

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

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

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

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

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

Таблица

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

Таблица

Text (0 или более)
Различные элементы управления (0 или более)

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

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

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

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

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

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

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

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

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

Событие UI Automation	Поддержка	Примечания
Событие, изменяемое свойством BoundingRectangleProperty.	Обязательно	Нет
Событие, изменяемое свойством IsOffscreenProperty.	Требуется	Нет
Событие, изменяемое свойством IsEnabledProperty.	Обязательно	Нет
AutomationFocusChangedEvent	Обязательно	Нет
StructureChangedEvent	Обязательно	Нет

См. также

Ссылки

Table

Основные понятия

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

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

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