Partager via


Méthode ITextRangeProvider ::GetEnclosingElement (uiautomationcore.h)

Retourne l’élément le plus interne qui entoure la plage de texte spécifiée.

Syntaxe

HRESULT GetEnclosingElement(
  [out, retval] IRawElementProviderSimple **pRetVal
);

Paramètres

[out, retval] pRetVal

Type : IRawElementProviderSimple**

Le fournisseur UI Automation de l’élément le plus interne qui entoure l’ITextRangeProvider spécifié.

Notes

L’élément englobant peut s’étendre plus que le ITextRangeProvider spécifié.

Si aucun élément englobant n’est trouvé, le parent ITextProvider du ITextRangeProvider est retourné.

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

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 ::GetChildren, UI Automation Providers Overview