WM_IME_COMPOSITION message

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 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

Voir aussi

Gestionnaire de méthodes d’entrée

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

ImmGetCompositionString