Platform SDK: International Features

IME Escapes

These escapes are used with the ImmEscape function.

Escape Description
IME_ESC_GET_EUDC_DICTIONARY Retrieves the path of the EUDC dictionary file. On input, the lpData parameter must be the pointer to the buffer to receive the path. This buffer must be equal to or greater than 80 * sizeof(TCHAR). On return, the buffer contains the null-terminated string specifying the full path of the dictionary. For use by the Chinese EUDC editor only; do not use in other applications.
IME_ESC_HANJA_MODE Converts from Hangeul to Hanja. On input, lpData must point to the buffer that contains the Hangeul character to convert; on output, it receives the converted Hanja as a null-terminated string. For use by the Korean editor; do not use in other applications.
IME_ESC_IME_NAME Retrieves the name of the IME. On input, the lpData parameter must be the pointer to the buffer to receive the name. On return, the buffer contains the null-terminated string specifying the IME name. For use by the Chinese EUDC editor only; do not use in other applications.

Windows 95/98: the buffer must be no less than 16*sizeof(TCHAR).

Windows NT/2000: the buffer must be no less than 64 characters.

IME_ESC_MAX_KEY Return value of the function is the maximum number of key stokes for an EUDC character. For use by the Chinese EUDC editor only; do not use in other applications.
IME_ESC_QUERY_SUPPORT Checks for implementation. On input, lpData points to the buffer that contains the IME Escape value. The function returns zero if the escape is not implemented.
IME_ESC_SEQUENCE_TO_INTERNAL Returns the character code that matches the specified sequence code. On input, the lpData parameter is the pointer to a 32-bit variable that contains the sequence code. For use by the Chinese EUDC editor only; do not use in other applications. Normally, the Chinese IME will encode its reading character codes into sequence 1 to n.
IME_ESC_SET_EUDC_DICTIONARY Sets the EUDC dictionary file. On input, the lpData parameter is the pointer to a null-terminated string specifying the full path. The path should be less than 80 * sizeof(TCHAR). For use by the Chinese EUDC editor only; do not use in other applications.
IME_ESC_GETHELPFILENAME Windows 98, Windows 2000 and later: Returns the name of the IME's help file. On return the lpData parameter is the full path of the IME's help file. The path should be less than 80 * sizeof(TCHAR).

The system reserves the escapes in the range IME_ESC_RESERVED_FIRST to IME_ESC_RESERVED_LAST for its own use.

The system reserves the escapes in the range IME_ESC_PRIVATE_FIRST to IME_ESC_PRIVATE_LAST for private use by IMEs.