IPenInputPanel::get_DefaultPanel method (peninputpanel.h)

Article
07/27/2022

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

Gets or sets the default panel type used for input within the PenInputPanel object.

This property is read/write.

Syntax

HRESULT get_DefaultPanel(
  PanelType *pDefaultPanel
);

Parameters

pDefaultPanel

Return value

None

Remarks

Note The DefaultPanel property cannot be set to Inactive.

The Handwriting panel-also known as the writing pad-is the default input UI for a PenInputPanel.

If the value of this property is Default, then the PenInputPanel object uses the last panel type used for any pen input panel in any application. If all previous references to the pen input panel have been destroyed in all active applications, a new PenInputPanel object uses the Handwriting panel type.

If the panel is changed by setting the CurrentPanel property before the PenInputPanel object becomes active for the first time, a PanelChanged event occurs.

Setting the DefaultPanel property enables you to specify which type of panel shows by default in that instance of the PenInputPanel object. If the value of this property is Handwriting or Keyboard, then each time the panel is made visible, it uses the handwriting or keyboard panel type, respectively.

If you re-attach the PenInputPanel to a different control and change the DefaultPanel property when the focus changes to the new control, be sure to set the DefaultPanel property before setting the AttachedEditWindow property to ensure that the correct panel is displayed.

Requirements

Requirement	Value
Minimum supported client	Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	peninputpanel.h
Library	InkObj.dll