Partager via


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

Retourne les enfants et les propriétés et modèles fournis pour les éléments d’une plage de texte dans un seul appel interprocesseur. Cela équivaut à appeler GetChildren, mais ajoute le modèle de cache de build standard.

Syntaxe

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

Paramètres

[in] cacheRequest

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

[out, retval] children

Retourne les enfants, ainsi que les propriétés ou modèles de chaque enfant, de la plage de texte qui répondent 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 GetChildren :

  • Les enfants qui chevauchent la plage de texte, mais qui ne sont pas entièrement entourés par celle-ci seront également inclus.
  • Quand aucun enfant n’existe, une collection vide est retournée.
À 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