RECONVERTSTRING-Struktur (immdev.h)

Definiert die Zeichenfolgen für die IME-Reversion. Dies ist das erste Element in einem Speicherblock, das die Zeichenfolgen für die Reversion 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 die Kompositionszeichenfolge ist.

dwCompStrOffset

Offset der Zeichenfolge, die die Kompositionszeichenfolge ist.

dwTargetStrLen

Länge der Zeichenfolge, die sich auf die Zielklausel in der Kompositionszeichenfolge bezieht.

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. Zeichenanzahlen. 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 zuweisen. IME sollte diesen Arbeitsspeicher 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	immdev.h (einschließen immdev.h, Windows.h)

Weitere Informationen

IMR_CONFIRMRECONVERTSTRING

IMR_RECONVERTSTRING

ImmSetCompositionString

Eingabemethoden-Manager

Eingabemethoden-Manager-Strukturen