InkOverlay-Klasse

Artikel
11/26/2008

Stellt ein Objekt dar, das in Anmerkungsszenarien nützlich ist, in denen es den Benutzern nicht um die Erkennung von Freihandeingaben, sondern um die Größe, Form, Farbe und Position der Freihandeingaben geht.

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

Syntax

'Declaration
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Class InkOverlay _
    Implements IDisposable
'Usage
Dim instance As InkOverlay

[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public class InkOverlay : IDisposable

[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public ref class InkOverlay : IDisposable

/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public class InkOverlay implements IDisposable

public class InkOverlay implements IDisposable

Hinweise

Warnung

Um einen Speicherverlust zu verhindern, müssen Sie die Dispose-Methode explizit für jedes InkOverlay-Objekt aufrufen, an das ein Ereignishandler angefügt wurde, bevor das Objekt den Gültigkeitsbereich verlässt.

Das InkOverlay-Objekt ist für die Erfassung von Notizen und einfachen Kritzeleien gut geeignet. Das Objekt ist im Wesentlichen dafür vorgesehen, Freihandeingaben als Freihandeingaben anzuzeigen.

Allgemein gesprochen ist die Laufzeitbenutzeroberfläche für dieses Objekt ein transparentes Fenster für nicht transparente Freihandeingaben.

Die Ereignisse MouseDown, MouseMove, MouseUp und MouseWheel geben die x- und y-Koordinaten in Pixeln zurück, nicht in HIMETRIC-Einheiten, die dem Freihandbereich zugeordnet sind. Die Ursache hierfür ist, dass diese Ereignisse die entsprechenden Mausereignisse von nicht freihandfähigen Anwendungen ersetzen und diese Anwendungen nur mit Pixeln umgehen können.

Warnung

Wenn Sie die AttachMode-Eigenschaft des InkOverlay-Objekts auf InFront festlegen, dann wird das InkOverlay-Objekt in dem Thread erstellt, in dem das Formular ausgeführt wird. Wenn das InkOverlay-Objekt in einem anderen Thread erstellt wurde und seine AttachMode-Eigenschaft auf InFront festgelegt ist, dann reagiert Ihre Anwendung möglicherweise nicht mehr.

Hinweis

Das InkOverlay-Objekt kann in einem Thread ohne Bezug zur Benutzeroberfläche nicht sicher freigegeben werden.

Entfernen Sie ein nicht mehr benötigtes InkOverlay-Objekt manuell, um die Leistung der Anwendung zu verbessern.

Sicherheitshinweis:
Bei Verwendung mit teilweiser Vertrauenswürdigkeit ist für diese Klasse und alle ihre Methoden die UIPermissionWindow.SafeTopLevelWindows-Berechtigung erforderlich. Weitere Informationen finden Sie unter Security and Trust.

Vererbungshierarchie

System.Object
Microsoft.Ink.InkOverlay

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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.