Атрибуты текста модель автоматизации пользовательского интерфейса
В этом разделе описывается, как microsoft модель автоматизации пользовательского интерфейса предоставляет свойства формата и стиля (текстовые атрибуты) текстового содержимого, а также список поддерживаемых атрибутов текста.
поставщики модель автоматизации пользовательского интерфейса предоставляют текстовые атрибуты с помощью методов GetAttributeValue и FindAttribute шаблона элемента управления TextRange. Клиентские приложения используют метод IUIAutomationTextRange::GetAttributeValue для получения значения определенного атрибута текста для текстового диапазона. Клиенты могут использовать метод IUIAutomationTextRange::FindAttribute для поиска текста в текстовом диапазоне с определенным атрибутом. При обнаружении соответствующего текста метод создает новый текстовый диапазон, содержащий соответствующий текст.
Атрибуты текста в следующем списке поддерживаются шаблоном элемента управления TextRange . Имена атрибутов являются производными от модель автоматизации пользовательского интерфейса текстовых идентификаторов атрибутов. Например, атрибут AnimationStyle определяется клиентами как UIA_AnimationStyleAttributeId (определяется в Uiautomationclient.h), а поставщики — как Text_AnimationStyle_Attribute_GUID (определяется в Uiautomationcoreapi.h). Дополнительные сведения о каждом поддерживаемом текстовом атрибуте см. в разделе Идентификаторы атрибутов текста.
Примечание
Некоторые из перечисленных атрибутов поддерживаются начиная с Windows 8. Заметки о поддержке версий см. в разделе Идентификаторы атрибутов текста .
Этот раздел состоит из следующих подразделов.
- Атрибуты примечаний
- Атрибуты шрифтов
- Атрибуты языка
- Атрибут ссылки
- Атрибуты полей страницы
- Атрибуты выравнивания текста
- Атрибуты цвета текста
- Атрибуты оформления текста
- Атрибуты стиля текста
- Атрибуты взаимодействия и выделения
- Связанные темы
Атрибуты примечаний
Объекты и типы заметок доступны через следующие атрибуты.
| attribute | Идентификатор |
|---|---|
| AnnotationObjects | UIA_AnnotationObjectsAttributeId |
| Типы заметок | UIA_AnnotationTypesAttributeId |
Атрибуты шрифтов
Имя, размер и вес шрифта доступны через следующие атрибуты.
| attribute | Идентификатор |
|---|---|
| FontName | UIA_FontNameAttributeId |
| FontSize | UIA_FontSizeAttributeId |
| FontWeight | UIA_FontWeightAttributeId |
Атрибуты языка
Сведения о языке текста доступны через следующие атрибуты.
| attribute | Идентификатор |
|---|---|
| Язык и региональные параметры | UIA_CultureAttributeId |
| TextFlowDirections | UIA_TextFlowDirectionsAttributeId |
Атрибут ссылки
Следующий атрибут предоставляет текстовый диапазон, который является целевым объектом ссылки в документе.
| attribute | Идентификатор |
|---|---|
| Ссылка | UIA_LinkAttributeId |
Атрибуты полей страницы
Ограничивающие прямоугольники текстового диапазона не предоставляют координаты текста на странице. Однако поставщик может предоставлять сведения о полях страницы, используя следующие текстовые атрибуты.
| attribute | Идентификатор |
|---|---|
| MarginBottom | UIA_MarginBottomAttributeId |
| MarginLeading | UIA_MarginLeadingAttributeId |
| MarginTop | UIA_MarginTopAttributeId |
| MarginTrailing | UIA_MarginTrailingAttributeId |
Атрибуты выравнивания текста
Сведения о выравнивании текста, такие как отступ, параметры табуляции и горизонтальное выравнивание, доступны через следующие атрибуты.
| attribute | Идентификатор |
|---|---|
| HorizontalTextAlignment | UIA_HorizontalTextAlignmentAttributeId |
| IndentationFirstLine | UIA_IndentationFirstLineAttributeId |
| ОтступыLeading | UIA_IndentationLeadingAttributeId |
| IndentationTrailing | UIA_IndentationTrailingAttributeId |
| Вкладки | UIA_TabsAttributeId |
Атрибуты цвета текста
Цвета текста переднего плана и фона доступны через следующие текстовые атрибуты. Оба цвета указываются как тип данных COLORREF .
| attribute | Идентификатор |
|---|---|
| BackgroundColor | UIA_BackgroundColorAttributeId |
| ForegroundColor | UIA_ForegroundColorAttributeId |
Атрибуты оформления текста
Оформление текста включает такие области, как маркеры, подчеркивание и анимация. Если текст содержит маркеры или числа в начале, символ или текст, используемый для маркера или числа, должен быть включен в текстовый поток, если применимо.
Сведения о оформлении текста можно получить с помощью следующих атрибутов.
| attribute | Идентификатор |
|---|---|
| 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 |
Атрибуты стиля текста
Сведения о стилях текста доступны в следующих атрибутах.
| attribute | Идентификатор |
|---|---|
| CapStyle | UIA_CapStyleAttributeId |
| IsHidden | UIA_IsHiddenAttributeId |
| IsItalic | UIA_IsItalicAttributeId |
| IsReadOnly | UIA_IsReadOnlyAttributeId |
| IsSuperscript | UIA_IsSuperscriptAttributeId |
| IsSubscript | UIA_IsSubscriptAttributeId |
Атрибуты взаимодействия и выделения
Сведения о текущем выделении текста в диапазоне и состоянии фокуса доступны с помощью следующих атрибутов.
| attribute | Идентификатор |
|---|---|
| Isactive | UIA_IsActiveAttributeId |
| SelectionActiveEnd | UIA_SelectionActiveEndAttributeId |
| CaretPosition | UIA_CaretPositionAttributeId |
| CaretBidiMode | UIA_CaretBidiModeAttributeId |
Связанные темы
-
Основные понятия
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по