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 |
|
Siehe auch