Partager via


ITextRangeProvider ::GetChildren, méthode (uiautomationcore.h)

Récupère une collection de tous les éléments qui sont tous deux contenus (partiellement ou entièrement) dans la plage de texte spécifiée et sont des éléments enfants de l’élément englobant pour la plage de texte spécifiée.

Syntaxe

HRESULT GetChildren(
  [out, retval] SAFEARRAY **pRetVal
);

Paramètres

[out, retval] pRetVal

Type : SAFEARRAY**

Tableau de pointeurs vers les interfaces IRawElementProviderSimple pour tous les éléments enfants qui sont placés par la plage de texte (triés par le point de terminaison Start de leurs plages).

Si la plage de texte n’inclut aucun élément enfant, une collection vide est retournée.

Ce paramètre est passé sans être initialisé.

Valeur retournée

Type : HRESULT

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

Remarques

Chaque élément récupéré avec ITextRangeProvider ::GetChildren a une plage de texte valide qui peut être récupérée via RangeFromChild. Cela inclut tous les éléments de l’arborescence UI Automation entre ITextProvider et l’élément enfant.

Exemples

  1. Cet exemple montre un flux de texte qui contient un lien d’image. Le lien est un enfant de l’image, mais les deux couvrent la même plage de texte et sont exposés en tant qu’objets incorporés dans le flux de texte.

    Hello <Image Link> World

  2. Cet exemple montre un flux de texte qui contient une table à deux cellules entourée de texte.

    Texte de début

    Cellule de tableau 1Cellule de tableau 2

    Texte de fin

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête uiautomationcore.h (incluez UIAutomation.h)

Voir aussi

ITextProvider, ITextRangeProvider, GetEnclosingElement, ITextProvider ::RangeFromChild, UI Automation Providers Overview, Best Practices for Using Safe Arrays