WM_IME_COMPOSITION Nachricht

Artikel
06/12/2023

Wird an eine Anwendung gesendet, wenn der IME die Komposition status als Ergebnis einer Tastatureingabe ändert. Ein Fenster empfängt diese Meldung über seine WindowProc-Funktion .

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

Parameter

hwnd

Ein Handle zum Fenster.

wParam

DBCS-Zeichen, das die letzte Änderung der Kompositionszeichenfolge darstellt.

lParam

Wert, der angibt, wie sich die Kompositionszeichenfolge oder das Zeichen geändert hat. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen. Weitere Informationen zu diesen Werten finden Sie unter IME-Kompositionszeichenfolgenwerte.

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

Der lParam-Parameter kann auch einen oder mehrere der folgenden Werte aufweisen.

Wert	Bedeutung
CS_INSERTCHAR	Fügen Sie das wParam-Kompositionszeichen an der aktuellen Einfügemarke ein. Eine Anwendung sollte das Kompositionszeichen anzeigen, wenn sie diese Nachricht verarbeitet.
CS_NOMOVECARET	Verschieben Sie die Caretposition aufgrund der Verarbeitung der Nachricht nicht. Wenn ein IME beispielsweise eine Kombination aus CS_INSERTCHAR und CS_NOMOVECARET angibt, sollte die Anwendung das angegebene Zeichen an der aktuellen Caretposition einfügen, das Caret jedoch nicht an die nächste Position verschieben. Dieses Zeichen wird durch eine nachfolgende WM_IME_COMPOSITION-Nachricht mit GCS_RESULTSTR ersetzt.

Wert

Bedeutung

CS_INSERTCHAR

Fügen Sie das wParam-Kompositionszeichen an der aktuellen Einfügemarke ein. Eine Anwendung sollte das Kompositionszeichen anzeigen, wenn sie diese Nachricht verarbeitet.

CS_NOMOVECARET

Verschieben Sie die Caretposition aufgrund der Verarbeitung der Nachricht nicht. Wenn ein IME beispielsweise eine Kombination aus CS_INSERTCHAR und CS_NOMOVECARET angibt, sollte die Anwendung das angegebene Zeichen an der aktuellen Caretposition einfügen, das Caret jedoch nicht an die nächste Position verschieben. Dieses Zeichen wird durch eine nachfolgende WM_IME_COMPOSITION-Nachricht mit GCS_RESULTSTR ersetzt.

Rückgabewert

Diese Nachricht hat keinen Rückgabewert.

Bemerkungen

Eine Anwendung sollte diese Meldung verarbeiten, wenn sie Kompositionszeichen selbst anzeigt. Andernfalls sollte die Nachricht an das IME-Fenster gesendet werden.

Wenn die Anwendung ein IME-Fenster erstellt hat, sollte sie diese Meldung an dieses Fenster übergeben. Die Funktion DefWindowProc verarbeitet diese Nachricht, indem sie an das Standard-IME-Fenster übergeben wird. Das IME-Fenster verarbeitet diese Nachricht, indem die Darstellung basierend auf dem angegebenen Änderungsflag aktualisiert wird. Eine Anwendung kann ImmGetCompositionString aufrufen, um die neue Kompositions-status abzurufen.

Wenn keiner der GCS_-Werte festgelegt ist, gibt die Meldung an, dass die aktuelle Komposition abgebrochen wurde und Anwendungen, die die Kompositionszeichenfolge zeichnen, die Zeichenfolge löschen sollten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Winuser.h (windows.h einschließen); Imm.h (windows.h einschließen)

Siehe auch

Eingabemethoden-Manager
Eingabemethoden-Manager-Meldungen
ImmGetCompositionString

Freigeben über