ITextRangeProvider::GetAttributeValue 方法 (uiautomationcore.h)
检索跨文本范围指定文本属性的值。
语法
HRESULT GetAttributeValue(
[in] TEXTATTRIBUTEID attributeId,
[out, retval] VARIANT *pRetVal
);
参数
[in] attributeId
类型: TEXTATTRIBUTEID
文本属性的标识符。 有关文本属性 ID 的列表,请参阅 文本属性标识符。
[out, retval] pRetVal
类型: VARIANT*
接收以下项之一。
- 表示指定属性的值的 对象的地址。 值的数据类型因指定的属性而异。 例如,如果 attributeId为 UIA_FontNameAttributeId, 则 GetAttributeValue 返回一个表示文本范围的字体名称的字符串,但如果 attributeIdUIA_IsItalicAttributeId, GetAttributeValue 将返回布尔值。
- 如果指定属性的值因文本范围而异,则 UiaGetReservedMixedAttributeValue 函数检索的值的地址。
- 如果提供程序或控件不支持指定的属性,则 UiaGetReservedNotSupportedValue 函数检索的值的地址。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
GetAttributeValue 方法应检索属性值,而不考虑文本是隐藏的还是可见的。
要求
最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | uiautomationcore.h (包括 UIAutomation.h) |
请参阅
概念性
引用