ImmNotifyIME-Funktion (immdev.h)

Artikel
08/24/2023

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
NI_CHANGECANDIDATELIST	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.
NI_CLOSECANDIDATE	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.
NI_COMPOSITIONSTR	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.
NI_IMEMENUSELECTED	Eine Anwendung weist den IME an, damit die Anwendung das angegebene Menü verarbeiten kann. Der dwIndex-Parameter gibt die ID des Menüs an, und dwValue ist ein anwendungsdefinierter Wert für dieses Menüelement.
NI_OPENCANDIDATE	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.
NI_SELECTCANDIDATESTR	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.
NI_SETCANDIDATE_PAGESIZE	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.
NI_SETCANDIDATE_PAGESTART	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 auch über einen der folgenden Werte verfügen.

Wert	Bedeutung
CPS_CANCEL	Löschen Sie die Kompositionszeichenfolge, und legen Sie die status auf keine Kompositionszeichenfolge fest.
CPS_COMPLETE	Legen Sie die Kompositionszeichenfolge als Ergebniszeichenfolge fest.
CPS_CONVERT	Konvertieren Sie die Kompositionszeichenfolge.
CPS_REVERT	Brechen Sie die aktuelle Kompositionszeichenfolge ab, und legen Sie die Kompositionszeichenfolge auf die nicht konvertierte Zeichenfolge fest.

[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 nonzero oder andernfalls 0 zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps],Ostasiatische Sprachunterstützung installiert.
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	immdev.h (einschließen immdev.h, Windows.h)
Bibliothek	Imm32.lib
DLL	Imm32.dll

Weitere Informationen

IMN_CLOSECANDIDATE

IMN_OPENCANDIDATE

Eingabemethoden-Manager

Funktionen des Eingabemethoden-Managers

Share via