ImmConfigureIME

[Now Supported on Windows NT]

The ImmConfigureIME function displays the configuration dialog box for the IME.

BOOL ImmConfigureIME(

HKL hKL,  
HWND hWnd,  
DWORD dwMode,  
LPVOID lpdata  
);  

Parameters

hKL

Handle to the keyboard layout.

hWnd

Handle to the parent window for the dialog box.

dwMode

Type of dialog box to display. This parameter can be one of the following values:

Value Meaning
IME_CONFIG_GENERAL Displays general purpose configuration dialog box.
IME_CONFIG_REGWORD Displays register word dialog box.
IME_CONFIG_SELECTDICTIONARY Displays dictionary selection dialog box.

lpData

Pointer to supplemental data. If dwMode is IME_CONFIG_REGWORD, this parameter must be the address of a REGISTERWORD structure.

If dwMode is not IME_CONFIG_REGWORD, this parameter is ignored.

Return Values

If the function succeeds, the return value is a nonzero value.

If the function fails, the return value is zero.

Remarks

The ImmConfigureIME function is called by the Control Panel.