Freigeben über


RECONVERTSTRING-Struktur (imm.h)

Definiert die Zeichenfolgen für die IME-Reversion. Dies ist das erste Element in einem Speicherblock, das die Zeichenfolgen für die Wiederherstellung enthält.

Syntax

typedef struct tagRECONVERTSTRING {
  DWORD dwSize;
  DWORD dwVersion;
  DWORD dwStrLen;
  DWORD dwStrOffset;
  DWORD dwCompStrLen;
  DWORD dwCompStrOffset;
  DWORD dwTargetStrLen;
  DWORD dwTargetStrOffset;
} RECONVERTSTRING, *PRECONVERTSTRING, *NPRECONVERTSTRING, *LPRECONVERTSTRING;

Members

dwSize

Größe dieser Struktur und des Speicherblocks, den sie leitet.

dwVersion

Versionsnummer: Muss den Wert 0 (null) haben.

dwStrLen

Länge der Zeichenfolge, die die Kompositionszeichenfolge enthält.

dwStrOffset

Offset von der Startposition dieser Struktur.

dwCompStrLen

Länge der Zeichenfolge, die der Kompositionszeichenfolge entspricht.

dwCompStrOffset

Offset der Zeichenfolge, die die Kompositionszeichenfolge ist.

dwTargetStrLen

Länge der Zeichenfolge, die mit der Target-Klausel in der Kompositionszeichenfolge verknüpft ist.

dwTargetStrOffset

Offset der Zielzeichenfolge.

Hinweise

Die Elemente dwCompStrOffset und dwTargetOffset sind die relativen Positionen in dwStrOffset. Für einen Unicode-IME sind dwStrLen, dwCompStrLen und dwTargetStrLen TCHAR-Werte, d. h. die Zeichenanzahl. Die Member dwStrOffset, dwCompStrOffset und dwTargetStrOffset geben die Byteanzahl an.

Wenn eine Anwendung den Reversionsprozess durch Aufrufen von ImmSetCompositionString mit SCS_SETRECONVERTSTRING und SCS_QUERYRECONVERTSTRING startet, muss die Anwendung den erforderlichen Arbeitsspeicher für die RECONVERTSTRING-Struktur sowie den Kompositionszeichenfolgenpuffer zuordnen. IME sollte diesen Speicher später nicht mehr verwenden. Wenn IME den Prozess startet, sollte IME den erforderlichen Arbeitsspeicher für die Struktur und den Kompositionszeichenfolgenpuffer zuweisen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile imm.h (include Immdev.h, Windows.h)

Weitere Informationen

IMR_CONFIRMRECONVERTSTRING

IMR_RECONVERTSTRING

ImmSetCompositionString

Eingabemethoden-Manager

Strukturen des Eingabemethoden-Managers