Share via


InkOverlay.Enabled Property

Gets or sets a value that specifies whether the InkOverlay object collects pen input.

Namespace:  Microsoft.Ink
Assembly:  Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
<BrowsableAttribute(False)> _
Public Property Enabled As Boolean
'Usage
Dim instance As InkOverlay 
Dim value As Boolean 

value = instance.Enabled

instance.Enabled = value
[BrowsableAttribute(false)]
public bool Enabled { get; set; }
[BrowsableAttribute(false)]
public:
property bool Enabled {
    bool get ();
    void set (bool value);
}
public function get Enabled () : boolean 
public function set Enabled (value : boolean)

Property Value

Type: System.Boolean
Whether or not the InkOverlay object collects pen input.
true if the InkOverlay object collects pen input.
false if the InkOverlay object does not report pen input. No pen-related events fire.

Remarks

In addition to ink, pen input may include in-air packets, cursor in range events, and so on.

The InkOverlay object collects ink in Microsoft Windows Vista, Windows XP Tablet PC Edition or any edition of Windows 2000, Windows Server 2003, or Windows XP on which the Windows XP Tablet PC Edition SDK is installed. However, handwriting recognition occurs starting with Windows XP Tablet PC Edition. In any edition of Windows 2000, Windows Server 2003, or of Windows XP other than Windows XP Tablet PC Edition, the Enabled property is false if the Windows XP Tablet PC Edition SDK is not installed.

If the window input rectangle of an enabled InkCollector or InkOverlay (set in the constructor or with the SetWindowInputRectangle method) overlaps the window input rectangle of an InkOverlay, a COMException exception is thrown.

Note

Overlap can occur without an error as long as only one of the input rectangles is enabled at anytime.

While a control is not enabled, you receive no events.

When you set the Enabled property of a container control to false, all of its contained controls are disabled as well.

You cannot set the Enabled property to false while the object is collecting ink (CollectingInk property is true.).

The Enabled property must be set to false before setting or calling specific properties and methods of the object. If you try to change the specified properties or call the specified methods, an error occurs.

The following properties and methods cannot be set or called unless the Enabled property is first set to false:

You should set the Enabled property for an InkOverlay object to false before you shut down an application.

Examples

This C# example creates an InkOverlay object and enables it.

using Microsoft.Ink;
//...
InkOverlay theInkOverlay = new InkOverlay(Handle);
theInkOverlay.Enabled = true;
//...

This Microsoft Visual Basic .NET example creates an InkOverlay object and enables it.

Imports Microsoft.Ink
'...
Dim theInkOverlay As New InkOverlay(Handle)
theInkOverlay.Enabled() = True
'...

Platforms

Windows 7, Windows Vista, Windows Server 2008 R2, Windows Server 2008

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.0

See Also

Reference

InkOverlay Class

InkOverlay Members

Microsoft.Ink Namespace

InkOverlay.Handle

InkOverlay.Ink

InkOverlay.MarginX

InkOverlay.MarginY

InkOverlay.SetAllTabletsMode

InkOverlay.SetSingleTabletIntegratedMode

InkOverlay.CollectingInk