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

  • Статья

Примечание.

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

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

Шаблон элемента управления TablePattern используется для поддержки элементов управления, которые действуют как контейнеры для коллекции дочерних элементов. Дочерние элементы данного элемента должны реализовывать ITableItemProvider и быть организованы в двумерной логической системе координат, к которой можно обращаться по строкам и столбцам. Этот шаблон элемента управления является аналогом IGridProvider, с той разницей, что любой элемент управления, реализующий ITableProvider, также должен предоставлять отношение заголовка столбца и строки для каждого дочернего элемента. Примеры элементов управления, реализующие данный шаблон элемента управления, см. в разделе Control Pattern Mapping for UI Automation Clients.

Правила и соглашения реализации

При реализации шаблона элемента управления Table обратите внимание на следующие правила и соглашения.

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

  • Заголовок столбца или строки может содержаться в объекте таблицы или быть отдельным объектом заголовка, связанным с объектом таблицы.

  • Заголовки столбцов и строк могут включать и основной заголовок, и любые поддерживаемые заголовки.

Примечание.

Эта концепция становится очевидной в электронной таблице Microsoft Excel, в которой пользователь определил столбец "Имя". Теперь этот столбец имеет два заголовка: заголовок "Имя", определенный пользователем, и алфавитно-цифровое обозначение этого столбца, назначенное приложением.

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

Table with complex header items. Пример таблицы со сложными заголовками столбцов

Table with ambiguous RowOrColumnMajor property. Пример таблицы с неоднозначным свойством RowOrColumnMajor

Обязательные члены для ITableProvider

Следующие свойства и методы обязательны для реализации интерфейса ITableProvider.

Обязательные члены Тип члена Примечания.
RowOrColumnMajor Свойство нет
GetColumnHeaders Способ нет
GetRowHeaders Способ нет

Этот шаблон элемента управления не имеет связанных событий.

Исключения

Этот шаблон элемента управления не имеет связанных исключений.

См. также