InkRecognizerGuide-Klasse
Stellt den Bereich dar, den das InkRecognizer-Objekt verwendet und in dem Freihandeingaben gezeichnet werden können. Dieser Bereich wird als recognizer guide oder Erkennungsführung bezeichnet.
Namespace: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.dll)
Syntax
'Declaration
Public Class InkRecognizerGuide
'Usage
Dim instance As InkRecognizerGuide
public class InkRecognizerGuide
public ref class InkRecognizerGuide
public class InkRecognizerGuide
public class InkRecognizerGuide
Hinweise
Die InkRecognizerGuide kann aus Zeilen und Spalten bestehen; sie bietet dem Erkennungsmodul einen besseren Kontext bei der Durchführung der Erkennung. Sie können z. B., ähnlich wie bei liniertem Papier, horizontale Linien auf den Benutzerbildschirm zeichnen, die angeben, wo Freihandeingaben vorgenommen werden sollen (diese Art der Erkennungsführung besteht nur aus Zeilen und nicht aus Spalten). Schreibt ein Benutzer auf diesen Zeilen statt in einen beliebigen Bereich, verbessert sich Erkennungsgenauigkeit. Buchstaben, wie "t" und "I" werden beispielsweise leichter erkannt, wenn eine Freihandführung einen Kontext für die Freihandeingaben bereitstellt.
Die InkRecognizerGuide gibt durch zwei Rechtecke die Begrenzungen an, innerhalb derer Freihandeingaben durchgeführt werden können. Diese zwei Rechtecke sind das gezeichnete Feld (drawn box) und das Schreibfeld (writing box). Die Begrenzungen des gezeichneten Felds sind visuelle Hinweise, wohingegen die Begrenzungen des Schreibfelds unsichtbar sind. Zusammen geben sie an, wo geschrieben werden kann. Der Benutzer schreibt normalerweise innerhalb der Grenzen der sichtbaren Linien des gezeichneten Felds. Das gezeichnete Feld wird von den Eigenschaften DrawnBoxTop, DrawnBoxLeft, DrawnBoxBottom und DrawnBoxRight angegeben. Diese Eigenschaften sind nur für die Verwendung durch das Erkennungsmodul vorgesehen. Durch das Festlegen allein werden keine visuellen Hinweise auf der Anzeige gezeichnet. Sie müssen die visuellen Hinweise mit der Anwendung oder dem Steuerelement zeichnen.
Das Schreibfeld ist größer als das gezeichnete Feld und gewährt eine gewisse Toleranz, wenn Benutzer außerhalb der Ränder des gezeichneten Felds Freihandeingaben durchführen. Das Schreibfeld wird mit den Eigenschaften WritingBoxTop, WritingBoxLeft, WritingBoxBottom und WritingBoxRight angegeben.
Zusätzlich zu den Linien auf dem Bildschirm, die dem Benutzer zeigen, wo er schreiben soll, können auf dem Bildschirm auch Zellen vorgegeben werden, in die er die Zeichen oder Wörter eingeben kann. Dies wird als Eingabe in Feldern (boxed input) bezeichnet und ist bei einigen ostasiatischen Sprachen sinnvoll. Sie können anhand der Capabilities-Eigenschaft des InkRecognizer-Objekts feststellen, ob das Erkennungsmodul mit der Eingabe in Felder umgehen kann.
Standardmäßig sind alle Eigenschaftswerte der Erkennungsführung auf 0 (null), d. h. es ist keine Führung festgelegt. Sie müssen die Eigenschaften des InkRecognizerGuide-Objekts verwenden, um die Führung festzulegen.
Beispiele
Im folgenden Code werden alle Werte im InkRecognizerGuide gleichzeitig festgelegt.
Dim guideBoxTop As Double = 0
Dim guideBoxBottom As Double = 50
Dim guideBoxLeft As Double = 0
Dim guideBoxRight As Double = 600
Dim WRITINGBOXMARGIN As Integer = 10
' Find the midline of the guide box.
Dim midline As Double = (guideBoxBottom - guideBoxTop) / 2 + guideBoxTop
theGuide.Rows = 1
theGuide.Columns = 0
theGuide.Midline = midline
theGuide.WritingBoxLeft = guideBoxLeft - WRITINGBOXMARGIN
theGuide.WritingBoxTop = guideBoxTop - WRITINGBOXMARGIN
theGuide.WritingBoxRight = guideBoxRight + WRITINGBOXMARGIN
theGuide.WritingBoxBottom = guideBoxBottom + WRITINGBOXMARGIN
theGuide.DrawnBoxLeft = guideBoxLeft
theGuide.DrawnBoxTop = guideBoxTop
theGuide.DrawnBoxRight = guideBoxRight
theGuide.DrawnBoxBottom = guideBoxBottom
double guideBoxTop = 0;
double guideBoxBottom = 50;
double guideBoxLeft = 0;
double guideBoxRight = 600;
const int WRITINGBOXMARGIN = 10;
// Find the midline of the guide box.
double midline = (guideBoxBottom - guideBoxTop) / 2 + guideBoxTop;
theGuide.Rows = 1;
theGuide.Columns = 0;
theGuide.Midline = midline;
theGuide.WritingBoxLeft = guideBoxLeft - WRITINGBOXMARGIN;
theGuide.WritingBoxTop = guideBoxTop - WRITINGBOXMARGIN;
theGuide.WritingBoxRight = guideBoxRight + WRITINGBOXMARGIN;
theGuide.WritingBoxBottom = guideBoxBottom + WRITINGBOXMARGIN;
theGuide.DrawnBoxLeft = guideBoxLeft;
theGuide.DrawnBoxTop = guideBoxTop;
theGuide.DrawnBoxRight = guideBoxRight;
theGuide.DrawnBoxBottom = guideBoxBottom;
Vererbungshierarchie
System.Object
System.Windows.Ink.InkRecognizerGuide
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
Siehe auch
Referenz
Recognizer
RecognizerContext