InkAnalyzerBase.CreateAnalysisHint (Método)

Artículo
11/26/2008

Actualización: noviembre 2007

Agrega una nueva sugerencia de análisis con un área vacía al analizador de entrada manuscrita.

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

Sintaxis

'Declaración
Public Function CreateAnalysisHint As ContextNodeBase
'Uso
Dim instance As InkAnalyzerBase
Dim returnValue As ContextNodeBase

returnValue = instance.CreateAnalysisHint()

public ContextNodeBase CreateAnalysisHint()

public:
ContextNodeBase^ CreateAnalysisHint()

public ContextNodeBase CreateAnalysisHint()

public function CreateAnalysisHint() : ContextNodeBase

Valor devuelto

Tipo: System.Windows.Ink.AnalysisCore.ContextNodeBase
Nueva sugerencia de análisis.

Comentarios

Para proporcionar información de contexto adicional al analizador de entrada manuscrita, puede agregar sugerencias de análisis al analizador de entrada manuscrita. Las sugerencias de análisis pueden mejorar la exactitud del reconocimiento. Por ejemplo, puede agregar información de control y guía para los campos de una aplicación de formulario.

Este método crea un nuevo objeto ContextNodeBase cuya propiedad Type tiene el valor AnalysisHint() y agrega la nueva sugerencia a la colección SubNodes de RootNode del analizador de entrada manuscrita.

Para agregar información de contexto a la sugerencia, utilice el método AddPropertyData del objeto ContextNodeBase con el parámetro propertyDataId establecido en uno de los identificadores únicos globales (GUID) de la clase PropertyGuidsForAnalysisHintsBase.

Si se asigna una sugerencia a un área infinita, lo cual se denomina sugerencia global, el analizador de entrada manuscrita aplica el contexto de dicha sugerencia a toda la entrada manuscrita que no esté incluida en el área de otra sugerencia. Se pueden asociar varias sugerencias a un único analizador. Sin embargo, sólo se puede agregar una sugerencia global a un único analizador de entrada manuscrita, y no se pueden superponer sugerencias que no sean globales. Para obtener más información sobre los tipos de información de contexto que puede proporcionar una sugerencia, vea PropertyGuidsForAnalysisHintsBase.

Cuando se agrega una sugerencia de análisis, no se marca el área de la sugerencia para un nuevo análisis. Para marcar el área incluida en la sugerencia para un nuevo análisis, llame al método Union del objeto DirtyRegion con la propiedad Location de la sugerencia.

Para obtener más información sobre el análisis de entrada manuscrita, vea Ink Analysis Overview.

Ejemplos

En el ejemplo siguiente, se crea una sugerencia de análisis, theAnalysisHint, para InkAnalyzerBase, theInkAnalyzerBase. A continuación, convierte theAnalysisHint en una sugerencia global y agrega las propiedades Name y AllowPartialDictionaryTerms a la sugerencia.

' Add a new, global analysis hint to the ink analyzer. 
Dim theAnalysisHintNode As System.Windows.Ink.AnalysisCore.ContextNodeBase = _
    theInkAnalyzerBase.CreateAnalysisHint()
theAnalysisHintNode.Location.MakeInfinite()
theAnalysisHintNode.AddPropertyData( _
    System.Windows.Ink.AnalysisCore.PropertyGuidsForAnalysisHintsBase.AllowPartialDictionaryTerms, _
    True)
theAnalysisHintNode.AddPropertyData( _
    System.Windows.Ink.AnalysisCore.PropertyGuidsForAnalysisHintsBase.Name, _
    "Allow Partial Dictionary Terms")

// Add a new, global analysis hint to the ink analyzer. 
System.Windows.Ink.AnalysisCore.ContextNodeBase theAnalysisHintNode =
    theInkAnalyzerBase.CreateAnalysisHint();
theAnalysisHintNode.Location.MakeInfinite();
theAnalysisHintNode.AddPropertyData(
    System.Windows.Ink.AnalysisCore.PropertyGuidsForAnalysisHintsBase.AllowPartialDictionaryTerms,
    true);
theAnalysisHintNode.AddPropertyData(
    System.Windows.Ink.AnalysisCore.PropertyGuidsForAnalysisHintsBase.Name,
    "Allow Partial Dictionary Terms");

Plataformas

Windows Vista, Windows XP SP2, Windows Server 2003

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