Share via


IUIAutomationElement7::FindFirstWithOptionsBuildCache-Methode (uiautomationclient.h)

Sucht das erste übereinstimmende Element in der angegebenen Reihenfolge, speichert aber auch dessen Eigenschaften und Muster zwischen.

Syntax

HRESULT FindFirstWithOptionsBuildCache(
                 TreeScope                 scope,
  [in]           IUIAutomationCondition    *condition,
  [in]           IUIAutomationCacheRequest *cacheRequest,
                 TreeTraversalOptions      traversalOptions,
  [in, optional] IUIAutomationElement      *root,
  [out, retval]  IUIAutomationElement      **found
);

Parameter

scope

[in] condition

Ein Zeiger auf eine Bedingung, die die abzugleichenden Kriterien darstellt.

[in] cacheRequest

Ein Zeiger auf eine Cacheanforderung, der die Steuerelementmuster und Eigenschaften angibt, die in den Cache eingeschlossen werden sollen.

traversalOptions

[in, optional] root

Ein Zeiger auf das Element, mit dem die Suche gestartet werden soll.

[out, retval] found

Empfängt einen Zeiger auf das -Element. NULL wird zurückgegeben, wenn kein übereinstimmende Element gefunden wird.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück, andernfalls ein HRESULT-Fehlercode .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1703 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uiautomationclient.h (include UIAutomation.h)
DLL UIAutomationCore.dll

Weitere Informationen

IUIAutomationElement7