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
);
-
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. -
Ce message n’a aucune valeur de retour.
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.
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 |
|