InkPicture-Klasse
Das InkPicture-Steuerelement bietet die Möglichkeit, ein Bild in eine Anwendung zu stellen, und ermöglicht es Benutzern, Freihandeingaben auf diesem Bild zu machen. Es ist für Szenarien gedacht, in denen Freihandeingaben nicht als Text erkannt, sondern stattdessen als Freihandeingabe gespeichert werden.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Syntax
'Declaration
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
Public Class InkPicture _
Inherits PictureBox
'Usage
Dim instance As InkPicture
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
public class InkPicture : PictureBox
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
public ref class InkPicture : public PictureBox
/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
public class InkPicture extends PictureBox
public class InkPicture extends PictureBox
Hinweise
Warnung
Sie müssen die Dispose-Methode für dieses Objekt aufrufen, bevor es den Gültigkeitsbereich verlässt. Dieses Objekt verwaltet nicht verwaltete Ressourcen. Dieses Objekt ausschließlich von der Finalisierung behandeln zu lassen, kann zu Speicherverlusten und Ausnahmen in der Anwendung führen.
Ein Beispiel für das Freigeben von verwalteten Objekten finden Sie unter Using the Managed Library.
Die Laufzeitbenutzeroberfläche für dieses Steuerelement ist ein Fenster mit einem nicht transparenten Hintergrund (einfarbig und/oder Bildhintergrund), der nicht transparente Freihandelemente enthält.
Sie können das InkPicture-Steuerelement verwenden, um Freihandeingaben unter Microsoft Windows 2000, Windows Server 2003, allen Windows XP-Editionen und allen Versionen von Windows Vista zu rendern. Die Eingabe von Freihandelementen, das Akzeptieren von Stiftbewegungen oder das Erkennen von Handschrift ist jedoch nur unter den folgenden Bedingungen möglich:
Freihandelemente können nur eingegeben und erkannt werden, wenn die Tablet- und Touch-Technologie installiert ist.
Stiftbewegungen können nur erkannt werden, wenn die Microsoft-Stiftbewegungserkennung installiert ist.
Handschrift kann als Text erkannt werden, wenn die Handschrift von einer anderen Stelle stammt und wenn Erkennungsmodule vorhanden sind.
Wenn Sie Windows 2000, Windows Server 2003 oder eine andere Windows XP-Edition als die Tablet PC Edition verwenden, können Sie den Ambient-Eigenschaften des InkPicture-Steuerelements Werte zuweisen und Freihandeingaben in andere Anwendungen kopieren. Der Wert seiner InkEnabled-Eigenschaft ist jedoch immer false.
Beibehaltene Ink-Objekte können auf allen Editionen von Windows XP (einschließlich Tablet PC Edition) geladen werden. Allerdings können die Ink-Objekte nur dann in Text konvertiert (erkannt) werden, wenn die Windows XP Tablet PC Edition installiert ist.
Weitere Informationen zu Freihandeingaben-Steuerelementen finden Sie unter Ink Controls.
Weitere Informationen darüber, welche Threads bestimmte Ereignisse auslösen, finden Sie unter Threads on Which an Event Can Fire.
Löschen Sie ein nicht mehr benötigtes InkPicture-Steuerelement, um die Leistung der Anwendung zu verbessern.
Sicherheitshinweis Bei Verwendung mit teilweiser Vertrauenswürdigkeit ist für diese Klasse und alle ihre Methoden SafeTopLevelWindows-Berechtigung erforderlich. Weitere Informationen finden Sie unter Security and Trust.
Vererbungshierarchie
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.PictureBox
Microsoft.Ink.InkPicture
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.
Versionsinformationen
.NET Framework
Unterstützt in: 3.0