PenInputPanel.AutoShow Property

  • Article

PenInputPanel.AutoShow Property

Gets or sets a Boolean value that indicates whether the pen input panel appears when focus is set on the attached control by using the pen.

Definition

Visual Basic .NET Public Property AutoShow As Boolean
C# public bool AutoShow { get; set; }
Managed C++ public: __property bool* get_AutoShow();
public: __property void set_AutoShow(bool*);

Property Value

System.Boolean. Whether the pen input panel appears when focus is set by using the pen.

This property is read/write.

true Default. The pen input panel appears when focus is set using the pen.
false The pen input panel's appearance is controlled by the Visible property, rather than by whether or not the attached control has focus.

Exceptions

COMException Leave Site:
ObjectDisposedException Leave Site:

Remarks

Setting the AutoShow property to false disables activation of the pen input panel when the end user sets the focus to the attached control by using the pen.

If AutoShow is set to false, the Visible property controls the visibility of the pen input panel. Additionally, the PenInputPanel object must be properly attached to a window or control in order to display in the user interface.

When the AutoShow property is set to True, Tablet PC Input Panel does not show until the Visible property is set to True. At this point, Input Panel is displayed but no hover target is shown.

Examples

[C#]

This C# example creates a PenInputPanel object, thePenInputPanel, and attaches it to an InkEdit control, theInkEdit. It disables automatic activation of the pen input panel by setting the AutoShow property to false.

// Declare, create, and attach a new PenInputPanel to an InkEdit control
PenInputPanel thePenInputPanel = new PenInputPanel(theInkEdit);

// Turn off AutoShow
thePenInputPanel.AutoShow = false;

[Visual Basic .NET]

This Microsoft® Visual Basic® .NET example creates a PenInputPanel object, thePenInputPanel, and attaches it to an InkEdit control, theInkEdit. It disables automatic activation of the pen input panel by setting the AutoShow property to False.

' Declare, create, and attach a new PenInputPanel to an InkEdit control
Dim thePenInputPanel As New PenInputPanel(theInkEdit)

' Turn off AutoShow
thePenInputPanel.AutoShow = False

See Also