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