UI 自动化文本属性
本主题介绍 Microsoft UI 自动化如何公开格式和样式属性 (文本属性) 文本内容，并提供支持的文本属性的列表。
UI 自动化提供程序通过 TextRange 控件模式的 GetAttributeValue 和 FindAttribute 方法公开文本属性。 客户端应用程序使用 IUIAutomationTextRange：：GetAttributeValue 方法检索文本范围的特定文本属性的值。 客户端可以使用 IUIAutomationTextRange：：FindAttribute 方法在文本范围内搜索具有特定属性的文本。 如果找到任何匹配文本，该方法将创建包含匹配文本的新文本范围。
TextRange 控件模式支持以下列表中的文本属性。 属性名称派生自UI 自动化文本属性标识符。 例如， AnimationStyle 属性由客户端标识为 uiautomationclient.h) 中定义的 UIA_AnimationStyleAttributeId (，由提供程序标识为 uiautomationcoreapi.h) 中定义的 Text_AnimationStyle_Attribute_GUID (。 有关每个支持的文本属性的详细信息，请参阅 文本属性标识符。
注意
从 Windows 8 开始支持列出的某些属性。 有关版本支持的说明，请参阅 文本属性标识符 。
本主题包含以下各节：
Annotation 特性
批注对象和批注类型通过以下属性提供。
| 属性 | 标识符 |
|---|---|
| AnnotationObjects | UIA_AnnotationObjectsAttributeId |
| AnnotationTypes | UIA_AnnotationTypesAttributeId |
字体属性
可通过以下属性获取字体的名称、大小和粗细。
| 属性 | 标识符 |
|---|---|
| FontName | UIA_FontNameAttributeId |
| FontSize | UIA_FontSizeAttributeId |
| FontWeight | UIA_FontWeightAttributeId |
语言属性
可通过以下属性获取有关文本语言的信息。
| 属性 | 标识符 |
|---|---|
| 区域性 | UIA_CultureAttributeId |
| TextFlowDirections | UIA_TextFlowDirectionsAttributeId |
链接属性
以下属性提供作为文档中链接目标的文本范围。
| 属性 | 标识符 |
|---|---|
| 链接 | UIA_LinkAttributeId |
页边距属性
文本范围的边框不会公开页面中文本的坐标。 但是，提供程序可以使用以下文本属性公开页边距信息。
| 属性 | 标识符 |
|---|---|
| MarginBottom | UIA_MarginBottomAttributeId |
| MarginLeading | UIA_MarginLeadingAttributeId |
| MarginTop | UIA_MarginTopAttributeId |
| MarginTrailing | UIA_MarginTrailingAttributeId |
文本对齐特性
可通过以下属性获取有关文本对齐方式的信息，例如缩进、制表符设置和水平对齐方式。
| 属性 | 标识符 |
|---|---|
| HorizontalTextAlignment | UIA_HorizontalTextAlignmentAttributeId |
| IndentationFirstLine | UIA_IndentationFirstLineAttributeId |
| 缩进前导 | 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 |
| UnderlineColor | UIA_UnderlineColorAttributeId |
| UnderlineStyle | 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 |
相关主题