Freigeben über


IUIAutomationTextRange3::GetEnclosingElementBuildCache-Methode (uiautomationclient.h)

Ruft das einschließende Element sowie die angegebenen Eigenschaften und Muster für ein Element in einem Textbereich in einem einzelnen prozessübergreifenden Aufruf ab. Dies entspricht dem Aufrufen von GetEnclosingElement, fügt jedoch das Standardmäßige Buildcachemuster hinzu.

Syntax

HRESULT GetEnclosingElementBuildCache(
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **enclosingElement
);

Parameter

[in] cacheRequest

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

[out, retval] enclosingElement

Gibt das einschließende Element (und die Eigenschaften/Muster) des Textbereichs zurück, wenn es die Kriterien der angegebenen cacheRequest erfüllt.

Rückgabewert

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

Hinweise

Folgen Sie dem Entwurf von GetEnclosingElement:

  • Ruft das allumfassende, innerste einschließende Element eines Textbereichs und die angegebenen Eigenschaften des Elements ab.
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