Modèle de contrôle TextChild
Présente des recommandations et des conventions pour l’implémentation de 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 .
Supposons, par exemple, 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 d’automatisation d’interface utilisateur de Microsoft pour examiner l’arborescence UI Automation pour le contenu de ce document, il est possible qu’il affiche 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 général, l’élément de document dans l’exemple précédent prend en charge le modèle de contrôle Text , mais pas les deux enfants de l’élément de document. Si une application cliente UI Automation a une référence à l’élément image ou à l’élément Hyperlink, le client peut utiliser le modèle de contrôle TextChild comme un moyen pratique d’accéder au modèle TextControl exposé par l’élément de document conteneur.
Conventions et directives d'implémentation
Lorsque vous implémentez l’interface ITextChildProvider , notez les conventions et recommandations suivantes :
- La propriété ITextChildProvider :: TextContainer doit spécifier l’élément ancêtre le plus proche qui prend en charge l’interface ITextProvider , que les éléments situés plus haut dans la chaîne ancêtre prennent également en charge ITextProvider.
- Un élément ne doit pas prendre en charge à la fois ITextProvider et l’interface ITextChildProvider * * .
- Un élément qui implémente ITextChildProvider doit être un enfant ou un 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 Text.
- La propriété ITextChildProvider :: TextRange doit spécifier la même plage de texte que celle que l’élément de fournisseur de texte conteneur retourne lorsque sa fonction ITextProvider :: RangeFromChild est appelée avec l’élément enfant Text en tant qu’élément enfant délimité.
Membres requis pour ITextChildProvider
Ces propriétés et méthodes sont requises pour implémenter l’interface ITextChildProvider .
| Membres nécessaires | Type de membre | Notes |
|---|---|---|
| TextContainer | Propriété | Aucun |
| TextRange | Propriété | Aucun |
Ce modèle de contrôle n’est associé à aucune méthode ou aucun événement.
Rubriques connexes
Conceptuel