Partager via

Modèle de contrôle TextEdit

Présente des instructions et des conventions pour implémenter ITextEditProvider, y compris des informations sur les propriétés et les méthodes. Le modèle de contrôle TextEdit est utilisé pour l’accès par programmation à un contrôle qui modifie du texte, par exemple un contrôle qui effectue une correction automatique ou active la composition d’entrée.

Note

Les notes d’implémentation de cette rubrique font référence aux API provenant de Text Services Framework (TSF). Pour plus d’informations sur TSF et la référence de l’API, consultez Text Services Framework.

Membres requis pour ITextEditProvider

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

Membres obligatoires Type de membre Notes
GetActiveComposition Méthode Retourne la plage de la conversion actuelle (aucune s’il n’y a pas de conversion). Retournez la composition active (dans TSF, il s’agit de la plage marquée par GUID_PROP_COMPOSING). Par exemple, avec Microsoft Japanese Input Method Editor (IME), il s’agit du texte souligné en intégralité.
GetConversionTarget Méthode Retourne la plage cible de conversion actuelle (aucune si aucune conversion). Dans TSF, il s’agit de la plage de caractères marqués comme TF_ATTR_TARGET_NOTCONVERTED ou TF_ATTR_TARGET_CONVERTED de la structure TF_DISPLAYATTRIBUTE.

Les événements TextEditTextChanged et ConversionTargetChanged doivent être déclenchés par les éléments Microsoft UI Automation prenant en charge le modèle TextEdit.

TextEditTextChanged

  • Utilisez la fonctionUiaRaiseTextEditTextChangedEvent pour déclencher l’événement TextEditTextChanged.
  • Le tableau suivant répertorie les cas où vous devez déclencher l’événement et les paramètres UiaRaiseTextEditTextChangedEvent à utiliser.
TextEditChangeType Charge utile d’événement Notes
correction automatique Nouvelle chaîne corrigée Déclenché lorsqu’une correction automatique est effectuée par le contrôle. Ou chaque fois qu’un remplacement est effectué via TSF et que la plage a une valeur GUID_PROP_TKB_ALTERNATES de TKB_ALTERNATES_AUTOCORRECTION_APPLIED.
composition Chaîne mise à jour La charge utile ne doit inclure que les caractères modifiés (n’envoient pas la chaîne de composition entière). Déclenché chaque fois qu’un remplacement de composition est effectué. Dans TSF, un remplacement de composition est défini comme un remplacement dont l’indicateur de GUID_PROP_COMPOSING est défini. Les contrôles d’édition implémentant TSF peuvent surveiller ces modifications via la notification OnEndEdit.
CompositionFinalized Chaîne de composition finalisée (voir Notes) Dans TSF, la chaîne de conversion en cours de finalisation est définie par l’indicateur GUID_PROP_COMPOSING supprimé d’une composition. Les contrôles d’édition implémentant TSF doivent déterminer la chaîne finalisée à partir de endComposition et déclencher l’événement lorsque OnEndEdit est appelé.
La chaîne de composition finalisée peut être vide si la composition a été annulée ou supprimée.

ConversionTargetChanged

  • ConversionTargetChanged se produit lorsque la cible de conversion passe d’une cible à une autre.
  • Utilisez la fonctionUiaRaiseAutomationEventpour déclencher l’événement ConversionTargetChanged (transmettez l’identificateur d’événement UIA_TextEdit_ConversionTargetChangedEventId).
  • ConversionTargetChanged ne doit pas être déclenché lorsque le contenu de la cible change. Si la modification cible se produit simultanément avec une modification de composition, l’événement de modification cible doit être déclenché une fois que des événements de composition ont déjà été déclenchés.
  • Dans TSF, la cible de conversion est définie par la valeur TF_ATTR_TARGET_CONVERTED définie à partir de la structure TF_DISPLAYATTRIBUTE. Les modifications peuvent être surveillées à l’aide de OnEndEdit.

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

  • Last updated on