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) |