ImmGetProperty-Funktion (imm.h)

  • Artikel

Ruft die Eigenschaft und Die Funktionen der IME ab, die dem angegebenen Eingabegebietsschema zugeordnet sind.

Syntax

DWORD ImmGetProperty(
       HKL   unnamedParam1,
       DWORD unnamedParam2
);

Parameter

unnamedParam1

unnamedParam2

Rückgabewert

Gibt abhängig vom Wert des dwIndex-Parameters die Eigenschaft oder den Funktionswert zurück. Wenn dwIndex auf IGP_PROPERTY festgelegt ist, gibt die Funktion mindestens einen der folgenden Werte zurück:

Wert Bedeutung
IME_PROP_AT_CARET Wenn festgelegt, befindet sich das Konvertierungsfenster an der Caret-Position. Wenn es deaktiviert ist, befindet sich das Fenster in der Nähe der Caret-Position.
IME_PROP_SPECIAL_UI Wenn festgelegt, verfügt die IME über eine nicht standardmäßige Benutzeroberfläche. Die Anwendung sollte nicht im IME-Fenster zeichnen.
IME_PROP_CANDLIST_START_FROM_1 Wenn festgelegt, werden Zeichenfolgen in der Kandidatenliste ab 1 nummeriert. Wenn sie klar sind, beginnen Zeichenfolgen bei 0.
IME_PROP_UNICODE Wenn festgelegt, wird die IME als Unicode-IME angezeigt. Betriebssystem und IME kommunizieren über die Unicode-IME-Schnittstelle. Wenn dies klar ist, verwendet die IME die ANSI-Schnittstelle, um mit dem Betriebssystem zu kommunizieren.
IME_PROP_COMPLETE_ON_UNSELECT Wenn festgelegt, schließt der IME die Kompositionszeichenfolge ab, wenn die IME deaktiviert ist. Wenn dies klar ist, bricht die IME die Kompositionszeichenfolge ab, wenn die IME deaktiviert wird, z. B. bei einer Tastaturlayoutänderung.
IME_PROP_ACCEPT_WIDE_VKEY Falls festgelegt, verarbeitet der IME das eingefügte Unicode, das von der SendInput-Funktion stammt, mithilfe von VK_PACKET. Wenn dies nicht möglich ist, verarbeitet der IME möglicherweise das eingefügte Unicode nicht und sendet das eingefügte Unicode möglicherweise direkt an die Anwendung.
 

Wenn dwIndex auf IGP_UI festgelegt ist, gibt die Funktion mindestens einen der folgenden Werte zurück:

Wert Bedeutung
UI_CAP_2700 Unterstützt Text-Escapementwerte von 0 oder 2700. Weitere Informationen finden Sie im lfEscapement-Member der LOGFONT-Struktur .
UI_CAP_ROT90 Unterstützt Text-Escapementwerte von 0, 900, 1800 oder 2700. Weitere Informationen finden Sie unter lfEscapement.
UI_CAP_ROTANY Unterstützen Sie alle Text-Escapementwerte. Weitere Informationen finden Sie unter lfEscapement.
 

Wenn dwIndex auf IGP_SETCOMPSTR festgelegt ist, gibt die Funktion mindestens einen der folgenden Werte zurück:

Wert Bedeutung
SCS_CAP_COMPSTR Erstellen Sie die Kompositionszeichenfolge, indem Sie die Funktion ImmSetCompositionString mit dem wert SCS_SETSTR aufrufen.
SCS_CAP_MAKEREAD Erstellen Sie die Lesezeichenfolge aus der entsprechenden Kompositionszeichenfolge, wenn Sie die Funktion ImmSetCompositionString mit SCS_SETSTR und ohne Festlegen von lpRead verwenden.
SCS_CAP_SETRECONVERTSTRING: Diese IME kann die Reversion unterstützen. Verwenden Sie ImmSetCompositionString , um eine Reversion zu durchführen.
 

Wenn dwIndex auf IGP_SELECT festgelegt ist, gibt die Funktion mindestens einen der folgenden Werte zurück:

Wert Bedeutung
SELECT_CAP_CONVMODE Erben Sie den Konvertierungsmodus, wenn eine neue IME ausgewählt ist.
SELECT_CAP_SENTENCE Satzmodus erben, wenn eine neue IME ausgewählt ist.
 

Wenn dwIndex auf IGP_GETIMEVERSION festgelegt ist, gibt die Funktion mindestens einen der folgenden Werte zurück:

Wert Bedeutung
IMEVER_0310 Die IME wurde für Windows 3.1 erstellt.
IMEVER_0400 Die IME wurde für Windows Me/98/95 erstellt.

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 imm.h (include Immdev.h, Windows.h)
Bibliothek Imm32.lib
DLL Imm32.dll

Weitere Informationen

ImmSetCompositionString

Eingabemethoden-Manager

Funktionen des Eingabemethoden-Managers