IUIAutomationTextRange::GetAttributeValue 方法 (uiautomationclient.h)

在整个文本范围内检索指定文本属性的值。

语法

HRESULT GetAttributeValue(
  [in]          TEXTATTRIBUTEID attr,
  [out, retval] VARIANT         *value
);

参数

[in] attr

类型: TEXTATTRIBUTEID

文本属性的标识符。 有关文本属性 ID 的列表,请参阅 文本属性标识符

[out, retval] value

类型: VARIANT*

接收指定特性的值。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此方法检索的值的类型取决于 attr 参数。 例如,使用 attr 参数设置为 UIA_FontNameAttributeId 调用 GetAttributeValue 将返回一个表示文本范围的字体名称的字符串,而将 attr 设置为 UIA_IsItalicAttributeId 调用 GetAttributeValue 将返回布尔值。

如果 不支持 attr 指定的属性,则 value 参数将接收与 IUIAutomation::ReservedNotSupportedValue 属性等效的值。

文本范围可以包含特定属性的多个值。 例如,如果文本范围包含多个字体,则 FontName 属性将具有多个值。 具有多个值的属性称为 混合属性。 通过将从 GetAttributeValue 检索到的值与 UIAutomation::ReservedMixedAttributeValue 属性进行比较,可以确定特定属性是否为混合属性。

无论文本是隐藏还是可见, GetAttributeValue 方法都会检索属性值。 使用 UIA_ IsHiddenAttributeId 检查文本可见性。

要求

   
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新、带 SP3 的 Windows XP 和适用于 Windows Vista 的平台更新 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008、Windows Server 2003 SP2 和 Platform Update for Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 uiautomationclient.h (包括 UIAutomation.h)

另请参阅

IUIAutomationTextRange

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