Freigeben über


WM_IME_COMPOSITION Nachricht

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.

 

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