ImmConfigureIME

The ImmConfigureIME function displays the configuration dialog box for the IME of the specified input locale identifier (HKL).

BOOL ImmConfigureIME(
  HKL hKL,       
  HWND hWnd,     
  DWORD dwMode,  
  LPVOID lpData  
);

Parameters

hKL

[in] Input locale identifier of an IME.

hWnd

[in] Handle to the parent window for the dialog box.

dwMode

[in] Specifies the type of dialog box to be displayed. 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

[in] Pointer to supplemental data. If dwMode is IME_CONFIG_REGISTERWORD, this parameter must be a pointer to 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.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Imm.h.
  Library: Use Imm32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000.

See Also

Input Method Editor Overview, Input Method Editor Functions, REGISTERWORD