WM_IME_COMPOSITION message

Article
06/22/2023

Envoyé à une application lorsque l’IME change de composition status à la suite d’une séquence de touches. Une fenêtre reçoit ce message via sa fonction WindowProc.

LRESULT CALLBACK WindowProc(
  HWND  hwnd,     
  WM_IME_COMPOSITION,   
  WPARAM wParam,
  LPARAM lParam          
);

Paramètres

Hwnd

Handle to window.

wParam

Caractère DBCS représentant la dernière modification apportée à la chaîne de composition.

lParam

Valeur spécifiant la façon dont la chaîne de composition ou le caractère a changé. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes. Pour plus d’informations sur ces valeurs, consultez Valeurs de chaîne de composition IME.

GCS_COMPATTR
GCS_COMPCLAUSE
GCS_COMPREADSTR
GCS_COMPREADATTR
GCS_COMPREADCLAUSE
GCS_COMPSTR
GCS_CURSORPOS
GCS_DELTASTART
GCS_RESULTCLAUSE
GCS_RESULTREADCLAUSE
GCS_RESULTREADSTR
GCS_RESULTSTR

Le paramètre lParam peut également avoir une ou plusieurs des valeurs suivantes.

Valeur	Signification
CS_INSERTCHAR	Insérez le caractère de composition wParam au point d’insertion actuel. Une application doit afficher le caractère de composition si elle traite ce message.
CS_NOMOVECARET	Ne déplacez pas la position d’insertion suite au traitement du message. Par exemple, si un IME spécifie une combinaison de CS_INSERTCHAR et de CS_NOMOVECARET, l’application doit insérer le caractère spécifié à la position d’insertion actuelle, mais ne doit pas déplacer l’insertion vers la position suivante. Un message de WM_IME_COMPOSITION suivant par GCS_RESULTSTR remplacera ce caractère.

Valeur

Signification

CS_INSERTCHAR

Insérez le caractère de composition wParam au point d’insertion actuel. Une application doit afficher le caractère de composition si elle traite ce message.

CS_NOMOVECARET

Ne déplacez pas la position d’insertion suite au traitement du message. Par exemple, si un IME spécifie une combinaison de CS_INSERTCHAR et de CS_NOMOVECARET, l’application doit insérer le caractère spécifié à la position d’insertion actuelle, mais ne doit pas déplacer l’insertion vers la position suivante. Un message de WM_IME_COMPOSITION suivant par GCS_RESULTSTR remplacera ce caractère.

Valeur retournée

Ce message n’a aucune valeur de retour.

Remarques

Une application doit traiter ce message si elle affiche elle-même des caractères de composition. Sinon, il doit envoyer le message à la fenêtre IME.

Si l’application a créé une fenêtre IME, elle doit passer ce message à cette fenêtre. La fonction DefWindowProc traite ce message en le transmettant à la fenêtre IME par défaut. La fenêtre IME traite ce message en mettant à jour son apparence en fonction de l’indicateur de modification spécifié. Une application peut appeler ImmGetCompositionString pour récupérer la nouvelle composition status.

Si aucune des valeurs GCS_ n’est définie, le message indique que la composition actuelle a été annulée et les applications qui dessinent la chaîne de composition doivent supprimer la chaîne.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Winuser.h (inclure Windows.h) ; Imm.h (inclure Windows.h)

Voir aussi

Gestionnaire de méthodes d’entrée
Messages du Gestionnaire de méthodes d’entrée
ImmGetCompositionString