文本属性标识符

本主题介绍用于标识 Microsoft UI 自动化文本范围的文本属性的命名常量。 这些常量与以下方法一起使用:

常量/值 说明
UIA_AfterParagraphSpacingAttributeId
40042
标识 AfterParagraphSpacing 文本属性,该属性指定段落后间距的大小。
变量类型: VT_R8
默认值:0
UIA_AnimationStyleAttributeId
40000
标识 AnimationStyle 文本属性,该属性指定应用于文本的动画类型。 此属性指定为 AnimationStyle 枚举类型中的值。
变量类型: VT_I4
默认值: AnimationStyle_None
UIA_AnnotationObjectsAttributeId
40032
标识 AnnotationObjects 文本属性,该属性维护 IUIAutomationElement2 接口的数组,该数组适用于实现 Annotation 控件模式的当前文本范围中的每个元素。 每个元素还可以根据需要实现其他控件模式来描述批注。 例如,作为注释的批注也支持 文本 控件模式。 从 Windows 8 开始支持。
变量类型: VT_UNKNOWN
默认值:空数组
UIA_AnnotationTypesAttributeId
40031
标识 AnnotationTypes 文本属性,该属性维护文本范围的批注类型标识符列表。 有关可能值的列表,请参阅 批注类型标识符。 从 Windows 8 开始支持。
变量类型: VT_ARRAY
VT_I4
默认值:空数组
UIA_BackgroundColorAttributeId
40001
标识 BackgroundColor 文本属性,该属性指定文本的背景色。 此属性指定为 COLORREF;用于指定 RGB 或 RGBA 颜色的 32 位值。
变量类型: VT_I4
默认值:0
UIA_BeforeParagraphSpacingAttributeId
40041
标识 BeforeParagraphSpacing 文本属性,该属性指定段落前的间距大小。
变量类型: VT_R8
默认值:0
UIA_BulletStyleAttributeId
40002
标识 BulletStyle 文本属性,该属性指定文本范围中使用的项目符号的样式。 此属性指定为 BulletStyle 枚举类型中的值。
变量类型: VT_I4
默认值: BulletStyle_None
UIA_CapStyleAttributeId
40003
标识 CapStyle 文本属性,该属性指定文本的大写样式。 此属性指定为 CapStyle 枚举类型的值。
变量类型: VT_I4
默认值: CapStyle_None
UIA_CaretBidiModeAttributeId
40039
标识 CaretBidiMode 文本属性,该属性指示文本范围中的文本流动方向。 此属性指定为 CaretBidiMode 枚举类型的值。 从 Windows 8 开始支持。
变量类型: VT_I4
默认值: CaretBidiMode_LTR
UIA_CaretPositionAttributeId
40038
标识 CaretPosition 文本属性,该属性指示插入符号是位于文本范围中文本行的开头还是末尾。 此属性指定为 CaretPosition 枚举类型的值。 从 Windows 8 开始支持。
变量类型: VT_I4
默认值: CaretPosition_Unknown
UIA_CultureAttributeId
40004
标识 Culture 文本属性,该属性按 LCID) 的区域设置标识符 (指定文本的区域设置。
变量类型: VT_I4
默认值:应用程序 UI 的区域设置
UIA_FontNameAttributeId
40005
标识 FontName 文本属性,该属性指定字体的名称。 示例:“Arial Black”;“Arial Narrow”。 字体名称字符串未本地化。
变量类型: VT_BSTR
默认值:空字符串
UIA_FontSizeAttributeId
40006
标识 FontSize 文本属性,该属性指定字体的点大小。
变量类型: VT_R8
默认值:0
UIA_FontWeightAttributeId
40007
标识 FontWeight 文本属性,该属性指定字体的相对笔划、粗细或粗体。 FontWeight 属性是在 GDI LOGFONT 结构的 lfWeight 成员和相关标准之后建模的,可以是以下值之一:
  • 0 = DontCare
  • 100 =
  • 200 = ExtraLightUltraLight
  • 300 = 浅色
  • 400 = 正常常规
  • 500 = 中等
  • 600 = SemiBold
  • 700 = 粗体
  • 800 = ExtraBoldUltraBold
  • 900 = 黑色

变量类型: VT_I4
默认值:0
UIA_ForegroundColorAttributeId
40008
标识 ForegroundColor 文本属性,该属性指定文本的前景色。 此属性指定为 COLORREF,这是用于指定 RGB 或 RGBA 颜色的 32 位值。
变量类型: VT_I4
默认值:0
UIA_HorizontalTextAlignmentAttributeId
40009
标识 HorizontalTextAlignment 文本属性,该属性指定文本的水平对齐方式。 此属性指定为 HorizontalTextAlignmentEnum 枚举类型的值。
变量类型: VT_I4
默认值: HorizontalTextAlignment_Left
UIA_IndentationFirstLineAttributeId
40010
标识 IndentationFirstLine 文本属性,该属性指定段落首行缩进的距离(以磅为单位)。
变量类型: VT_R8
默认值:0
UIA_IndentationLeadingAttributeId
40011
标识 IndentationLeading 文本属性,该属性以磅为单位指定前导缩进。
变量类型: VT_R8
默认值:0
UIA_IndentationTrailingAttributeId
40012
标识 IndentationTrailing 文本属性,该属性以磅为单位指定尾随缩进。
变量类型: VT_R8
默认值:0
UIA_IsActiveAttributeId
40036
标识 IsActive 文本属性,该属性指示包含文本范围的控件是否具有键盘焦点 (TRUE) (FALSE) 。 从 Windows 8 开始支持。
变体类型: VT_BOOL
默认值: FALSE
UIA_IsHiddenAttributeId
40013
标识 IsHidden 文本属性,该属性指示文本是隐藏 (TRUE) 还是可见 (FALSE) 。
变体类型: VT_BOOL
默认值: FALSE
UIA_IsItalicAttributeId
40014
标识 IsItalic 文本属性,该属性指示文本是否为斜体 (TRUE) (FALSE) 。
变体类型: VT_BOOL
默认值: FALSE
UIA_IsReadOnlyAttributeId
40015
标识 IsReadOnly 文本属性,该属性指示文本是只读 (TRUE) ,还是可 (FALSE) 修改。
变体类型: VT_BOOL
默认值: FALSE
UIA_IsSubscriptAttributeId
40016
标识 IsSubscript 文本属性,该属性指示文本是否为下标 (TRUE) (FALSE) 。
变体类型: VT_BOOL
默认值: FALSE
UIA_IsSuperscriptAttributeId
40017
标识 IsSuperscript 文本属性,该属性指示文本是否为下标 (TRUE) (FALSE) 。
变体类型: VT_BOOL
默认值: FALSE
UIA_LineSpacingAttributeId
40040
标识 LineSpacing 文本属性,该属性指定文本行之间的间距。
变量类型: VT_BSTR
默认值:“LineSpacingAttributeDefault”
UIA_LinkAttributeId
40035
标识 Link 文本属性,该属性包含作为文档中内部链接目标的文本范围的 IUIAutomationTextRange 接口。 从 Windows 8 开始支持。
变量类型: VT_UNKNOWN
默认值: NULL
UIA_MarginBottomAttributeId
40018
标识 MarginBottom 文本属性,该属性指定应用于与文本范围关联的页面的下边距的大小(以磅为单位)。
变量类型: VT_R8
默认值:0
UIA_MarginLeadingAttributeId
40019
标识 MarginLeading 文本属性,该属性指定应用于与文本范围关联的页面的前导边距的大小(以磅为单位)。
变量类型: VT_R8
默认值:0
UIA_MarginTopAttributeId
40020
标识 MarginTop 文本属性,该属性指定应用于与文本范围关联的页面的上边距的大小(以磅为单位)。
变量类型: VT_R8
Ddefault 值:0
UIA_MarginTrailingAttributeId
40021
标识 MarginTrailing 文本属性,该属性指定应用于与文本范围关联的页面的尾随边距的大小(以磅为单位)。
变量类型: VT_R8
默认值:0
UIA_OutlineStylesAttributeId
40022
标识 OutlineStyles 文本属性,该属性指定文本的大纲样式。 此属性指定为 OutlineStyles 枚举类型的值。
变量类型: VT_I4
默认值: OutlineStyles_None
UIA_OverlineColorAttributeId
40023
标识 OverlineColor 文本属性,该属性指定上划线文本修饰的颜色。 此属性指定为 COLORREF,这是用于指定 RGB 或 RGBA 颜色的 32 位值。
变量类型: VT_I4
默认值:0
UIA_OverlineStyleAttributeId
40024
标识 OverlineStyle 文本属性,该属性指定上划线文本修饰的样式。 此属性指定为 TextDecorationLineStyleEnum 枚举类型的值。
变量类型: VT_I4
默认值: TextDecorationLineStyle_None
UIA_SelectionActiveEndAttributeId
40037
标识 SelectionActiveEnd 文本属性,该属性指示插入点相对于表示当前选定文本的文本范围的位置。 此属性指定为 ActiveEnd 枚举中的值。 从 Windows 8 开始支持。
变量类型: VT_I4
默认值: ActiveEnd_None
UIA_StrikethroughColorAttributeId
40025
标识 StrikethroughColor 文本属性,该属性指定删除线文本修饰的颜色。 此属性指定为 COLORREF,这是用于指定 RGB 或 RGBA 颜色的 32 位值。
变量类型: VT_I4
默认值:0
UIA_StrikethroughStyleAttributeId
40026
标识 StrikethroughStyle 文本属性,该属性指定删除线文本修饰的样式。 此属性指定为 TextDecorationLineStyleEnum 枚举类型的值。
变量类型: VT_I4
默认值: TextDecorationLineStyle_None
UIA_StyleIdAttributeId
40034
标识 StyleId 文本属性,该属性指示用于文本范围的文本样式。 有关可能值的列表,请参阅 样式标识符。 从 Windows 8 开始支持。
变量类型: VT_I4
默认值:0
UIA_StyleNameAttributeId
40033
标识 StyleName 文本属性,该属性标识用于文本范围的文本样式的本地化名称。 从 Windows 8 开始支持。
变量类型: VT_BSTR
默认值:空字符串
UIA_TabsAttributeId
40027
标识 Tabs 文本属性,该属性是指定文本范围的制表位的数组。 每个数组元素指定与前导边距的距离(以磅为单位)。
变体类型: VT_ARRAY |VT_R8
默认值:空数组
UIA_TextFlowDirectionsAttributeId
40028
标识 TextFlowDirections 文本属性,该属性指定文本流的方向。 此属性指定为 FlowDirections 枚举类型中的值的组合。
变量类型: VT_I4
默认值: FlowDirections_Default
UIA_UnderlineColorAttributeId
40029
标识 UnderlineColor 文本属性,该属性指定下划线文本修饰的颜色。 此属性指定为 COLORREF,这是用于指定 RGB 或 RGBA 颜色的 32 位值。
变量类型: VT_I4
默认值:0
UIA_UnderlineStyleAttributeId
40030
标识 UnderlineStyle 文本属性,该属性指定下划线文本修饰的样式。 此属性指定为 TextDecorationLineStyleEnum 枚举类型的值。
变量类型: VT_I4
默认值: TextDecorationLineStyle_None

要求

要求
最低受支持的客户端
Windows XP [桌面应用 |UWP 应用]
最低受支持的服务器
Windows Server 2003 [桌面应用 |UWP 应用]
标头
UIAutomationClient.h

另请参阅

引用

ITextRangeProvider::FindAttribute

ITextRangeProvider::GetAttributeValue

IUIAutomation::FindAttribute

IUIAutomation::GetAttributeValue

概念性

对文本内容的UI 自动化支持