InkOverlay.AttachedControl-Eigenschaft

Artikel
10/28/2008

Ruft das Steuerelement ab, an das das InkOverlay-Objekt angefügt ist, oder legt dieses Steuerelement fest.

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);
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public Control get_AttachedControl()
/** @property */
/** @attribute BrowsableAttribute(false) */
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 InkOverlay-Objekt angefügt ist.

Wert	Bedeutung
nullNULL-Verweis (Nothing in Visual Basic)	Das InkOverlay-Objekt ist an kein Steuerelement angefügt.
System.Windows.Forms.Control	Das Steuerelement, an das das InkOverlay-Objekt angefügt ist.

Hinweise

Die AttachedControl- oder die Handle-Eigenschaft muss festgelegt werden, bevor das InkOverlay-Objekt aktiviert werden kann.

Ist das InkOverlay-Objekt einem Fensterhandle zugeordnet, dann wird durch die Festlegung dieser Eigenschaft das InkOverlay-Objekt einem Steuerelement zugeordnet und die Handle-Eigenschaft gelöscht.

Hinweis

Das InkOverlay-Objekt muss vor dem Festlegen dieser Eigenschaft deaktiviert werden. Um den InkOverlay 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 von dem InkOverlay-Objekt verwendete Steuerelement für ungültig zu erklären.

' 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();

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.