Modèle de contrôle TextChild

Présente des instructions et des conventions pour l’implémentation d'ITextChildProvider, y compris des informations sur les propriétés et les méthodes. Le modèle de contrôle TextChild est utilisé pour accéder à l’ancêtre le plus proche d’un élément qui prend en charge le modèle de contrôle Text.

Par exemple, supposons que le texte d’un document contient une image incorporée et un lien hypertexte, comme illustré dans l’image suivante.

Si vous utilisez les outils Microsoft UI Automation pour examiner l’arborescence UI Automation pour ce contenu de document, il peut afficher un élément de document avec un élément enfant qui représente l’image et un autre élément enfant qui représente le lien hypertexte. Par exemple:

En règle générale, l’élément de document de l’exemple précédent prend en charge le modèle de contrôle texte, mais les deux enfants de l’élément de document ne le font pas. Si une application cliente UI Automation a une référence à l’élément image ou à l’élément lien hypertexte, le client peut utiliser le modèle de contrôle TextChild comme moyen pratique d’accéder au modèle Textcontrol exposé par l’élément de document contenant.

Directives et conventions de mise en œuvre

Lors de l’implémentation de l’interface ITextChildProvider, notez les instructions et conventions suivantes :

• La propriété ITextChildProvider ::TextContainer doit spécifier l’élément ancêtre le plus proche qui prend en charge interface ITextProvider, que les éléments supérieurs à la chaîne ancêtre prennent également en charge ITextProvider.
• Un élément ne doit pas prendre en charge lesITextProvideret l’interface ITextChildProvider**.
• Un élément qui implémente ITextChildProvider doit être un enfant, ou descendant, d’un élément qui implémente ITextProvider. Il n’est pas nécessaire que cet élément implémente également le modèle de contrôle texte .
• La propriété ITextChildProvider ::TextRange doit spécifier la même plage de texte que celle renvoyée par l’élément fournisseur de texte contenant lorsque sa fonction ITextProvider ::RangeFromChild est appelée avec l’élément enfant de texte comme élément enfant placé entre parenthèses.

Membres requis pour ITextChildProvider

Ces propriétés et méthodes sont requises pour implémenter l’interface ITextChildProvider.

Membres obligatoires	Type de membre	Notes
TextContainer	Propriété	Aucun
TextRange	Propriété	Aucun

 

Ce modèle de contrôle n’a pas de méthodes ou d’événements associés.

Rubriques connexes

conceptuelle

• types de contrôle et leurs modèles de contrôle pris en charge
• Vue d’ensemble des modèles de contrôle UI Automation
• Vue d’ensemble de l’arborescence UI Automation