INPUTCONTEXT

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure holds the context information for IME input.

Syntax

typedef struct tagINPUTCONTEXT{
  HWND hWnd;
  BOOL fOpen;
  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.

• 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
  CANDIDATEFORM structures used by the IME user interface to create the candidate windows. This IMC supports 4 candidate forms.

• hCompStr
  Handle to the COMPOSITIONSTRING 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
  Number of messages stored in the hMsgBuf member.

• 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 DWORDs.

• fdwInit
  Initialize flag. When IME initializes the members of the INPUTCONTEXT structure, IME must set the bits of the member indicated by this flag. The following table shows the possible values that can be combined for this flag.

  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.

Requirements

Header	imm.h
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

CANDIDATEFORM
CANDIDATEINFO
CANDIDATELIST
COMPOSITIONFORM
COMPOSITIONSTRING
GUIDELINE

Other Resources

LOGFONT