ImmConfigureIME

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_REGISTERWORD	Displays register word dialog box.
IME_CONFIG_SELECTDICTIONARY	Displays dictionary selection dialog box.

lpData

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

If dwMode is not IME_CONFIG_REGISTERWORD, 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.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in imm.h.
  Import Library: Use imm32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Input Method Editor Overview, Input Method Editor Functions