IMESTRUCT-Struktur (ime.h)

Wird von SendIMEMessageEx verwendet, um die in der IME-Nachricht (Input Method Editor) auszuführende Unterfunktion und die zugehörigen Parameter anzugeben. Diese Struktur wird auch verwendet, um Rückgabewerte von diesen Unterfunktionen zu empfangen.

Syntax

typedef struct tagIMESTRUCT {
  UINT   fnc;
  WPARAM wParam;
  UINT   wCount;
  UINT   dchSource;
  UINT   dchDest;
  LPARAM lParam1;
  LPARAM lParam2;
  LPARAM lParam3;
} IMESTRUCT, *PIMESTRUCT, *NPIMESTRUCT, *LPIMESTRUCT;

Member

fnc

Eine Unterfunktion. Einer der folgenden Werte.

IME_ENTERWORDREGISTERMODE

Wird zum Registrieren von Wörtern verwendet. Wörter werden registriert, als eine Anwendung ein Wort und dessen Lesevorgang sendet. Strukturmember werden wie folgt interpretiert:

Der Rückgabewert gibt das Ergebnis der Wortregistrierung an. TRUE , wenn die Registrierung normal verarbeitet wurde; andernfalls FALSE.

Wenn Informationen wie ein Teil der Sprache erforderlich sind, sollte ein Dialogfeld angezeigt werden, um den Benutzer zur Eingabe aufzufordern. NULL kann in den Membern lParam1 und lParam2 angegeben werden. in diesem Fall sollte nichts im zugeordneten Eingabefeld im Dialogfeld angezeigt werden.

IME_GETCONVERSIONMODE

Ruft den aktuellen Konvertierungsmodus der IME ab. Dieses Unterprogramm verwendet keine Parameter.

Dies ist identisch mit IME_GET_MODE.

Gibt den aktuellen Konvertierungsmodus des IME als Kombination aus IME_MODE_ALPHANUMERIC zu IME_MODE_NOCODEINPUT zurück. Die Konvertierungsmodi sind wie folgt:

IME_GET_MODE

Identisch mit IME_GETCONVERSIONMODE.

IME_MOVECONVERTWINDOW

Identisch mit IME_SETCONVERSIONWINDOW.

IME_SETCONVERSIONFONTEX

Eine Schriftart, die verwendet werden soll, um eine unbestimmte Zeichenfolge anzuzeigen, die im Konvertierungsfenster angezeigt wird. Strukturmember werden wie folgt interpretiert:

Diese Unterfunktion hat keinen Rückgabewert.

Die von IME_SETCONVERSIONFONTEX angegebene Schriftart kann nur verwendet werden, um unbestimmte Zeichenfolgen anzuzeigen.

Verwenden Sie eine Systemschriftart, um nicht festgelegte Zeichenfolgen an der Standardposition anzuzeigen. Wenn die Anzeigeposition nicht mehr die Standardposition ist, aktivieren Sie die zuvor angegebene Schriftart.

Der globale Arbeitsspeicher, der die LOGFONT-Struktur enthält, wird von der Anwendung freigegeben.

Wenn der IME, der derzeit das Konvertierungsfenster anzeigt, den Befehl IME_SETCONVERSIONFONTEX empfängt und sich das Konvertierungsfenster durch den Befehl geändert hat, sollte die IME eine WM_IME_REPORT:IR_CHANGECONVERT-Nachricht senden. Diese Nachricht sollte nicht gesendet werden, wenn die von IME_SETCONVERSIONFONTEX angegebene Schriftart mit der schriftart identisch ist, die vom IME verwendet wird.

IME_SETCONVERSIONMODE

Legt den Konvertierungsmodus der IME fest. Das wParam-Element gibt mindestens einen der folgenden Werte an:

Der Rückgabewert gibt an, ob der angegebene Konvertierungsmodus erfolgreich eingerichtet wurde. Es gibt den Zustand des Konvertierungsmodus zurück, der zuvor in Kraft war, wenn der neue Konvertierungsmodus eingerichtet wurde. andernfalls NULL.

IME_SETCONVERSIONWINDOW

Die Größe und Position des umgebenden Rechtecks für die IME sowie die Anfangsposition des Konvertierungsfensters. Die IME zeigt eine unbestimmte Zeichenfolge an der von dieser Unterfunktion angegebenen Position an.

Das wParam-Element gibt einen der folgenden Werte an:

Der Rückgabewert gibt an, ob der Befehl ausgeführt wurde. TRUE , wenn die Befehlsausführung erfolgreich war; andernfalls FALSE.

Wenn eine nicht festgelegte Zeichenfolge das umgebende Rechteck zu überlaufen scheint, muss der IME die Berichtsnachricht WM_IME_REPORT:IR_FULLCONVERT an die Anwendung ausgeben, bevor diese Zeichenfolge angezeigt wird. Wenn die Anwendung diese Meldung nicht verarbeitet, wird die nachfolgende Verarbeitung für die Anzeige nicht in dieser Spezifikation formuliert, sondern der IME überlassen. Beispielsweise kann die unbestimmte Zeichenfolge innerhalb des umgebenden Rechtecks gescrollt oder vorübergehend an die Standardposition verschoben werden.

Wenn eine IME_SETCONVERSIONWINDOW Nachricht aufgerufen wird, wenn die IME eine unbestimmte Zeichenfolge enthält, sollte die IME eine WM_IME_REPORT:IR_CLOSECONVERT-Nachricht ausgeben. wenn die Zeichenfolge in das als Parameter angegebene Fenster passt, sollte die IME eine WM_IME_REPORT:IR_OPENCONVERT-Nachricht ausgeben. Erst dann sollte das Konvertierungsfenster gezeichnet werden. Wenn die Zeichenfolge nicht in das Fenster passt, sollte die IME eine WM_IME_REPORT:IR_FULLCONVERT-Meldung ausgeben.

Die Position des umgebenden Rechtecks kann außerhalb des physischen Bildschirmbereichs angegeben werden. Wenn sich das gesamte umgebende Rechteck außerhalb des physischen Bildschirms befindet, dürfen nicht festgelegte Zeichenfolgen nicht angezeigt werden. Wenn sich ein Teil des umgebenden Rechtecks außerhalb des physischen Bildschirms befindet, klammert die IME das umgebende Rechteck so ab, dass kein Teil der nicht bestimmten Zeichenfolge den Bildschirm überläuft, und passt auch die Startposition der Anzeige an.

Es wird empfohlen, die maximale Anzahl von Zeilen oder die maximale Anzahl von Zeichen, die im Konvertierungsfenster angezeigt werden, nicht festzulegen.

Wenn das Konvertierungsfenster ein Systemfenster überschneidet, muss das Konvertierungsfenster sichtbar sein. Beispielsweise kann das Konvertierungsfenster für die Anzeige oberste Priorität erhalten oder das Systemfenster an eine andere Stelle verschoben werden.

Die IME muss eine IR_CHANGECONVERT Nachricht senden, wenn sich das Konvertierungsfenster in Größe, Anzeigeinhalt oder Anzeigefarbe geändert hat. Wenn jedoch eine unbestimmte Zeichenfolge nicht in ein angegebenes Fenster passt, muss der IME eine IR_FULLCONVERT Nachricht senden, anstatt IR_CHANGECONVERT.

Wenn die IME aus dem MCW_WINDOW- oder MCW_SCREEN-Modus in MCW_DEFAULT verschoben wurde, muss sie eine IR_CLOSECONVERT Nachricht senden, wenn eine unbestimmte Zeichenfolge vorhanden ist.

Wenn die IME vom MCW_WINDOW- oder MCW_SCREEN-Modus in MCW_HIDDEN verschoben wurde, muss sie eine IR_CLOSECONVERT Nachricht senden, wenn eine unbestimmte Zeichenfolge vorhanden ist.

Wenn die IME vom MCW_HIDDEN Modus in MCW_DEFAULT, MCW_SCREEN oder MCW_WINDOW verschoben wurde, muss die IME eine IR_UNDETERMINE Nachricht mit nicht festgelegter Zeichenfolge = 0 und ermittelter Zeichenfolge = 0 übertragen.

IME_SETLEVEL

Koreanisch-spezifische Unterfunktion, die die IME-Ebene für die aktuelle Anwendung festlegt. Das wParam-Element akzeptiert einen der folgenden Ebenenwerte.

IME_SETOPEN

Legt die status des Kana-in-kanji-Konvertierungsfeatures des IME fest.

Das wParam-Element ist auf nonzero festgelegt, um die IME zu öffnen, und null, um die IME zu schließen.

Der Rückgabewert gibt den vorherigen status des Konvertierungsfeatures kana-in-kanji an. Gibt TRUE zurück, wenn geöffnet; andernfalls FALSE.

Eine nicht festgelegte Zeichenfolge darf nicht bestimmt werden, wenn das Kana-in-Kanji-Konvertierungsfeature von IME_SETOPEN geschlossen wurde.

Wenn die Kana-zu-Kanji-Konvertierungsfunktion von IME_SETOPEN geschlossen werden soll, muss die IME eine IR_CLOSECONVERT-Nachricht senden, wenn sich die IME im MCW_WINDOW- oder MCW-SCREEN-Modus befindet und ein Konvertierungsfenster geöffnet ist. Der IME muss jedoch keine IR_CLOSECONVERT ausstellen, wenn er sich im MCW_HIDDEN Modus befindet und eine unbestimmte Zeichenfolge vorhanden ist.

IME_SET_MODEK

Koreanisch-spezifische Version von IME_SETCONVERSIONMODE.

wParam

Die Nutzung hängt von der in fnc angegebenen Unterfunktion ab.

wCount

Die Nutzung hängt von der in fnc angegebenen Unterfunktion ab.

dchSource

Die Nutzung hängt von der in fnc angegebenen Unterfunktion ab.

dchDest

Die Nutzung hängt von der in fnc angegebenen Unterfunktion ab.

lParam1

Die Nutzung hängt von der in fnc angegebenen Unterfunktion ab.

lParam2

Die Nutzung hängt von der in fnc angegebenen Unterfunktion ab.

lParam3

Die Nutzung hängt von der in fnc angegebenen Unterfunktion ab.

Anforderungen

Weitere Informationen

Zwischenablage

Konzept

Referenz

SetClipboardData