INPUTCONTEXT (Windows CE 5.0)

Send Feedback

This structure holds the context information for IME input.

typedefstructtagINPUTCONTEXT{HWNDhWnd;BOOLfOpen;HWNDhwndImeInUse;POINTptStatusWndPos;POINTptSoftKbdPos;DWORDfdwConversion;DWORDfdwSentence;union{LOGFONTAA;LOGFONTWW;}lfFont;COMPOSITIONFORMcfCompForm;CANDIDATEFORMcfCandForm[4];HIMCChCompStr;HIMCChCandInfo;HIMCChGuideLine;HIMCChPrivate;DWORDdwNumMsgBuf;HIMCChMsgBuf;DWORDfdwInit;DWORDdwReserve[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 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
    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

OS Versions: Windows CE .NET 4.0 and later.
Header: Imm.h.

See Also

CANDIDATEFORM | CANDIDATEINFO | CANDIDATELIST | COMPOSITIONFORM | COMPOSITIONSTR | GUIDELINE | LOGFONT

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.