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

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

Замечание

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

В этом разделе содержатся сведения о поддержке автоматизации пользовательского интерфейса для типа элемента управления Text. В службе автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые должны соответствовать элементу ControlTypeProperty управления для использования свойства. Условия включают конкретные рекомендации по структуре дерева автоматизации пользовательского интерфейса, значениям свойств автоматизации пользовательского интерфейса и шаблонам элементов управления.

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

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

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

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

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

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

  • Элемент списка

  • TreeItem

  • DataItem

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

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

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

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

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

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

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

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

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

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

См. также

  • Last updated on