IUIAutomationTextRange：：FindAttribute 方法 (uiautomationclient.h)
擷取具有指定文字屬性值的文字範圍子集。
語法
HRESULT FindAttribute(
[in] TEXTATTRIBUTEID attr,
[in] VARIANT val,
[in] BOOL backward,
[out, retval] IUIAutomationTextRange **found
);
參數
[in] attr
類型： TEXTATTRIBUTEID
要擷取之文字範圍子集之文字屬性的標識碼。 如需文字屬性識別碼的清單，請參閱 文字屬性識別碼。
[in] val
類型： VARIANT
屬性的值。 這個值必須符合屬性的型別。
[in] backward
類型： BOOL
如果應該傳回最後一個發生的文字範圍，而不是第一個，則為TRUE;否則為 FALSE。
[out, retval] found
類型： IUIAutomationTextRange**
接收具有相符屬性和屬性值之文字範圍的指標;否則 為 NULL。
傳回值
類型： HRESULT
如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
不論文字是隱藏還是可見， FindAttribute 方法都會擷取相符的文字。 使用 UIA_IsHiddenAttributeId 來檢查文字可見度。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 7、Windows Vista sp2 和 Platform Update for Windows Vista、Windows XP with SP3 和 Platform Update for 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) |