IUIAutomationElement7::FindAllWithOptionsBuildCache-Methode (uiautomationclient.h)

Artikel
03/06/2024

Sucht alle übereinstimmenden Elemente in der angegebenen Reihenfolge, speichert aber auch deren Eigenschaften und Muster zwischen.

Syntax

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

Parameter

[in] scope

Typ: TreeScope

Der Bereich der Anforderung.

Wenn ein Element abgerufen wird, kann die Zwischenspeicherung nur für das Element selbst (das Standardverhalten) oder für das Element und seine untergeordneten Elemente oder Nachfolger ausgeführt werden. Diese Eigenschaft beschreibt den Bereich der Anforderung.

[in] condition

Typ: IUIAutomationCondition

Die primäre Schnittstelle für Bedingungen, die beim Filtern bei der Suche nach Elementen in der Benutzeroberflächenautomatisierung-Struktur verwendet werden.

[in] cacheRequest

Typ: IUIAutomationCacheRequest

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

[in] traversalOptions

Typ: TreeTraversalOptions

Die Strukturnavigationsreihenfolge.

[in] root

Typ: IUIAutomationElement

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

[out, retval] found

Empfängt einen Zeiger auf ein Array übereinstimmende Elemente. Gibt ein leeres Array zurück, 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

Freigeben über