AnalysisHintNode.Guide-Eigenschaft

Artikel
11/26/2008

Ruft die Freihandführung ab, oder legt die Freihandführung fest, die vom InkAnalyzer zum Analysieren von Freihandeingaben innerhalb dieses Bereichs verwendet wird.

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

Syntax

'Declaration
Public Property Guide As RecognizerGuide
'Usage
Dim instance As AnalysisHintNode
Dim value As RecognizerGuide

value = instance.Guide

instance.Guide = value

public RecognizerGuide Guide { get; set; }

public:
property RecognizerGuide Guide {
    RecognizerGuide get ();
    void set (RecognizerGuide value);
}

/** @property */
public RecognizerGuide get_Guide()
/** @property */
public  void set_Guide(RecognizerGuide value)

public function get Guide () : RecognizerGuide
public function set Guide (value : RecognizerGuide)

Eigenschaftenwert

Typ: Microsoft.Ink.RecognizerGuide
Die Freihandführung, die vom InkAnalyzer zum Analysieren von Freihandeingaben innerhalb dieses Bereichs verwendet wird. Der Standardwert ist RecognizerGuide; seine Eigenschaften Rows, Columns und Midline sind auf den Wert 0 (null) festgelegt, und die DrawnBox-Eigenschaft sowie die WritingBox-Eigenschaft sind leere Rechtecke.

Hinweise

Hinweis

Wenn der Microsoft.Ink.InkRecognizer, der 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 InkRecognizerBase.Capabilities.

Alle Koordinaten des RecognizerGuide werden in Freihandbereichkoordinaten und relativ zur oberen linken Ecke des Hinweises angegeben. Für einen globalen Hinweis wird die Führung nicht übersetzt; er verwendet das Koordinatensystem des Ink-Objekts. 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 Microsoft.Ink.AnalysisWarningCode-Wert GuideNotSupported festgelegt ist.

Um eine Führung aus einem Hinweis zu entfernen, rufen Sie die RemovePropertyData-Methode des Hinweises mit auf PropertyGuidsForAnalysisHintsBase.Guide festgelegter propertyDataId auf. Die Führung kann auch durch Aufrufen der ClearGuide-Methode entfernt (auf den Standardwert festgelegt) werden.

Beispiele

In diesem Beispiel wird ein AnalysisHintNode mit dem Namen theAnalysisHint für den InkAnalyzertheInkAnalyzerWithHint erstellt, und theAnalysisHint wird als globaler Hinweis festgelegt. Für den Hinweis werden dann die Guide-Eigenschaft und die Name-Eigenschaft festgelegt.

' Add a new, global analysis hint to theInkAnalyzerWithHint.
Dim theAnalysisHint As Microsoft.Ink.AnalysisHintNode = _
    Me.theInkAnalyzerWithHint.CreateAnalysisHint()
theAnalysisHint.Location.MakeInfinite()

theAnalysisHint.Guide = New RecognizerGuide(1, 0, _
    Me.theMidlineHeightInHimetric, _
    Rectangle.Inflate(Me.theGuideBoxInHimetric, 50, 50), _
    Me.theGuideBoxInHimetric)
theAnalysisHint.Name = "Recognizer Guide"

// Add a new, global analysis hint to theInkAnalyzerWithHint.
Microsoft.Ink.AnalysisHintNode theAnalysisHint =
    this.theInkAnalyzerWithHint.CreateAnalysisHint();
theAnalysisHint.Location.MakeInfinite();

theAnalysisHint.Guide = new RecognizerGuide(1, 0,
    this.theMidlineHeightInHimetric,
    Rectangle.Inflate(this.theGuideBoxInHimetric, 50, 50),
    this.theGuideBoxInHimetric);
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.