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 來檢查文字可見度。

規格需求

另請參閱

IUIAutomationTextRange

文字內容的 使用者介面自動化 支援