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 |