AnalysisHintNode.Guide (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene o establece la guía de reconocedor que el objeto InkAnalyzer utiliza para analizar la entrada manuscrita incluida en esta área.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink.Analysis (en Microsoft.Ink.Analysis.dll)

Sintaxis

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

Valor de propiedad

Tipo: Microsoft.Ink.RecognizerGuide
La guía de reconocedor que el objeto InkAnalyzer utiliza para analizar la entrada manuscrita incluida en esta área. El valor predeterminado es un objeto RecognizerGuide, cuyas propiedades Rows, Midline y Columns tienen un valor 0, y sus propiedades WritingBox y DrawnBox son rectángulos vacíos.

Comentarios

Nota

Si el objeto Microsoft.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 InkRecognizerBase.Capabilities.

Todas las coordenadas del objeto RecognizerGuide están en coordenadas espaciales de entrada manuscrita, en relación a la esquina superior izquierda de la sugerencia. Para una sugerencia global, la guía no se convierte; 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 Microsoft.Ink.AnalysisWarningCode del campo GuideNotSupported.

Para quitar una guía de una sugerencia, llame al método RemovePropertyData de la sugerencia con el parámetro propertyDataId establecido en PropertyGuidsForAnalysisHintsBase.Guide. La guía también se puede quitar (establecida en el valor predeterminado) llamando al método ClearGuide.

Ejemplos

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

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

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.