共用方式為


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 參數。 例如,呼叫 GetAttributeValueattr 參數設定為 UIA_FontNameAttributeId 會傳回代表文字範圍的字型名稱的字串,而呼叫 GetAttributeValueattr 設定為 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)

另請參閱

IUIAutomationTextRange

文字內容的 UI 自動化支援