Partager via


IUIAutomationElement ::GetCachedChildren, méthode (uiautomationclient.h)

Récupère les éléments enfants mis en cache de cet élément UI Automation.

Syntaxe

HRESULT GetCachedChildren(
  [out, retval] IUIAutomationElementArray **children
);

Paramètres

[out, retval] children

Type : IUIAutomationElementArray**

Reçoit un pointeur vers une collection d’éléments enfants mis en cache.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

L’affichage de la collection retournée est déterminé par la propriété TreeFilter de l’objet IUIAutomationCacheRequest qui était actif lors de l’obtention de cet élément.

Les enfants sont mis en cache uniquement si l’étendue de la demande de cache inclut TreeScope_Subtree, TreeScope_Children ou TreeScope_Descendants.

Si la demande de cache spécifiait que les enfants devaient être mis en cache à ce niveau, mais qu’il n’y a pas d’enfants, la valeur de cette propriété est 0. Toutefois, si aucune demande de mise en cache des enfants à ce niveau n’a été effectuée, une tentative de récupération de la propriété renvoie une erreur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista, Windows XP avec SP3 et Mise à jour de plateforme pour Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008, Windows Server 2003 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête uiautomationclient.h (incluez UIAutomation.h)

Voir aussi

Conceptuel

GetCachedParent

IUIAutomationElement

Obtention d'éléments UI Automation

Référence

Vue d’ensemble de l’arborescence UI Automation