PenInputPanel.InputFailed event

Deprecated. The PenInputPanel has been replaced by the Text Input Panel (TIP).

Occurs when input focus changes before the PenInputPanel object was able to insert user input into the attached control.

Syntax

HRESULT InputFailed(
  [in] long  hWnd,
  [in] long  Key,
  [in] BSTR  Text,
  [in] short ShiftKey
);

Parameters

hWnd [in]

The window handle of the control that invoked the PenInputPanel object.

Key [in]

The virtual key corresponding to the key pressed.

Text [in]

The string that was to be inserted into the control represented by the hWnd parameter when the InputFailed event was raised.

For more information about the BSTR data type, see Using the COM Library.

ShiftKey [in]

The state of the keyboard modifiers, including SHIFT, CAPS, CTRL, and ALT.

Return value

If this event succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The InputFailed event occurs when input focus changes before user input was inserted into the attached control. For example, if the user enters ink into the writing pad, then taps on another edit control before the recognizer has had a chance to finish, this event fires.

Using the window handle passed into this event, you can choose to insert the text yourself when this event occurs.

Requirements

See also

PenInputPanel