InkCollector.AttachedControl Property
Gets or sets the control to which the InkCollector object is attached.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Syntax
'Declaration
Public Property AttachedControl As Control
'Usage
Dim instance As InkCollector
Dim value As Control
value = instance.AttachedControl
instance.AttachedControl = value
public Control AttachedControl { get; set; }
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 InkCollector object is attached.
Value |
Meaning |
|---|---|
nulla null reference (Nothing in Visual Basic) |
The InkCollector object is not attached to a control. |
System.Windows.Forms.Control |
The control to which the InkCollector object is attached. |
Remarks
The AttachedControl or Handle property must be set before the InkCollector object can be enabled.
If the InkCollector object is attached to a window handle, setting this property attaches the InkCollector to a control and clears the Handle property.
Note
The InkCollector must be disabled before setting this property. To disable the InkCollector, 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 InkCollector object.
' Note: mInkCollector was instantiated via: new InkCollector(control)
' not via: new InkCollector(control.Handle) - this .ctor does not set AttachedControl
mInkCollector.AttachedControl.Invalidate()
// Note: mInkCollector was instantiated via: new InkCollector(control)
// not via: new InkCollector(control.Handle) - this .ctor does not set AttachedControl
mInkCollector.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