ITextRangeProvider：：FindAttribute 方法 (uiautomationcore.h)

  • 發行項

傳回具有指定之文字屬性值的文字範圍子集。

語法

HRESULT FindAttribute(
  [in]          TEXTATTRIBUTEID    attributeId,
  [in]          VARIANT            val,
  [in]          BOOL               backward,
  [out, retval] ITextRangeProvider **pRetVal
);

參數

[in] attributeId

類型： TEXTATTRIBUTEID

文字屬性的標識碼。 如需文字屬性識別碼的清單，請參閱 文字屬性識別碼。

[in] val

類型： VARIANT

要搜尋的屬性值。 這個值必須符合屬性的型別。

[in] backward

類型： BOOL

如果應該傳回最後一個發生的文字範圍，而不是第一個，則為TRUE;否則為 FALSE。

[out, retval] pRetVal

類型： ITextRangeProvider**

接收具有相符屬性和屬性值之文字範圍的指標;否則為 NULL。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

不論文字是隱藏還是可見， FindAttribute 方法都會擷取相符的文字。 用戶端可以使用 UIA_IsHiddenAttributeId 來檢查文字可見性。

規格需求

需求 值
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 uiautomationcore.h (包含 UIAutomation.h)

另請參閱

概念

ITextProvider

ITextRangeProvider

參考

UI 自動化提供者概觀