RECONVERTSTRING

The RECONVERTSTRING structure defines the strings for IME reconversion. It is the first item in a memory block that contains the strings for reconversion.

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

Members

dwSize

Specifies the size of this structure and the memory block it heads.

dwVersion

Specifies the version number. Must be zero.

dwStrLen

Specifies the length of the string that contains the composition string.

dwStrOffset

Specifies the offset from the start position of this structure.

dwCompStrLen

Specifies the length of the string that will be the composition string.

dwCompStrOffset

Specifies the offset of the string that will be the composition string.

dwTargetStrLen

Specifies the length of the string that is related to the target clause in the composition string.

dwTargetStrOffset

Specifies the offset of the target string.

Remarks

The dwCompStrOffset and dwTargetOffset parameters are the relative positions in dwStrOffset. For a Unicode IME, dwStrLen , dwCompStrLen, and dwTargetStrLen are TCHAR counts; and dwStrOffset, dwCompStrOffset, and dwTargetStrOffset are byte counts.

If an application starts the reconversion process—by calling ImmSetCompositionString with SCS_SETRECONVERTSTRING and SCS_QUERYRECONVERTSTRING—the application must allocate the necessary memory for the RECONVERTSTRING structure as well as the composition string buffer. IME should not use this memory later. If IME starts the process, IME should allocate necessary memory for the structure and the composition string buffer.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 98.
  Header: Declared in Imm.h.

See Also

Input Method Editor Overview, Input Method Editor Structures, ImmSetCompositionString, IMR_CONFIRMRECONVERTSTRING, IMR_RECONVERTSTRING