ImmNotifyIME-Funktion (imm.h)
Benachrichtigt den IME über Änderungen am status des Eingabekontexts.
Syntax
BOOL ImmNotifyIME(
HIMC unnamedParam1,
[in] DWORD dwAction,
[in] DWORD dwIndex,
[in] DWORD dwValue
);
Parameter
unnamedParam1
[in] dwAction
Benachrichtigungscode. Dieser Parameter kann einen der folgenden Werte aufweisen.
| Wert | Bedeutung |
|---|---|
|
Eine Anwendung hat den aktuell ausgewählten Kandidaten geändert. Der dwIndex-Parameter gibt einen Index einer Kandidatenliste an, die ausgewählt werden soll, und dwValue wird nicht verwendet. |
|
Eine Anwendung weist den IME an, eine Kandidatenliste zu schließen. Der dwIndex-Parameter gibt einen Index der zu schließenden Liste an, und dwValue wird nicht verwendet. Der IME sendet einen IMN_CLOSECANDIDATE-Befehl an die Anwendung, wenn die Liste geschlossen wird. |
|
Eine Anwendung weist den IME an, eine Aktion für die Kompositionszeichenfolge auszuführen. Der dwIndex-Parameter kann CPS_CANCEL, CPS_COMPLETE, CPS_CONVERT oder CPS_REVERT sein. |
|
Eine Anwendung weist den IME an, der Anwendung die Verarbeitung des angegebenen Menüs zu ermöglichen. Der dwIndex-Parameter gibt die ID des Menüs an, und dwValue ist ein anwendungsdefinierter Wert für dieses Menüelement. |
|
Eine Anwendung weist den IME an, eine Kandidatenliste zu öffnen. Der dwIndex-Parameter gibt den Index der zu öffnenden Liste an, und dwValue wird nicht verwendet. Der IME sendet einen IMN_OPENCANDIDATE-Befehl an die Anwendung, wenn die Liste geöffnet wird. |
|
Eine Bewerbung hat einen der Kandidaten ausgewählt. Der dwIndex-Parameter gibt einen Index einer Kandidatenliste an, die ausgewählt werden soll. Der dwValue-Parameter gibt einen Index einer Kandidatenzeichenfolge in der ausgewählten Kandidatenliste an. |
|
Die Anwendung ändert die Seitengröße einer Kandidatenliste. Der dwIndex-Parameter gibt die zu ändernde Kandidatenliste an und muss einen Wert im Bereich von 0 bis 3 aufweisen. Der dwValue-Parameter gibt die neue Seitengröße an. |
|
Die Anwendung ändert den Seitenanfangsindex einer Kandidatenliste. Der dwIndex-Parameter gibt die zu ändernde Kandidatenliste an und muss einen Wert im Bereich von 0 bis 3 aufweisen. Der dwValue-Parameter gibt den neuen Seitenstartindex an. |
[in] dwIndex
Index einer Kandidatenliste. Wenn dwAction NI_COMPOSITIONSTR ist, kann dieser Parameter einen der folgenden Werte aufweisen.
[in] dwValue
Index einer Kandidatenzeichenfolge. Abhängig vom Wert des dwAction-Parameters kann die Anwendung diesen Parameter festlegen oder ignorieren.
Rückgabewert
Gibt bei erfolgreicher Ausführung ungleich null zurück, andernfalls 0.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps],Unterstützung für ostasiatische Sprache installiert. |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imm.h (include Immdev.h, Windows.h) |
| Bibliothek | Imm32.lib |
| DLL | Imm32.dll |