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)
Syntax
'Declaration
<BrowsableAttribute(False)> _
Public Property AttachedControl As Control
'Usage
Dim instance As InkOverlay
Dim value As Control
value = instance.AttachedControl
instance.AttachedControl = value
[BrowsableAttribute(false)]
public Control AttachedControl { get; set; }
[BrowsableAttribute(false)]
public:
property Control^ AttachedControl {
Control^ get ();
void set (Control^ value);
}
public function get AttachedControl () : Control
public function set AttachedControl (value : Control)
Property Value
Type: System.Windows.Forms.Control
The control to which the InkOverlay object is attached.
Value |
Meaning |
|---|---|
nulla null reference (Nothing in Visual Basic) |
The InkOverlay object is not attached to a control. |
The control to which the InkOverlay object is attached. |
Remarks
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.
Note
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.
Examples
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()
// Note: mInkOverlay was instantiated via: new InkOverlay(control)
// not via: new InkOverlay(control.Handle) - this .ctor does not set AttachedControl
mInkOverlay.AttachedControl.Invalidate();
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