IUIAutomationTextRange3::GetChildrenBuildCache-Methode (uiautomationclient.h)

Artikel
03/03/2024

Gibt die untergeordneten Elemente sowie die angegebenen Eigenschaften und Muster für Elemente in einem Textbereich in einem einzelnen prozessübergreifenden Aufruf zurück. Dies entspricht dem Aufrufen von GetChildren, fügt jedoch das standardmäßige Buildcachemuster hinzu.

Syntax

HRESULT GetChildrenBuildCache(
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElementArray **children
);

Parameter

[in] cacheRequest

Eine IUIAutomationCacheRequest , die die Eigenschaften und Steuerelementmuster angibt, die zwischengespeichert werden sollen.

[out, retval] children

Gibt die untergeordneten Elemente und die Eigenschaften oder Muster jedes untergeordneten Elements des Textbereichs zurück, die die Kriterien der angegebenen cacheRequest erfüllen.

Rückgabewert

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

Hinweise

Folgen Sie dem Entwurf von GetChildren:

Untergeordnete Elemente, die sich mit dem Textbereich überlappen, aber nicht vollständig davon eingeschlossen sind, werden ebenfalls eingeschlossen.
Wenn keine untergeordneten Elemente vorhanden sind, wird eine leere Auflistung zurückgegeben.

Als Ergebnis eines erfolgreichen Aufrufs können Benutzeroberflächenautomatisierung Clients "Zwischengespeicherte" APIs von IUIAutomationElement aufrufen, die in der cacheRequest bereitgestellt werden, z. B. IUIAutomationElement::GetCachedPropertyValue.

Anforderungen

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

Weitere Informationen

IUIAutomationTextRange3

Benutzeroberflächenautomatisierung Unterstützung für Textinhalte

Freigeben über