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

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

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

Текстовые элементы управления являются основными элементами пользовательского интерфейса, представляющими фрагмент текста на экране.

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

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

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

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

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

Представление элемента управления	Представление содержимого
Текст	Текст (если содержимое)

Текстовый элемент управления может использоваться отдельно в качестве метки или статического текста на форме. Он может также содержаться в структуре:

• ListItem

• TreeItem

• DataItem

Текстовые элементы управления могут не оказаться в представлении содержимого дерева UI Automation, поскольку текст часто отображается с использованием значения NameProperty другого элемента управления. Например текст, который использован в качестве метки элемента управления Combo Box, предоставляется через значение NameProperty элемента управления. Так как элемент управления Combo Box находится в представлении содержимого дерева модели автоматизации интерфейса пользователя, то нет необходимости размещать там текстовый элемент управления. У текстовых элементов управления всегда 0 дочерних элементов в представлении содержимого

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

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

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

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

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

Шаблон элемента управления	Поддержка	Примечания
IValueProvider	Никогда	Текст никогда не поддерживает ValuePattern. Если текст изменяемый, то он является типом элемента управления редактирования Edit.
ITextProvider	Зависит от конкретного случая	Для обеспечения специальных возможностей текст должен поддерживать шаблон элемента управления Text, но эта поддержка необязательна. Шаблон элемента управления Text полезен, если текст имеет множество атрибутов и стилей (например, выделение цветом, полужирным шрифтом или курсивом). Зависит от рабочей среды.
ITableItemProvider	Зависит от конкретного случая	Если текстовый элемент содержится в элементе управления типа таблица, то это должно поддерживаться.
IRangeValueProvider	Зависит от конкретного случая	Если текстовый элемент содержится в элементе управления типа таблица, то это должно поддерживаться.

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

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

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

См. также

Ссылки

Text

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

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

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