Тип элемента управления "Текст"

  • Статья

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

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

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

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

Типичная древовидная структура

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

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

 

Элемент управления "Текст" может использоваться один в качестве метки или статического текста в форме. Он также может содержаться в структуре одного из следующих элементов:

Элементы управления текстом могут не отображаться в представлении содержимого дерева модель автоматизации пользовательского интерфейса, так как текст часто отображается через свойство Name другого элемента управления. Например, текст, используемый для добавления метки к элементу управления "Поле со списком", предоставляется через свойство Name элемента управления. Поскольку элемент управления "Поле со списком" находится в представлении содержимого дерева модель автоматизации пользовательского интерфейса, элемент управления "Текст" не обязательно должен быть там. Текстовые элементы управления могут иметь дочерние элементы в представлении содержимого, если имеется внедренный объект, например гиперссылка.

Соответствующие свойства

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

Свойство модели автоматизации пользовательского интерфейса Значение Примечания
UIA_AutomationIdPropertyId См. примечания. Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева модель автоматизации пользовательского интерфейса.
UIA_BoundingRectanglePropertyId См. примечания. Внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId См. примечания. Поддерживается при наличии ограничивающего прямоугольника. Если не каждая точка в ограничивающем прямоугольнике доступна для щелчка, а элемент выполняет специализированную проверку нажатия, переопределите и укажите точку, доступную для щелчка.
UIA_ControlTypePropertyId Text
UIA_IsContentElementPropertyId Зависит Текстовый элемент управления является содержимым, если он содержит сведения, не предоставленные в свойстве Name другого элемента управления.
UIA_IsControlElementPropertyId TRUE Элемент управления "Текст" всегда должен быть элементом управления.
UIA_IsKeyboardFocusablePropertyId См. примечания. Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство.
UIA_LabeledByPropertyId NULL Элементы управления "Текст" не имеют меток со статическим текстом.
UIA_LocalizedControlTypePropertyId См. примечания. Локализованная строка, соответствующая типу элемента управления Текст . Значение по умолчанию — text для en-US или english (США).
UIA_NamePropertyId См. примечания. Имя текстового элемента управления может быть отображаемым в нем текстом. Однако если элемент управления также поддерживает шаблон Text и текст является обширным, не используйте полнотекстовое содержимое в качестве значения Name . Вместо этого укажите более короткое значение Name , которое является производным от других свойств элемента управления.

 

Обязательные шаблоны элементов управления

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

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

 

Обязательные события

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

Событие модель автоматизации пользовательского интерфейса Примечания
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId событие изменения свойства.
UIA_IsEnabledPropertyId событие изменения свойства. Если элемент управления поддерживает свойство IsEnabled , он должен поддерживать это событие.
UIA_IsOffscreenPropertyId событие изменения свойства. Если элемент управления поддерживает свойство IsOffscreen , он должен поддерживать это событие.
UIA_NamePropertyId событие изменения свойства.
UIA_StructureChangedEventId
UIA_Text_TextChangedEventId Если элемент управления поддерживает шаблон элемента управления Текст , он должен поддерживать это событие.

 

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

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

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