IME Window functions
[Windowing functions]

Defines

• #define GBIMEWindow(hosting)   GBIMEWindowEx(hosting, 0, 0, 0, 0, TRUE)

  The simplified version of GBIMEWindowEx.
  

Functions

• int GBIMEWinProc (HWND hWnd, int message, WPARAM wParam, LPARAM lParam)

  The window callback procedure of the builit-in GB2312 Input Method window.
  

• MG_EXPORT HWND GBIMEWindowEx (HWND hosting, int lx, int ty, int rx, int by, BOOL two_lines)

  Creates a GB2312 input method window.
  

• MG_EXPORT int GUIAPI RegisterIMEWindow (HWND hWnd)

  Registers an IME window.
  

• MG_EXPORT int GUIAPI UnregisterIMEWindow (HWND hWnd)

  Unregisters an IME window.
  

• MG_EXPORT int GUIAPI GetIMEStatus (int StatusCode)

  Retrives status of the current IME window.
  

• MG_EXPORT int GUIAPI SetIMEStatus (int StatusCode, int Value)

  Sets the status of the current IME window.
  

---

Define Documentation

#define GBIMEWindow (  hosting   )     GBIMEWindowEx(hosting, 0, 0, 0, 0, TRUE)

The simplified version of GBIMEWindowEx. Parameters: hosting  The hosting window of the IME window. Returns: The handle to the IME window. Note: For MiniGUI-Threads, GBIMEWindow defined as a function: HWND GBIMEWindow (HWND hosting); Note: Calling this function will create a thread and start the GB2312 IME window in this thread. See also: GBIMEWindowEx Definition at line 5388 of file window.h.

---

Function Documentation

HWND GBIMEWindowEx (  HWND  hosting, int  lx, int  ty, int  rx, int  by, BOOL  two_lines )

Creates a GB2312 input method window. This function creates a GB2312 (a charset for simplified Chinese) input method window. Before calling this window, you must create a main window which acts as the hosting main window of the IME window. Parameters: hosting  The hosting window of the IME window. Do not set it to be HWND_DESKTOP. lx  lx,ty,rx,by: The position and size of the IME window. ty  lx,ty,rx,by: The position and size of the IME window. rx  lx,ty,rx,by: The position and size of the IME window. by  lx,ty,rx,by: The position and size of the IME window. two_lines  Indicates whether the IME window contains two lines. Returns: The handle to the IME window. Note: This function only define for MiniGUI-Lite. See also: GBIMEWindow

int GBIMEWinProc (  HWND  hWnd, int  message, WPARAM  wParam, LPARAM  lParam )

The window callback procedure of the builit-in GB2312 Input Method window. This function is the window callback procedure of the built-in GB2312 (a charset for simplified Chinese) Input Method window. Note: This function defined for _IME_GB2312. You can disable GB2312 IME support by using ./configure --disable-imegb2312 See also: GBIMEWindowEx

int GUIAPI GetIMEStatus (  int  StatusCode  )

Retrives status of the current IME window. This function retrives status of the current IME window. Parameters: StatusCode  The item to be retrived, can be one of the following values: IS_ENABLE Is the IME window enabled? IS_FULLCHAR Whether translate half character to full character? IS_FULLPUNC Whether tranlsate half punctuate mark to full mark? IS_METHOD Which input method? Returns: The status of the item specified by StatusCode, ERR_IME_NOIMEWND if error occurred. See also: SetIMEStatus

int GUIAPI RegisterIMEWindow (  HWND  hWnd  )

Registers an IME window. This function registers the specified window hWnd as the IME window of the MiniGUI. After that, the keyboard input will be sent to IME window first. Note that only one IME window can be registered. Parameters: hWnd  The handle to your IME window. Returns: ERR_OK on success, otherwise less than zero. Return values: ERR_OK  Success. ERR_IME_TOOMUCHIMEWND  Already have an IME window registered. ERR_INV_HWND  Invalid main window handle. See also: UnregisterIMEWindow

int GUIAPI SetIMEStatus (  int  StatusCode, int  Value )

Sets the status of the current IME window. This function sets the status of the current IME window. Parameters: StatusCode  The item to be set, can be one of the following values: IS_ENABLE Enabled or disable IME window. IS_FULLCHAR Whether translate half character to full character? IS_FULLPUNC Whether tranlsate half punctuate mark to full mark? IS_METHOD Which input method? Value  The status value of the item. Returns: ERR_OK on success, otherwise less than zero. Return values: ERR_OK  Success. ERR_IME_NOIMEWND  There is no any IME window registered. See also: GetIMEStatus

int GUIAPI UnregisterIMEWindow (  HWND  hWnd  )

Unregisters an IME window. This function undoes the effect of RegisterIMEWindow. Parameters: hWnd  The handle to the current IME window. Returns: ERR_OK on success, otherwise less than zero. Return values: ERR_OK  Success. ERR_IME_NOSUCHIMEWND  The window is not the current IME window. See also: RegisterIMEWindow

---