Атрибуты текста службы автоматизации пользовательского интерфейса
В этом разделе описывается, как служба автоматизации пользовательского интерфейса Майкрософт предоставляет свойства формата и стиля (текстовые атрибуты) текстового содержимого и предоставляет список поддерживаемых текстовых атрибутов.
Поставщики службы автоматизации пользовательского интерфейса предоставляют текстовые атрибуты с помощью GetAttributeValue и методов FindAttribute шаблона элемента управления TextRange. Клиентские приложения используют метод IUIAutomationTextRange::GetAttributeValue для получения значения определенного текстового атрибута для диапазона текста. Клиенты могут использовать метод IUIAutomationTextRange::FindAttribute для поиска текстового диапазона для текста с определенным атрибутом. При обнаружении соответствующего текста метод создает новый текстовый диапазон, содержащий соответствующий текст.
Текстовые атрибуты в следующем списке поддерживаются шаблоном элемента управления TextRange. Имена атрибутов являются производными от идентификаторов текстовых атрибутов службы автоматизации пользовательского интерфейса. Например, атрибут AnimationStyle определяется клиентами как UIA_AnimationStyleAttributeId (определено в Uiautomationclient.h) и поставщиками как Text_AnimationStyle_Attribute_GUID (определено в Uiautomationcoreapi.h). Дополнительные сведения о каждом поддерживаемом текстовом атрибуте см. в идентификаторов текстовых атрибутов.
Заметка
Некоторые перечисленные атрибуты поддерживаются начиная с Windows 8. Сведения о поддержке версий см. в идентификаторов текстовых атрибутов.
В этом разделе содержатся следующие разделы:
- атрибутов заметки
- атрибуты шрифта
- атрибутов языка
- атрибута link
- атрибуты поля страницы
- атрибуты выравнивания текста
- атрибуты цвета текста
- Атрибуты оформления текста
- атрибуты стиля текста
- Атрибуты взаимодействия и выделения
- связанные разделы
Атрибуты заметки
Объекты заметки и типы заметок доступны с помощью следующих атрибутов.
| Атрибут | Идентификатор |
|---|---|
| AnnotationObjects | UIA_AnnotationObjectsAttributeId |
| AnnotationTypes | UIA_AnnotationTypesAttributeId |
Атрибуты шрифта
Имя, размер и вес шрифта доступны с помощью следующих атрибутов.
| Атрибут | Идентификатор |
|---|---|
| FontName | UIA_FontNameAttributeId |
| FontSize | UIA_FontSizeAttributeId |
| fontWeight | UIA_FontWeightAttributeId |
Атрибуты языка
Сведения о языке текста доступны с помощью следующих атрибутов.
| Атрибут | Идентификатор |
|---|---|
| культуры | UIA_CultureAttributeId |
| TextFlowDirections | UIA_TextFlowDirectionsAttributeId |
Атрибут ссылки
Следующий атрибут предоставляет текстовый диапазон, предназначенный для ссылки в документе.
| Атрибут | Идентификатор |
|---|---|
| link | UIA_LinkAttributeId |
Атрибуты поля страницы
Ограничивающие прямоугольники текстового диапазона не предоставляют координаты текста на странице. Однако поставщик может предоставлять сведения о полях страницы с помощью следующих текстовых атрибутов.
| Атрибут | Идентификатор |
|---|---|
| MarginBottom | UIA_MarginBottomAttributeId |
| MarginLeading | UIA_MarginLeadingAttributeId |
| MarginTop | UIA_MarginTopAttributeId |
| MarginTrailing | UIA_MarginTrailingAttributeId |
Атрибуты выравнивания текста
Сведения о выравнивании текста, таких как отступ, параметры табуляции и горизонтальное выравнивание, доступны с помощью следующих атрибутов.
| Атрибут | Идентификатор |
|---|---|
| HorizontalTextAlignment | UIA_HorizontalTextAlignmentAttributeId |
| IndentationFirstLine | UIA_IndentationFirstLineAttributeId |
| IndentationLeading | UIA_IndentationLeadingAttributeId |
| IndentationTrailing | UIA_IndentationTrailingAttributeId |
| вкладки | UIA_TabsAttributeId |
Атрибуты цвета текста
Цвета переднего плана и фона доступны с помощью следующих текстовых атрибутов. Оба цвета указываются как тип данных COLORREF.
| Атрибут | Идентификатор |
|---|---|
| BackgroundColor | UIA_BackgroundColorAttributeId |
| ForegroundColor | UIA_ForegroundColorAttributeId |
Атрибуты оформления текста
Украшения текста включают такие области, как маркеры, подчеркивание и анимация. Если текст включает в себя ведущие маркеры или цифры, символ или текст, используемый для маркера или номера, должен быть включен в текстовый поток, если это применимо.
Сведения о украшении текста доступны с помощью следующих атрибутов.
| Атрибут | Идентификатор |
|---|---|
| AnimationStyle | UIA_AnimationStyleAttributeId |
| BulletStyle | UIA_BulletStyleAttributeId |
| OutlineStyles | UIA_OutlineStylesAttributeId |
| OverlineColor | UIA_OverlineColorAttributeId |
| OverlineStyle | UIA_OverlineStyleAttributeId |
| StrikethroughColor | UIA_StrikethroughColorAttributeId |
| StrikethroughStyle | UIA_StrikethroughStyleAttributeId |
| Подчеркивание | UIA_UnderlineColorAttributeId |
| Подчеркивание | UIA_UnderlineStyleAttributeId |
Атрибуты стиля текста
Сведения о стилях текста доступны, хотя и следующие атрибуты.
| Атрибут | Идентификатор |
|---|---|
| CapStyle | UIA_CapStyleAttributeId |
| IsHidden | UIA_IsHiddenAttributeId |
| IsItalic | UIA_IsItalicAttributeId |
| IsReadOnly | UIA_IsReadOnlyAttributeId |
| IsSuperscript | UIA_IsSuperscriptAttributeId |
| IsSubscript | UIA_IsSubscriptAttributeId |
Атрибуты взаимодействия и выделения
Сведения о текущем выделении текста в диапазоне и состоянии фокуса доступны, хотя и следующие атрибуты.
| Атрибут | Идентификатор |
|---|---|
| IsActive | UIA_IsActiveAttributeId |
| SelectionActiveEnd | UIA_SelectionActiveEndAttributeId |
| CaretPosition | UIA_CaretPositionAttributeId |
| CaretBidiMode | UIA_CaretBidiModeAttributeId |
Связанные разделы
-
концептуальные
-
о шаблонах элементов управления автоматизации пользовательского интерфейса и textRange