Поддержка автоматизированного пользовательского интерфейса для текстовых элементов управления
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе содержатся сведения о поддержке модель автоматизации пользовательского интерфейса типа элемента управления Text. В модель автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые элемент управления должен соответствовать для использования ControlTypeProperty свойства. Условия включают конкретные рекомендации по структуре дерева модель автоматизации пользовательского интерфейса, модель автоматизации пользовательского интерфейса значения свойств и шаблоны элементов управления.
Элементы управления "Текст" являются основными элементами пользовательского интерфейса, представляющими фрагменты текста на экране.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса структура дерева, свойства, шаблоны элементов управления и события для типа элемента управления Text. Требования модель автоматизации пользовательского интерфейса применяются ко всем текстовым элементам управления, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.
Требуемая древовидная структура модели автоматизации пользовательского интерфейса
В следующей таблице представлено представление элемента управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления текстом и описывающее, что можно содержать в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в модель автоматизации пользовательского интерфейса обзоре дерева.
| Представление элемента управления | Представление содержимого |
|---|---|
| Текст | Text (если содержимое) |
Элемент управления "Текст" может использоваться один в качестве метки или статического текста в форме. Он также может содержаться в структуре следующих типов элементов управления:
ListItem
TreeItem
DataItem
Элементы управления текстом могут не находиться в представлении содержимого дерева модель автоматизации пользовательского интерфейса, так как текст часто отображается с помощью NameProperty другого элемента управления. Например текст, который используется в качестве метки элемента управления "Поле со списком", предоставляется с помощью значения NameProperty элемента управления. Поскольку элемент управления "Поле со списком" находится в представлении содержимого дерева модели автоматизации пользовательского интерфейса, здесь необязательно должен присутствовать элемент управления "Текст". Элементы управления "Текст" никогда не имеют дочерних элементов в представлении содержимого.
Требуемые свойства модели автоматизации пользовательского интерфейса
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которого особенно относится к элементам управления текстом. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе модель автоматизации пользовательского интерфейса Свойства для клиентов.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания. |
|---|---|---|
| AutomationIdProperty | См. примечания. | Значение этого свойства должно быть уникальным среди всех элементов управления в приложении. |
| BoundingRectangleProperty | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| ClickablePointProperty | См. примечания. | Поддерживается при наличии ограничивающего прямоугольника. Если не все точки внутри ограничивающего прямоугольника являются интерактивными и выполняется специализированная проверка на наличие данных, выполните переопределение и предоставьте интерактивную точку. |
| IsKeyboardFocusableProperty | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| NameProperty | См. примечания. | Элемент управления "Панель текста" всегда является текстом, который он отображает. |
| LabeledByProperty | Null |
Элементы управления "Текст" не имеют меток со статическим текстом. |
| ControlTypeProperty | Текст | Это значение является одинаковым для всех инфраструктур пользовательского интерфейса. |
| LocalizedControlTypeProperty | "text" | Локализованная строка, соответствующая типу элемента управления Text. |
| IsContentElementProperty | Зависит | Элемент управления "Текст" будет содержимым, если он содержит сведения, которые не представлены в NameProperty другого элемента управления. |
| IsControlElementProperty | Истина | Элемент управления "Текст" всегда должен быть элементом управления. |
Необходимые шаблоны элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться текстовыми элементами управления. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления | Поддержка | Примечания. |
|---|---|---|
| IValueProvider | Никогда | Текст никогда не поддерживает ValuePattern. Если текст редактируемый, то он является типом элемента управления Edit. |
| ITextProvider | Зависит | Для улучшения специальных возможностей элемент управления "Текст" может поддерживать шаблон элемента управления Text, хотя это не обязательно. Шаблон элемента управления Text целесообразно использовать, если текст имеет множество стилей и атрибутов (например, цвет, полужирным шрифт и курсив). Зависит от инфраструктуры. |
| ITableItemProvider | Зависит | Если текстовый элемент содержится в элементе управления "Таблица", это должно поддерживаться. |
| IRangeValueProvider | Зависит | Если текстовый элемент содержится в элементе управления "Таблица", это должно поддерживаться. |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, необходимые для поддержки всех текстовых элементов управления. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| TextSelectionChangedEvent | Обязательное поле | нет |
| TextChangedEvent | Обязательное поле | нет |
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| Событие изменения свойстваNameProperty | Обязательное поле | нет |
| Событие изменения свойстваValueProperty | Никогда | нет |
| AutomationFocusChangedEvent | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |