ImmDisableIME

[This is preliminary documentation and subject to change.]

The ImmDisableIME function disables the input method editor (IME) for a thread or all threads in a process.

BOOL ImmDisableIME(
  DWORD idThread   // thread to disable IME
);
 

Parameters

idThread

The thread for which the IME will be disabled. If idThread is zero, the IME for the current thread is disabled. If idThread is –1, the IME is disabled for all threads in the current process.

Return Values

If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE.

Remarks

The application must call this function before the first top-level window in the thread receives the WM_CREATE message. This means the application must call this function in one of the following places:

• Any time before calling CreateWindow to create the first top-level window
• In the first top-level window's WM_NCCREATE handler

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in imm.h.
  Import Library: Use imm32.lib.

See Also

Input Method Editor Overview, Input Method Editor Functions