Share via


Displaying or Hiding the Input Panel

4/19/2010

To programmatically show or hide the input panel, use the SHSipPreference function. The SHSipPreference function uses a timer when SIP_DOWN is used. If SIP_UP is called before the timer is triggered, the input panel remains in place, preventing it from appearing and disappearing as the user moves from control to control. SIP_FORCEDOWN immediately hides the input panel without using a timer.

The Windows Embedded CE WC_SIPPREF control is used to automatically implement default input panel behavior for a dialog box. Generally, any control in the system that accepts text input should display the input panel when the control gains focus and should hide the input panel when the control loses focus.

Note

The WC_SIPPREF control should be used as the last control in a dialog box template. To use the WC_SIPPREF control, the application must first call SHInitExtraControls.

When the WC_SIPPREF control is created, it enumerates all sibling controls. In addition, WC_SIPPREF implements the correct input panel behavior for each of the following controls:

  • Edit
  • Combo box (CBS_DROPDOWN style only)
  • CAPEDIT
  • SysDateTimePick32

When edit controls use WC_SIPPREF, they have automatic shortcut menu support for Cut, Copy, Paste, and so on.

See Also

Concepts

How to Access and Modify the Input Panel State

Other Resources

Input Panel Programming Overview