AnalysisHintNode.Guide-Eigenschaft
Ruft die Freihandführung ab, oder legt die Freihandführung fest, die vom InkAnalyzer zum Analysieren von Freihandeingaben innerhalb des aktuellen Bereichs verwendet wird.
Namespace: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.dll)
Syntax
'Declaration
Public Property Guide As InkRecognizerGuide
'Usage
Dim instance As AnalysisHintNode
Dim value As InkRecognizerGuide
value = instance.Guide
instance.Guide = value
public InkRecognizerGuide Guide { get; set; }
public:
property InkRecognizerGuide^ Guide {
InkRecognizerGuide^ get ();
void set (InkRecognizerGuide^ value);
}
/** @property */
public InkRecognizerGuide get_Guide()
/** @property */
public void set_Guide(InkRecognizerGuide value)
public function get Guide () : InkRecognizerGuide
public function set Guide (value : InkRecognizerGuide)
Eigenschaftenwert
Typ: System.Windows.Ink.InkRecognizerGuide
Die Freihandführung, die vom InkAnalyzer zum Analysieren von Freihandeingaben innerhalb des aktuellen Bereichs verwendet wird. Die Standardeinstellung ist eine InkRecognizerGuide, deren Eigenschaften alle auf 0 (null) festgelegt sind.
Hinweise
Hinweis
Wenn die System.Windows.Ink.InkRecognizer, die vom InkAnalyzer zur Handschrifterkennung verwendet wird, keine Führungen unterstützt, ignoriert der InkAnalyzer die Führung. Weitere Informationen zu den Funktionen, die von einem InkRecognizer unterstützt werden, finden Sie unter InkRecognizer.Capabilities.
Alle Koordinaten der RecognizerGuide werden in Freihandbereichkoordinaten und relativ zur oberen linken Ecke des Hinweises angegeben. Für globale Hinweise wird die Führung nicht übersetzt, da sie das Koordinatensystem des Ink-Objekts verwendet. Weitere Informationen zum Verwenden einer Führung zum Verbessern der Handschrifterkennung finden Sie unter RecognizerGuide.
Wenn das auf die Striche angewendete Freihanderkennungsmodul keine Führung unterstützt, generiert das Freihandanalysemodul während der Analyse eine AnalysisWarning, deren WarningCode()-Eigenschaft auf den System.Windows.Ink.AnalysisWarningCode-Wert GuideNotSupported festgelegt ist.
Um eine Führung aus einem Hinweis zu entfernen, rufen Sie entweder die ClearGuide-Methode oder die RemovePropertyData(Guid)-Methode des Hinweises auf, wobei Sie propertyDataId auf PropertyGuidsForAnalysisHints.Guide festlegen.
Beispiele
In diesem Beispiel wird ein AnalysisHintNode (mit dem Namen theAnalysisHint) für den InkAnalyzer (mit dem Namen theInkAnalyzerWithHint) erstellt, und theAnalysisHint wird als globaler Hinweis festgelegt. Für den Hinweis werden dann die Guide-Eigenschaft und die Name-Eigenschaft 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
' Add a new, global analysis hint to theInkAnalyzerWithHint.
Dim theAnalysisHint As AnalysisHintNode = Me.theInkAnalyzerWithHint.CreateAnalysisHint()
theAnalysisHint.Location.MakeInfinite()
' Create an InkRecognizerGuide with the writing box
' slightly larger than the drawing box.
Dim theGuide As New InkRecognizerGuide(1, 0, midline, _
guideBoxLeft - WRITINGBOXMARGIN, guideBoxTop - WRITINGBOXMARGIN, _
guideBoxRight + WRITINGBOXMARGIN, guideBoxBottom + WRITINGBOXMARGIN, _
guideBoxLeft, guideBoxTop, guideBoxRight, guideBoxBottom)
theAnalysisHint.Guide = theGuide
theAnalysisHint.Name = "Recognizer Guide"
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;
// Add a new, global analysis hint to theInkAnalyzerWithHint.
AnalysisHintNode theAnalysisHint =
this.theInkAnalyzerWithHint.CreateAnalysisHint();
theAnalysisHint.Location.MakeInfinite();
// Create an InkRecognizerGuide with the writing box
// slightly larger than the drawing box.
InkRecognizerGuide theGuide = new InkRecognizerGuide(1, 0, midline,
guideBoxLeft - WRITINGBOXMARGIN, guideBoxTop - WRITINGBOXMARGIN,
guideBoxRight + WRITINGBOXMARGIN, guideBoxBottom + WRITINGBOXMARGIN,
guideBoxLeft, guideBoxTop, guideBoxRight, guideBoxBottom);
theAnalysisHint.Guide = theGuide;
theAnalysisHint.Name = "Recognizer Guide";
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
RecognizerGuide