Modèle de contrôle TextChild

Présente des instructions et des conventions pour l’implémentation d’ITextChildProvider, notamment 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 contienne 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 de 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 document de 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 de 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.

Conventions et directives d'implémentation

Lors de l’implémentation de l’interface ITextChildProvider , notez les directives et conventions 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 plus haut dans la chaîne ancêtre prennent également en charge ITextProvider.
• Un élément ne doit pas prendre en charge l’interfaceITextProvider et 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 fournisseur de texte contenant retourne lorsque sa fonction ITextProvider::RangeFromChild est appelée avec l’élément enfant text comme élément enfant inclus.

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

• Types de contrôles 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