InkOverlay.Handle-Eigenschaft

Artikel
11/26/2008

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

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

Syntax

'Declaration
<BrowsableAttribute(False)> _
Public Property Handle As IntPtr
'Usage
Dim instance As InkOverlay
Dim value As IntPtr

value = instance.Handle

instance.Handle = value

[BrowsableAttribute(false)]
public IntPtr Handle { get; set; }

[BrowsableAttribute(false)]
public:
property IntPtr Handle {
    IntPtr get ();
    void set (IntPtr value);
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public IntPtr get_Handle()
/** @property */
/** @attribute BrowsableAttribute(false) */
public  void set_Handle(IntPtr value)

public function get Handle () : IntPtr
public function set Handle (value : IntPtr)

Eigenschaftenwert

Typ: System.IntPtr
Das Handle des Fensters, an das das InkOverlay-Objekt angefügt ist.

Wert	Bedeutung
nullNULL-Verweis (Nothing in Visual Basic)	Das InkOverlay-Objekt ist an kein Fenster angefügt (wenn AttachedControl ebenfalls den Wert nullNULL-Verweis (Nothing in Visual Basic) hat).
System.Windows.Forms.	Das Handle des Fensters, 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 Steuerelement zugeordnet, dann wird durch die Festlegung dieser Eigenschaft das InkOverlay-Objekt einem Fenster zugeordnet und die AttachedControl-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.

Sicherheitshinweis:
Bei Verwendung mit teilweiser Vertrauenswürdigkeit sind für diese Eigenschaft die SecurityPermissionFlag.UnmanagedCode-Berechtigung sowie die von InkOverlay geforderten Berechtigungen erforderlich. Weitere Informationen finden Sie unter Security and Trust.

Beispiele

Im folgenden Beispiel wird eine Methode gezeigt, mittels derer entweder ein InkCollector-Objekt oder ein InkOverlay-Objekt angewiesen werden kann, Freihandeingaben für ein neues Steuerelement zu erfassen.

Private Sub SwitchInkObjectHandle(ByVal collectingControl As Control)
    ' mInkObject can be InkCollector or InkOverlay
    mInkObject.Enabled = False
    ' setting the Handle property sets the AttachedControl property to null
    mInkObject.Handle = collectingControl.Handle
    mInkObject.Enabled = True
End Sub

private void SwitchInkObjectHandle(Control collectingControl)
{
    // mInkObject can be InkCollector or InkOverlay
    mInkObject.Enabled = false;
    // setting the Handle property sets the AttachedControl property to null
    mInkObject.Handle = collectingControl.Handle;
    mInkObject.Enabled = true;
}

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.