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

Article
03/03/2024

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)