共用方式為

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)

另請參閱

IUIAutomationTextRange

文字內容的 UI 自動化支援