Freigeben über

ImmNotifyIME-Funktion (immdev.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
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

  • Last updated on