This documentation is archived and is not being maintained.

InkOverlay.AttachedControl Property

Gets or sets the control to which the InkOverlay object is attached.

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

[BrowsableAttribute(false)]
public Control AttachedControl { get; set; }

Property Value

Type: System.Windows.Forms.Control
The control to which the InkOverlay object is attached.

Value

Meaning

null

The InkOverlay object is not attached to a control.

System.Windows.Forms.Control

The control to which the InkOverlay object is attached.

The AttachedControl or Handle property must be set before the InkOverlay object can be enabled.

If the InkOverlay object is attached to a window handle, setting this property attaches the InkOverlay object to a control and clears the Handle property.

NoteNote:

The InkOverlay must be disabled before setting this property. To disable the InkOverlay, set the Enabled property to false. You can then set this property and re-enable the object by setting the Enabled property to true.

If you use the AttachedControl property and the Handle property in your application, you will get a security exception when you run the application in the Internet zone. This is because the Handle property is not valid in the partial trust environment of the Internet zone, so the Tablet PC operating system reverts to the AttachedControl property.

In this example, the AttachedControl property is used to invalidate the control that is used by the InkOverlay object.

// Note: mInkOverlay was instantiated via: new InkOverlay(control) 
// not via: new InkOverlay(control.Handle) - this .ctor does not set AttachedControl
mInkOverlay.AttachedControl.Invalidate();

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.

.NET Framework

Supported in: 3.0
Show: