IUIAutomationTextRange::GetAttributeValue 方法 (uiautomationclient.h)
擷取整個文字範圍的指定文字屬性值。
語法
HRESULT GetAttributeValue(
[in] TEXTATTRIBUTEID attr,
[out, retval] VARIANT *value
);
參數
[in] attr
類型: TEXTATTRIBUTEID
文字屬性的識別碼。 如需文字屬性識別碼的清單,請參閱 文字屬性識別碼。
[out, retval] value
類型: VARIANT*
接收指定屬性的值。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
此方法擷取的數值型別取決於 attr 參數。 例如,呼叫 GetAttributeValue 且 attr 參數設定為 UIA_FontNameAttributeId 會傳回代表文字範圍的字型名稱的字串,而呼叫 GetAttributeValue 且 attr 設定為 UIA_IsItalicAttributeId 會傳回布林值。
如果不支援 attr 指定的屬性, value 參數會收到相當於 IUIAutomation::ReservedNotSupportedValue 屬性的值。
文字範圍可以包含特定屬性的多個值。 例如,如果文字範圍包含一個以上的字型,FontName 屬性將會有多個值。 具有多個值的屬性稱為 混合屬性。 您可以比較從 GetAttributeValue 擷取的值與 UIAutomation::ReservedMixedAttributeValue 屬性,判斷特定屬性是否為混合屬性。
無論文字是隱藏還是可見, GetAttributeValue 方法都會擷取屬性值。 使用 UIA_ IsHiddenAttributeId 來檢查文字可見度。
規格需求
最低支援的用戶端 | Windows 7、Windows Vista SP2 和 Platform Update for Windows Vista、Windows XP 含 SP3 和適用于 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) |