Calling WINNLSEnableIME() to Disable IME Temporarily

ID: Q112593


The information in this article applies to:
  • Microsoft Windows Far East Software Development Kit (FESDK) for Windows version 3.1


SUMMARY

An IME (input method editor) may be disabled by calling


    WINNLSEnableIME( NULL, FALSE ) 
from your application. However, the IME is turned on again when another control gains focus.


MORE INFORMATION

IME is enabled by default. To disable IME, call WINNLSEnableIME(NULL,FALSE) from your application. Please be aware that:

  • At this point, IME is disabled for the entire Windows system.


  • This status (IME disabled) is temporary--as soon as the focus is switched to another control (for example, another edit control), IME is turned on again. Most of the controls of Japanese Windows 3.1 have a functionality to enable IMEs as default.


To disable IME for a particular control, call WINNLSEnableIME(NULL,FALSE) each time this control gains focus. For example, if you want to disable IME for an edit control so that only ASCII characters can be entered, call WINNLSEnableIME(NULL,FALSE) on EN_SETFOCUS.

To enable IME, use WINNLSEnableIME(NULL,TRUE). Please note that the first parameter of WINNLSEnableIME, hWnd, is the application's HANDLE. Currently, the Windows system does not divide IME in each application by design, and therefore this parameter should be NULL.

Additional query words: 3.10

Keywords :
Version : :3.1
Platform :
Issue type :


Last Reviewed: December 23, 1999
© 2000 Microsoft Corporation. All rights reserved. Terms of Use.