Proprietà AnalysisHintNode.Guide

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene o imposta la guida del sistema di riconoscimento utilizzata da InkAnalyzer per analizzare l'input penna all'interno dell'area.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)

Sintassi

'Dichiarazione
Public Property Guide As RecognizerGuide
'Utilizzo
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)

Valore proprietà

Tipo: Microsoft.Ink.RecognizerGuide
Guida del sistema di riconoscimento utilizzata da InkAnalyzer per analizzare l'input penna all'interno dell'area. L'impostazione predefinita è un oggetto RecognizerGuide, in cui le proprietà Rows, Columns e Midline sono 0 e le proprietà DrawnBox e WritingBox sono rettangoli vuoti.

Note

Nota

Se l'oggetto Microsoft.Ink.InkRecognizer che InkAnalyzer utilizza per il riconoscimento della grafia non supporta le guide, InkAnalyzer ignora la guida. Per ulteriori informazioni sulle funzionalità supportate da InkRecognizer, vedere InkRecognizerBase.Capabilities.

Tutte le coordinate di RecognizerGuide sono coordinate dello spazio di input penna e sono relative all'angolo superiore sinistro del suggerimento. Per un suggerimento globale, la guida non viene traslata; viene utilizzato il sistema di coordinate dell'oggetto Ink. Per ulteriori informazioni sull'utilizzo di una guida per migliorare il riconoscimento della grafia, vedere RecognizerGuide.

Se durante l'analisi il sistema di riconoscimento dell'input penna applicato ai tratti non supporta una guida, l'analizzatore dell'input penna genera un oggetto AnalysisWarning con la proprietà WarningCode impostata sul valore GuideNotSupported per Microsoft.Ink.AnalysisWarningCode.

Per rimuovere una guida da un suggerimento, chiamare il metodo RemovePropertyData del suggerimento con propertyDataId impostato su PropertyGuidsForAnalysisHintsBase.Guide. La guida (impostata sul valore predefinito) può essere rimossa anche chiamando il metodo ClearGuide.

Esempi

In questo esempio viene creato un oggetto AnalysisHintNode, theAnalysisHint, per l'oggetto InkAnalyzertheInkAnalyzerWithHint, e theAnalysisHint viene impostato come suggerimento globale. Quindi, vengono impostate le proprietà Guide e Name del suggerimento.

' 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";

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.