Partager via


Méthode ITextProvider ::RangeFromChild (uiautomationcore.h)

Récupère une plage de texte qui entoure l’élément enfant spécifié (par exemple, une image, un lien hypertexte ou un autre objet incorporé).

Syntaxe

HRESULT RangeFromChild(
  [in]          IRawElementProviderSimple *childElement,
  [out, retval] ITextRangeProvider        **pRetVal
);

Paramètres

[in] childElement

Type : IRawElementProviderSimple*

Fournisseur UI Automation de l’élément enfant spécifié.

[out, retval] pRetVal

Type : ITextRangeProvider**

Plage de texte qui entoure l’élément enfant.

Cette plage englobe complètement le contenu de l’élément enfant de telle sorte que :

  1. ITextRangeProvider ::GetEnclosingElement retourne l’élément enfant lui-même, ou le descendant le plus interne de l’élément enfant qui partage la même plage de texte que l’élément enfant
  2. ITextRangeProvider ::GetChildren retourne les enfants de l’élément de (1) qui sont complètement inclus dans la plage
  3. Les deux points de terminaison de la plage se trouvent aux limites de l’élément enfant

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.

Notes

E_INVALIDARG est retourné si childElement n’est pas un descendant d’un ITextProvider ou n’est pas entouré d’une plage de texte valide.

Remarques

Chaque élément récupéré avec ITextRangeProvider ::GetChildren a également 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 l’élément 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 un tableau à deux cellules entouré de texte.

    Texte de début

    Cellule de tableau 1Cellule de tableau 2

    Texte de fin

Configuration requise

Condition requise Valeur
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, ITextRangeProvider ::GetEnclosingElement, ITextRangeProvider ::GetChildren, UI Automation Providers Overview