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.

capture d’écran montrant du texte contenant une image incorporée et un lien hypertexte

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 :

capture d’écran montrant un exemple d’arborescence d’éléments UI Automation

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 :

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.

Conceptuel