messaggio WM_IME_COMPOSITION

Articolo
06/22/2023

Inviato a un'applicazione quando l'IME modifica lo stato di composizione in seguito a una sequenza di tasti. Una finestra riceve questo messaggio tramite la relativa funzione WindowProc .

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

Parametri

Hwnd

Handle da finestrare.

wParam

Carattere DBCS che rappresenta la modifica più recente alla stringa di composizione.

lParam

Valore che specifica la modifica della stringa di composizione o del carattere. Questo parametro può essere uno o più dei valori seguenti. Per altre informazioni su questi valori, vedere Valori stringa di composizione 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

Il parametro lParam può avere anche uno o più dei valori seguenti.

Valore	Significato
CS_INSERTCHAR	Inserire il carattere di composizione wParam nel punto di inserimento corrente. Un'applicazione deve visualizzare il carattere di composizione se elabora questo messaggio.
CS_NOMOVECARET	Non spostare la posizione del cursore in seguito all'elaborazione del messaggio. Ad esempio, se un IME specifica una combinazione di CS_INSERTCHAR e CS_NOMOVECARET, l'applicazione deve inserire il carattere specificato nella posizione corrente del cursore, ma non deve spostare il cursore nella posizione successiva. Un messaggio di WM_IME_COMPOSITION successivo con GCS_RESULTSTR sostituirà questo carattere.

Valore

Significato

CS_INSERTCHAR

Inserire il carattere di composizione wParam nel punto di inserimento corrente. Un'applicazione deve visualizzare il carattere di composizione se elabora questo messaggio.

CS_NOMOVECARET

Non spostare la posizione del cursore in seguito all'elaborazione del messaggio. Ad esempio, se un IME specifica una combinazione di CS_INSERTCHAR e CS_NOMOVECARET, l'applicazione deve inserire il carattere specificato nella posizione corrente del cursore, ma non deve spostare il cursore nella posizione successiva. Un messaggio di WM_IME_COMPOSITION successivo con GCS_RESULTSTR sostituirà questo carattere.

Valore restituito

Questo messaggio non ha alcun valore restituito.

Commenti

Un'applicazione deve elaborare questo messaggio se visualizza i caratteri di composizione stessa. In caso contrario, deve inviare il messaggio alla finestra IME.

Se l'applicazione ha creato una finestra IME, deve passare questo messaggio a tale finestra. La funzione DefWindowProc elabora questo messaggio passandola alla finestra IME predefinita. La finestra IME elabora questo messaggio aggiornando l'aspetto in base al flag di modifica specificato. Un'applicazione può chiamare ImmGetCompositionString per recuperare il nuovo stato di composizione.

Se nessuna delle GCS_ valori è impostata, il messaggio indica che la composizione corrente è stata annullata e le applicazioni che disegnano la stringa di composizione devono eliminare la stringa.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Winuser.h (include Windows.h); Imm.h (include Windows.h)

Vedi anche

Gestione metodi di input
Messaggi di Gestione metodi di input
ImmGetCompositionString

Condividi tramite