InkEdit-Klasse

Artikel
11/26/2008

Das InkEdit-Steuerelement ermöglicht es Ihnen, Freihandeingaben zu erfassen, erkennt diese und zeigt sie als Text an. Mit diesem Steuerelement können Sie intelligente Formulare aktivieren, die die Genauigkeit von Texteingaben verbessern.

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

Syntax

'Declaration
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Class InkEdit _
    Inherits RichTextBox
'Usage
Dim instance As InkEdit

[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public class InkEdit : RichTextBox

[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public ref class InkEdit : public RichTextBox

/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public class InkEdit extends RichTextBox

public class InkEdit extends RichTextBox

Hinweise

Dieses Steuerelement stellt eine Obermenge des RichTextBox-Steuerelements dar. Es erweitert das RichTextBox-Steuerelement um die Fähigkeit, Freihandeingaben zu erfassen, zu erkennen und anzuzeigen.

Wenn eine Enumeration, ein Ereignis, eine Methode oder eine Eigenschaft des RichTextBox-Steuerelements nachfolgend nicht dokumentiert wird, dann wurde sie bzw. es im InkEdit-Steuerelement überschrieben und kann genau wie in der Dokumentation des RichTextBox-Steuerelements beschrieben verwendet werden. Insbesondere können Werte und Parameter, die nur als für ein RichTextBox-Steuerelement zulässig beschrieben werden, beispielsweise das RichNoOleObjs-Enumerationfeld, ebenso für das InkEdit-Steuerelement angegeben werden, weil es ein RichTextBox-Steuerelement ist.

Warnung

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

Sie können das InkEdit-Steuerelement unter Windows Vista einsetzen. Sie können das InkEdit-Steuerelement nicht verwenden, um Freihandeingaben unter Microsoft Windows 2000, Windows Server 2003 und allen Windows XP-Editionen außer Windows XP Tablet PC Edition zu rendern. Die Eingabe von Freihandelementen, das Akzeptieren von Stiftbewegungen oder das Erkennen von Handschrift ist nur unter den folgenden Bedingungen möglich:

Freihandelemente können nur eingegeben und erkannt werden, wenn die Windows XP Tablet PC Edition installiert ist.
Stiftbewegungen können nur erkannt werden, wenn Windows XP Tablet PC Edition installiert ist.
Handschrift kann als Text erkannt werden, wenn die Handschrift von einer anderen Stelle stammt und 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 InkEdit-Steuerelements Werte zuweisen und Freihandeingaben in andere Anwendungen kopieren. Der Wert seiner InkMode-Eigenschaft ist jedoch Disabled.

Die intelligente Leerzeicheneinfügung ist nur verfügbar, wenn Windows XP Tablet PC Edition installiert ist.

Dateien mit eingebetteten Ink-Objekten können in jeder Edition von Windows XP (einschließlich Windows XP Tablet PC Edition) und auf Systemen, auf denen nur das Tablet PC SDK installiert wurde, geladen und angezeigt werden. Allerdings können die eingebetteten Ink-Objekte nur dann in Text konvertiert werden, wenn Windows XP Tablet PC Edition installiert ist.

Weitere Informationen zu Freihandeingabe-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 InkEdit-Steuerelement von Hand, um die Leistung der Anwendung zu verbessern.

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

Die verwaltete Version des InkEdit-Steuerelements umschließt das COM-Steuerelement InkEdit. Der Konstruktor des InkEdit-Steuerelements, die Divide-Methode, die LineHeight-Eigenschaft, die RecognizerContext-Eigenschaft und die Strokes-Eigenschaft lösen alle eine Marshal.ThrowExceptionForHR-Ausnahme aus, wenn die COM-Klasse InkEdit einen Fehler zurückgibt. Weitere Informationen zu den Fehlern, die zurückgegeben werden können, finden Sie in den Themen unter InkEdit Control Reference.

Vererbungshierarchie

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.Control
        System.Windows.Forms.TextBoxBase
          System.Windows.Forms.RichTextBox
            Microsoft.Ink.InkEdit

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.