ImeEscape


LRESULT ImeEscape(HIMC hIMC, UINT uEscape, LPVOID lpData)

Allows an application to access the capabilities of a particular IME that are not directly available though other IMM functions. This is necessary mainly for country-specific functions or private functions in IME.

hIMC

Handle of the input context.

uEscape

Escape function to perform. Each escape function should include parameter validation. Can be one of these values:

IME_ESC_QUERY _SUPPORT

Checks for implementation. If this escape is not implemented, the return value is zero.

IME_ESC_RESERVED_FIRST

The escape between IME_ESC_RESERVED_FIRST and IME_ESC_RESERVED_LAST is reserved by the system.

IME_ESC_RESERVED_LAST

The escape between IME_ESC_RESERVED_FIRST and IME_ESC_RESERVED_LAST is reserved by the system.

IME_ESC_PRIVATE_FIRST

The escape between IME_ESC_PRIVATE_FIRST and IME_ESC_PRIVATE_LAST is reserved for the IME. IME can freely use these escape functions for its own purposes.

IME_ESC_PRIVATE_LAST

The escape between IME_ESC_PRIVATE_FIRST and IME_ESC_PRIVATE_LAST is reserved for the IME. IME can freely use these escape functions for its own purposes.

IME_ESC_SEQUENCE_TO_INTERNAL

The escape is Chinese-specific. An application that needs to run under all Far East platforms should not use it. It is for the Chinese EUDC editor. The lpData parameter is the sequence code, and the return value is the character code for this sequence code. Normally, the Chinese IME encodes its reading character codes into sequence 1 to n.

IME_ESC_GET_EUDC_DICTIONARY

The escape is Chinese-specific. An application that needs to run under all Far East platforms should not use it. It is for the Chinese EUDC editor. On return from the function, the lpData is filled with the full path file name of EUDC dictionary. The size of the buffer pointed by lpData should be greater or equal to 80 * sizeof(TCHAR).

IME_ESC_SET_EUDC_DICTIONARY

The escape is Chinese-specific. An application that needs to run under all Far East platforms should not use it. It is for Chinese the EUDC editor. On return from the function, the lpData is the full path file name of the EUDC dictionary. The path name should be less than 80 * sizeof(TCHAR).

IME_ESC_MAX_KEY

The escape is Chinese-specific. An application that needs to run under all Far East platforms should not use it. It is for the Chinese EUDC editor. The return value is the maximum key stokes for an EUDC character.

IME_ESC_IME_NAME

The escape is Chinese-specific. An application that needs to run under all Far East platforms should not use it. It is for the Chinese EUDC editor. On return from the function, the lpData is the IMEname to be displayed on the EUDC editor. The size of the buffer pointed by lpData should be greater or equal to 16 * sizeof(TCHAR).

IME_ESC_SYNC_HOTKEY

The escape is (Traditional) Chinese-specific. An application that needs to run under all Far East platforms should not use it. It is to synchronize between different IMEs. The input parameter lpData is the IME private hot key ID. If this ID is 0, this IME should check every private hot key ID it concerns.

IME_ESC_HANJA_MODE

The escape is Korean-specific. An application that needs to run under all Far East platforms should not use it. It is for conversion from Hangeul to Hanja. The input parameter lpData is filled with Hangeul character which will be converted to Hanja, and it's null terminated string. When the application needs to convert any Hangeul character to Hanja character in the same method of Hanja conversion with composition character is present, the application just requests this function and IME sets itself as Hanja conversion mode.


lpData

Address of the data required for the escape function specified by uEscape.