INPUTCONTEXT

Syntax

typedef struct tagINPUTCONTEXT{
HWND hWnd;
BOOL fOpen;
DWORD fdwClient;
HWND hwndImeInUse;
POINT ptStatusWndPos;
POINT ptSoftKbdPos;
DWORD fdwConversion;
DWORD fdwSentence;
union{
LOGFONTA A;
LOGFONTW W;
} lfFont;
COMPOSITIONFORM cfCompForm;
CANDIDATEFORM cfCandForm[4];
HIMCC hCompStr;
HIMCC hCandInfo;
HIMCC hGuideLine;
HIMCC hPrivate;
DWORD dwNumMsgBuf;
HIMCC hMsgBuf;
DWORD fdwInit;
DWORD dwReserve[3]
}
INPUTCONTEXT, *PINPUTCONTEXT, NEAR *NPINPUTCONTEXT, FAR *LPINPUTCONTEXT;

Members

hWnd

Handle to the  window that uses the input context.

fOpen

Boolean that indicates the present status of the opened or closed IME.

fdwClient

hwndImeInUse

Handle to the input method editor (IME) control window.

ptStatusWndPos

Position of the status window.

ptSoftKbdPos

Position of the input panel.

fdwConversion

Conversion mode used by the IME composition engine.

fdwSentence

Sentence mode used by the IME composition engine.

lfFont

LOGFONT structure used by the IME user interface to draw the composition string.

cfCompForm

COMPOSITIONFORM structure used by the IME user interface to create the composition window.

cfCandForm[4]

CANDIDATEFORM structures used by the IME user interface to create the candidate windows. This IMC supports 4 candidate forms.

hCompStr

Handle to the COMPOSITIONSTR structure. This handle is available when there is the composition string.

hCandInfo

Handle to a memory block that contains the CANDIDATEINFO structure and CANDIDATELIST structures. This handle is available when there are the candidate strings.

hGuideLine

Handle to a memory block that contains the GUIDELINE structure. This handle is available when there is the guideline information.

hPrivate

Handle to a memory block used by IME for its private date area.

dwNumMsgBuf

Specifies the umber of messages stored in hMsgBuf.

hMsgBuf

Handle to the memory block that stores the messages. The format of this memory block is:

[Message1] [wParam1] [lParam1] {[Message2] [wParam2] [lParam2]{...{...{...}}}}

All values are double words.

fdwInit

Initialize flag. When IME initializes the members of the INPUTCONTEXT structure, IME must set the bits of the member indicated by this flag. It is a combination of the following values:

Value Description
INIT_STATUSWNDPOS Initializes ptStatusWndPos.
INIT_CONVERSION Initializes fdwConversion.
INIT_SENTENCE Initializes fdwSentence.
INIT_LOGFONT Initializes lfFont.
INIT_COMPFORM Initializes cfCompForm.
INIT_SOFTKBDPOS Initializes ptSoftKbdPos.

dwReserve

Reserved; set to zero.