WM _ IME _ COMPOSITION-Meldung

Wird an eine Anwendung gesendet, wenn der IME den Kompositionsstatus als Folge einer Tastatureingabe ändert. Ein Fenster empfängt diese Nachricht über seine WindowProc-Funktion.

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

Parameter

Hwnd

Ein Handle für ein Fenster.

wParam

DBCS-Zeichen, das die letzte Änderung an 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 sein. Weitere Informationen zu diesen Werten finden Sie unter IME Composition String Values.

_GCS-KOMPATIBILITÄTS-TR

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

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 Meldung verarbeitet.
CS _ NOMOVECARET
Verschieben Sie die Caretposition nicht als Ergebnis der Verarbeitung der Nachricht. 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 Caretzeichen 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 Meldung 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. Diese Meldung wird von der DefWindowProc-Funktion verarbeitet, indem sie an das STANDARD-IME-Fenster übergeben wird. Im IME-Fenster wird diese Meldung verarbeitet, indem die Darstellung basierend auf dem angegebenen Änderungsflag aktualisiert wird. Eine Anwendung kann ImmGetCompositionString aufrufen, um den neuen Kompositionsstatus abzurufen.

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

Requirements (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 (include Windows.h);
Imm.h (include Windows.h)

Weitere Informationen

Eingabemethode-Manager

Meldungen des Eingabemethode-Managers

ImmGetCompositionString