Freigeben über


InkCollector.Handle-Eigenschaft

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

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

Syntax

'Declaration
Public Property Handle As IntPtr
'Usage
Dim instance As InkCollector
Dim value As IntPtr

value = instance.Handle

instance.Handle = value
public IntPtr Handle { get; set; }
public:
property IntPtr Handle {
    IntPtr get ();
    void set (IntPtr value);
}
/** @property */
public IntPtr get_Handle()
/** @property */
public  void set_Handle(IntPtr value)
public function get Handle () : IntPtr
public function set Handle (value : IntPtr)

Eigenschaftenwert

Typ: System.IntPtr
Das Fensterhandle, an das das InkCollector-Objekt angefügt ist.

Wert

Bedeutung

nullNULL-Verweis (Nothing in Visual Basic)

Das InkCollector-Objekt ist an kein Fenster angefügt (wenn AttachedControl ebenfalls den Wert nullNULL-Verweis (Nothing in Visual Basic) hat).

System.Windows.Forms.Control.Handle

Das Fensterhandle, 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 Steuerelement angefügt, dann wird durch die Festlegung dieser Eigenschaft das InkCollector-Objekt an ein Fenster angefügt und die AttachedControl-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.

ms571715.alert_security(de-de,VS.90).gifSicherheitshinweis:

Bei Verwendung mit teilweiser Vertrauenswürdigkeit sind für diese Eigenschaft die SecurityPermissionFlag.UnmanagedCode-Berechtigung sowie die von InkCollector 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.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0

Siehe auch

Referenz

InkCollector-Klasse

InkCollector-Member

Microsoft.Ink-Namespace

InkCollector.InkCollector

InkCollector.Enabled

InkCollector.AttachedControl