Présentation du modèle objet texte UI Automation

Cette rubrique décrit comment Les applications clientes Microsoft UI Automation accèdent au contenu textuel d’un contrôle textuel.

• Modèle objet spécifique aux contrôles
• Rubriques connexes

Les contrôles textuels exposent le contenu textuel aux applications clientes UI Automation via un modèle objet texte simple. Les applications clientes ont accès au modèle objet texte via les interfaces de modèle de contrôle Text et TextRange , notamment IUIAutomationTextPattern et IUIAutomationTextRange. Les applications clientes peuvent utiliser ces interfaces pour récupérer du contenu textuel, des attributs de texte et des objets incorporés tels que des tables et des liens hypertexte à partir de contrôles textuels.

Les types de contrôles qui prennent en charge le modèle objet texte UI Automation incluent les types de contrôle Edit et Document. D’autres types de contrôle, tels que l’info-bulle et le texte , peuvent également prendre en charge le modèle objet texte, mais ils ne sont pas obligatoires.

Notes

Le modèle objet texte UI Automation ne fournit pas de moyen d’insérer ou de modifier du texte. Toutefois, certains contrôles permettent d’insérer ou de modifier du texte par le biais de l’interface IUIAutomationValuePattern , ou par le biais d’une entrée directe au clavier.

 

Modèle objet spécifique aux contrôles

Un contrôle textuel qui implémente son propre modèle DOM (Document Object Model) peut exposer le DOM en implémentant le modèle de contrôle ObjectModel . L’exposition du DOM peut donner aux applications clientes un accès et un contrôle accrus sur le contenu d’un contrôle textuel.

Une application cliente peut découvrir si un contrôle textuel particulier implémente un DOM en récupérant l’interface IUIAutomationElement du contrôle. Ensuite, appelez la méthode IUIAutomationElement::GetCurrentPropertyValue , en spécifiant l’identificateur de propriété UIA_IsObjectModelPatternAvailablePropertyId et une variante qui reçoit TRUE si le contrôle implémente un DOM.

Pour accéder au DOM, appelez la méthode IUIAutomationElement::GetCurrentPattern , en spécifiant l’identificateur de modèle de contrôle UIA_ObjectModelPatternId et une variable qui reçoit l’interface IUIAutomationObjectModelPattern . Appelez la méthode IUIAutomationObjectModelPattern::GetUnderlyingObjectModel pour récupérer l’interface DOM.

Rubriques connexes

Modèles de contrôle Text et TextRange

UI Automation prise en charge du contenu textuel

Utilisation de contrôles textuels