AnalysisHintNode.Guide (Propiedad)

Actualización: noviembre 2007

Obtiene o establece la guía de reconocimiento que InkAnalyzer utiliza para analizar la entrada manuscrita dentro del área actual.

Espacio de nombres:  System.Windows.Ink
Ensamblado:  IAWinFX (en IAWinFX.dll)

Sintaxis

'Declaración
Public Property Guide As InkRecognizerGuide
'Uso
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)

Valor de propiedad

Tipo: System.Windows.Ink.InkRecognizerGuide
Guía de reconocimiento que InkAnalyzer utiliza para analizar la entrada manuscrita incluida en el área actual. El valor predeterminado es un objeto InkRecognizerGuide con todas sus propiedades establecidas en 0.

Comentarios

Nota

Si el objeto System.Windows.Ink.InkRecognizer que utiliza el objeto InkAnalyzer para el reconocimiento de escritura a mano no admite las guías, el objeto InkAnalyzer omite la guía. Para obtener más información sobre las capacidades que admite un objeto InkRecognizer, vea InkRecognizer.Capabilities.

Todas las coordenadas del objeto RecognizerGuide están en coordenadas de espacio de entrada manuscrita, en relación a la esquina superior izquierda de la sugerencia. Para una sugerencia global, la guía no se convierte, ya que utiliza el sistema de coordenadas del objeto Ink. Para obtener más información sobre cómo utilizar una guía para mejorar el reconocimiento de la escritura a mano, vea RecognizerGuide.

Durante el análisis, si el reconocedor de entrada manuscrita aplicado a los trazos no admite una guía, el analizador de entrada manuscrita genera una advertencia AnalysisWarning con su propiedad WarningCode() establecida en el valor System.Windows.Ink.AnalysisWarningCode del campo GuideNotSupported.

Para quitar una guía de una sugerencia, llame al método ClearGuide o al método RemovePropertyData(Guid) de la sugerencia con propertyDataId establecido en PropertyGuidsForAnalysisHints.Guide.

Ejemplos

En este ejemplo se crea un objeto AnalysisHintNode (denominado theAnalysisHint) para el objeto InkAnalyzer (denominado theInkAnalyzerWithHint) y se convierte theAnalysisHint es una sugerencia global. A continuación se establecen las propiedades Name y Guide en la sugerencia.

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

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Información de versión

.NET Framework

Compatible con: 3.0

Vea también

Referencia

AnalysisHintNode (Clase)

AnalysisHintNode (Miembros)

System.Windows.Ink (Espacio de nombres)

RecognizerGuide