IUIAutomationElement7::FindFirstWithOptions-Methode (uiautomationclient.h)

Sucht das erste übereinstimmende Element in der angegebenen Reihenfolge.

Syntax

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

Parameter

[in] scope

Eine Kombination von Werten, die den Bereich der Suche angeben.

[in] condition

Ein Zeiger auf eine Bedingung, die die zu erfüllenden Kriterien darstellt.

traversalOptions

Enumerationswert, der die Strukturnavigationsreihenfolge angibt.

[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 S_OK bei erfolgreicher Ausführung zurück, andernfalls wird ein HRESULT- Fehlercode zurückgegeben.

Anforderungen

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

Siehe auch

IUIAutomationElement7