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

Шаблон элемента управления "Сетка"

  • Статья

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

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

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

Рекомендации по реализации и соглашения

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

  • Координаты сетки основаны на нулях с левой верхней левой (или правой верхней ячейкой в зависимости от языкового стандарта) с координатами (0,0).

  • Если ячейка пуста, элемент службы автоматизации пользовательского интерфейса Майкрософт по-прежнему должен быть возвращен для поддержки свойства IGridItemProvider::ContainingGrid для этой ячейки. Это возможно, если макет дочерних элементов в сетке похож на неровный массив (см. пример ниже).

    пример элемента управления сетки с пустыми координатами

  • Сетка с одним элементом по-прежнему требуется для реализации IGridProvider, если это логически считается сеткой. Число дочерних элементов в сетке является нематериальным.

  • Скрытые строки и столбцы в зависимости от реализации поставщика могут быть загружены в дерево автоматизации пользовательского интерфейса и поэтому будут отражены в свойствах IGridProvider::RowCount и ColumnCount. Если скрытые строки и столбцы еще не загружены, их не следует считать.

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

  • Используйте IUIAutomationStructureChangedEventHandler для прослушивания структурных или макетных изменений в сетке, таких как ячейки, добавленные, удаленные или объединенные.

  • Используйте IUIAutomationFocusChangedEventHandler для отслеживания обхода элементов или ячеек сетки.

Обязательные элементы для IGridProvider

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

Обязательные элементы Тип элемента Примечания
RowCount Свойство Никакой
ColumnCount Свойство Никакой
GetItem Метод Никакой

 

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

Типы элементов управления и поддерживаемые шаблоны элементов управления

шаблон элемента управления GridItem

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

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