共用方式為


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 自動化提供者概觀