Share via

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

 

概念性

关于UI 自动化 Text 和 TextRange 控件模式

Text 和 TextRange 控件模式

使用基于文本的控件