Поддержка модели автоматизации пользовательского интерфейса для типа элемента управления Table
Примечание.
Эта документация предназначена для разработчиков .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" | Локализованная строка, соответствующая типу элемента управления Tab. |
| HelpTextProperty | См. примечания. | Дополнительные сведения о назначении таблицы должны предоставляться через это свойство, сведений из NameProperty недостаточно. |
| IsContentElementProperty | Истина | Элемент управления "Таблица" всегда должен быть содержимым. |
| IsControlElementProperty | Истина | Элемент управления "Таблица" всегда должен быть элементом управления. |
Необходимые шаблоны элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться элементами управления Table. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления | Поддержка | Примечания. |
|---|---|---|
| IGridProvider | Да | Элемент управления "Таблица" всегда поддерживает данный шаблон элемента управления, так как элементы, которые он содержит, имеют данные, представленные в виде сетки. |
| IGridItemProvider | Да (с дочерними объектами обязательно) | Внутренние объекты таблицы должны поддерживать шаблоны элементов управления GridItem и TableItem. Сама таблица не обязательно должна поддерживать шаблоны элементов управления GridItem или TableItem, если она не является частью другой таблицы. |
| ITableProvider | Да | Элемент управления "Таблица" всегда может иметь заголовки, связанные с содержимым. |
| ITableItemProvider | Да (с дочерними объектами обязательно) | Внутренние объекты таблицы должны поддерживать шаблоны элементов управления GridItem и TableItem. Сама таблица не обязательно должна поддерживать шаблоны элементов управления GridItem или TableItem, если она не является частью другой таблицы. |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления таблицами. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| AutomationFocusChangedEvent | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |