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 corrente.

Spazio dei nomi: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.dll)

Sintassi

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

Valore proprietà

Tipo: System.Windows.Ink.InkRecognizerGuide
Guida del sistema di riconoscimento utilizzata da InkAnalyzer per analizzare l'input penna all'interno dell'area corrente. Il valore predefinito è un oggetto InkRecognizerGuide con tutte le proprietà impostate su 0.

Note

Nota

Se l'oggetto System.Windows.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 InkRecognizer.Capabilities.

Tutte le coordinate di RecognizerGuide sono coordinate dello spazio di input penna e sono relative all'angolo superiore sinistro del suggerimento. La guida non viene tradotta per un suggerimento globale poiché utilizza 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 System.Windows.Ink.AnalysisWarningCode.

Per rimuovere una guida da un suggerimento, chiamare il metodo ClearGuide o il metodo RemovePropertyData(Guid) del suggerimento con propertyDataId impostato su PropertyGuidsForAnalysisHints.Guide.

Esempi

In questo esempio viene creato un oggetto AnalysisHintNode (denominato theAnalysisHint) per l'oggetto InkAnalyzer (denominato theInkAnalyzerWithHint) e theAnalysisHint viene impostato come suggerimento globale. Quindi, vengono impostate le proprietà Guide e Name nel suggerimento.

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

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.

Informazioni sulla versione

.NET Framework

Supportato in: 3.0

Vedere anche

Riferimenti

AnalysisHintNode Classe

Membri AnalysisHintNode

Spazio dei nomi System.Windows.Ink

RecognizerGuide

Condividi tramite