InkCollector.AttachedControl-Eigenschaft
Ruft das Steuerelement ab, an das das InkCollector-Objekt angefügt ist, oder legt dieses Steuerelement fest.
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);
}
/** @property */
public Control get_AttachedControl()
/** @property */
public void set_AttachedControl(Control value)
public function get AttachedControl () : Control
public function set AttachedControl (value : Control)
Eigenschaftenwert
Typ: System.Windows.Forms.Control
Das Steuerelement, an das das InkCollector-Objekt angefügt ist.
Wert |
Bedeutung |
|---|---|
nullNULL-Verweis (Nothing in Visual Basic) |
Das InkCollector-Objekt ist an kein Steuerelement angefügt. |
System.Windows.Forms.Control |
Das Steuerelement, an das das InkCollector-Objekt angefügt ist. |
Hinweise
Die AttachedControl- oder die Handle-Eigenschaft muss festgelegt werden, bevor das InkCollector-Objekt aktiviert werden kann.
Ist das InkCollector-Objekt an ein Fensterhandle angefügt, dann wird durch die Festlegung dieser Eigenschaft das InkCollector-Objekt an ein Steuerelement angefügt und die Handle-Eigenschaft gelöscht.
Hinweis
Das InkCollector-Objekt muss vor dem Festlegen dieser Eigenschaft deaktiviert werden. Um den InkCollector zu deaktivieren, legen Sie die Enabled-Eigenschaft auf false fest. Sie können diese Eigenschaft festlegen und dann das Objekt erneut aktivieren, indem Sie die Enabled-Eigenschaft auf true festlegen.
Wenn Sie in Ihrer Anwendung die AttachedControl-Eigenschaft und die Handle-Eigenschaft verwenden, wird eine Sicherheitsausnahme ausgelöst, wenn Sie die Anwendung in der Internetzone ausführen. Die Ursache hierfür ist, dass die Handle-Eigenschaft in der teilweise vertrauenswürdigen Umgebung der Internetzone nicht gültig ist, sodass das Tablet PC-Betriebssystem auf die AttachedControl-Eigenschaft zurückgreift.
Beispiele
In diesem Beispiel wird die AttachedControl-Eigenschaft verwendet, um das vom InkCollector-Objekt verwendete Steuerelement für ungültig zu erklären.
' 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();
Plattformen
Windows Vista
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Versionsinformationen
.NET Framework
Unterstützt in: 3.0