IUIAutomationTextRange3 ::GetEnclosingElementBuildCache, méthode (uiautomationclient.h)

Article
03/03/2024

Obtient l’élément englobant et les propriétés et modèles fournis pour un élément dans une plage de texte dans un seul appel interprocesseur. Cela équivaut à appeler GetEnclosingElement, mais ajoute le modèle de cache de build standard.

Syntaxe

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

Paramètres

[in] cacheRequest

IUIAutomationCacheRequest spécifiant les propriétés et les modèles de contrôle à mettre en cache.

[out, retval] enclosingElement

Retourne l’élément englobant (et les propriétés/modèles) de la plage de texte s’il répond aux critères de la demande cacheRequest fournie.

Valeur retournée

Retourne S_OK en cas de réussite, sinon un code d’erreur HRESULT .

Remarques

Suivant la conception de GetEnclosingElement :

Obtient l’élément englobant le plus intégré d’une plage de texte et les propriétés fournies de l’élément.

À la suite d’un appel réussi, UI Automation clients peuvent appeler les API « Cached » d’IUIAutomationElement fournies dans le cacheRequest, par exemple, IUIAutomationElement ::GetCachedPropertyValue.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1703 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	uiautomationclient.h (incluez UIAutomation.h)

Voir aussi

IUIAutomationTextRange3

UI Automation prise en charge du contenu textuel

Partager via