ImmSIPanelState

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function performs operations relating to the input panel. It gets or sets state information, and communicates the caller's input attributes to the system.

Syntax

BOOL ImmSIPanelState(
  UINT dwCmd, 
  LPVOID pValue
);

Parameters

  • dwCmd
    [in] Value that specifies the operation that is to be performed by ImmSIPanelState. The following table shows the values this parameter can take.

    Value Description

    SIP_QUERY_LOCATION

    Query the location of input panel. pValue is the pointer to RECT that stores the location of input panel in screen coordinates.

    SIP_QUERY_STATE

    Query the state of input panel. Input panel can be in one of two states: hardware keyboard present and hardware keyboard not present. The pValue parameter is the pointer to DWORD, which can be either SIP_STATE_HDKB or SIP_STATE_NOHDKB.

    SIP_SET_LOCATION

    Set the location of the input panel. pValue is the pointer to POINT which is the new location of the input panel.

    SIP_INPUT_ATTRIBUTES

    Describe the caller's input attributes for the input panel. The pValue parameter can contain one of the following values:

    • SIP_INPUT_NUMERIC
    • SIP_INPUT_ALPHANUMERIC
    • SIP_INPUT_HIRAGANA
    • SIP_INPUT_KATAKANA
    • SIP_INPUT_EVERYTHING
    • SIP_INPUT_HALFWIDTH
    • SIP_INPUT_FULLWIDTH
  • pValue
    [in] Pointer to parameters associated with the operation specified in the dwCmd parameter.

Return Value

TRUE indicates success. FALSE indicates failure.

Remarks

This function is supported only for Japanese Windows CE 2.0.

Requirements

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

See Also

Other Resources

POINT
RECT