Fonction UiaRaiseTextEditTextChangedEvent (uiautomationcoreapi.h)

Article
03/13/2024

Appelé par un fournisseur pour informer microsoft UI Automation core qu’un contrôle de texte a modifié le texte par programmation.

Syntaxe

HRESULT UiaRaiseTextEditTextChangedEvent(
  [in] IRawElementProviderSimple *pProvider,
  [in] TextEditChangeType        textEditChangeType,
  [in] SAFEARRAY                 *pChangedData
);

Paramètres

[in] pProvider

Type : IRawElementProviderSimple*

Nœud de fournisseur où la modification de texte s’est produite.

[in] textEditChangeType

Type : TextEditChangeType

Type de modification de texte qui s’est produit.

[in] pChangedData

Type : SAFEARRAY*

Données d'événement. Doit être assignable en tant que VAR de type VT_BSTR.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Il s’agit d’une fonction d’assistance pour les fournisseurs qui implémentent ITextEditProvider et déclenchent les événements requis du modèle. Suivez les instructions fournies dans Modèle de contrôle TextEdit qui décrit quand déclencher les événements et quelle charge utile les événements doivent passer à UI Automation.

Si aucun client n’écoute un type de modification particulier, aucun événement n’est déclenché.

Les données d’événement doivent contenir des charges utiles différentes pour chaque type de modification (par TextEditChangeType) :

TextEditChangeType_AutoCorrect : pChangedData doit être la nouvelle chaîne corrigée .
TextEditChangeType_Composition : pChangedData doit être la chaîne mise à jour dans la composition (uniquement la partie modifiée).
TextEditChangeType_CompositionFinalized : pChangedData doit être la chaîne finalisée de la composition terminée (elle peut être vide si la composition a été annulée ou supprimée).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	uiautomationcoreapi.h
Bibliothèque	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Voir aussi

HandleTextEditTextChangedEvent

ITextEditProvider

IUIAutomation3 ::AddTextEditTextChangedEventHandler

Modèle de contrôle TextEdit

Partager via