AnalysisHintNode (Clase)

Artículo
11/26/2008

Actualización: noviembre 2007

Proporciona un objeto InkAnalyzer con una sugerencia de análisis para una región.

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

Sintaxis

'Declaración
Public NotInheritable Class AnalysisHintNode _
    Inherits ContextNode
'Uso
Dim instance As AnalysisHintNode

public sealed class AnalysisHintNode : ContextNode

public ref class AnalysisHintNode sealed : public ContextNode

public final class AnalysisHintNode extends ContextNode

public final class AnalysisHintNode extends ContextNode

Comentarios

AnalysisHintNode proporciona una sugerencia para el objeto InkAnalyzer al que está asociado. La sugerencia se aplica al área especificada por la propiedad Location de AnalysisHintNode. Proporciona al analizador de entrada manuscrita contexto adicional que se utiliza para mejorar la exactitud del reconocimiento. El objeto InkAnalyzer aplica esta información contextual al analizar la entrada manuscrita incluida en el área de la sugerencia.

Si se asigna un área infinita a una sugerencia, lo que se conoce como sugerencia global, el objeto InkAnalyzer aplica el contexto de dicha sugerencia a todas las entradas manuscritas que no estén incluidas en otras áreas de sugerencia. Se pueden asociar varias sugerencias a un único objeto InkAnalyzer. Sin embargo, sólo se puede agregar una sugerencia global a un único objeto InkAnalyzer, 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 la página de los miembros de AnalysisHintNode.

Para agregar una sugerencia a un objeto InkAnalyzer, utilice InkAnalyzer.CreateAnalysisHint. Para quitar una sugerencia de un objeto InkAnalyzer, utilice InkAnalyzerDeleteAnalysisHint().

Nota

Agregar una sugerencia a un objeto InkAnalyzer, no cambia la propiedad DirtyRegion del objeto InkAnalyzer. Para hacer que el objeto InkAnalyzer vuelva a analizar la entrada manuscrita incluida en el área de la sugerencia, utilice el método Union(AnalysisRegion) del objeto DirtyRegion.

InkAnalyzer actualiza la propiedad Links de la sugerencia si se llama al método Analyze o BackgroundAnalyze(). El objeto InkAnalyzer agrega un objeto ContextLink entre AnalysisHintNode y cada ContextNode al que se aplica la sugerencia. Si una sugerencia se aplica a todos los descendientes de un objeto ContextNode, el objeto InkAnalyzer sólo vincula la sugerencia a dicho objeto ContextNode, y no a ninguno de sus descendientes.

La propiedad Location de un objeto AnalysisHintNode no se utilizará para aplicar la sugerencia a un nodo de reconocedor personalizado. Si crea una sugerencia y establece su ubicación para que incluya los trazos en el objeto CustomRecognizerNode, esa sugerencia no se aplicará a dichos trazos. Para aplicar correctamente la sugerencia a los trazos incluidos en un nodo de reconocedor personalizado, cree un vínculo entre los objetos AnalysisHintNode y CustomRecognizerNode antes de llamar al método Analyze. Supongamos, por ejemplo, que hay un objeto AnalysisHintNode denominado theAnalysisHint y un objeto CustomRecognizerNode denominado theCustomRecognizerNode. Para crear un vínculo entre los dos, utilice theAnalysisHint.Links.Add(theCustomRecognizerNode, ContextLinkDirection.LinksWith).

Sólo se puede aplicar una sugerencia no global a un objeto CustomRecognizerNode. Para quitar una sugerencia no global de un objeto CustomRecognizerNode, use ContextLinkCollectionRemove() para quitar el vínculo de la propiedad Links del objeto CustomRecognizerNode.

Si se aplica una sugerencia no global de una área no vacía a un objeto CustomRecognizerNode, el objeto InkAnalyzer aplica el contexto de la sugerencia al objeto CustomRecognizerNode y a la entrada manuscrita incluida en el área de la sugerencia.

Cuando se produce un análisis, no se crean ni eliminan vínculos de AnalysisHintNode a CustomRecognizerNode.

Si las sugerencias se utilizan en una aplicación de formulario, evite mezclar el contexto de texto con la entrada manuscrita. Las sugerencias sirven para asociar la entrada manuscrita a áreas de las páginas; cualquier contexto de texto interferirá con esta asociación de entrada manuscrita y sugerencia. Por lo tanto, no se deben crear nombres de campos de texto en el árbol de análisis. De lo contrario, la operación de análisis puede combinar la entrada manuscrita y el contexto de texto en la misma región de escritura, evitando que la entrada manuscrita se asocie al área de sugerencia.

Ejemplos

En este ejemplo, se crea un objeto AnalysisHintNode (theAnalysisHint) para el objeto InkAnalyzer (theInkAnalyzerWithHint) y se convierte theAnalysisHint en una sugerencia global al hacer que su área sea infinita. A continuación se establecen las propiedades Name y AllowPartialDictionaryTerms en la sugerencia.

' Add a new, global analysis hint to theInkAnalyzerWithHint.
Dim theAnalysisHint As AnalysisHintNode = Me.theInkAnalyzerWithHint.CreateAnalysisHint()
theAnalysisHint.Location.MakeInfinite()

theAnalysisHint.AllowPartialDictionaryTerms = True
theAnalysisHint.Name = "Allow Partial Dictionary Terms"

// Add a new, global analysis hint to theInkAnalyzerWithHint.
AnalysisHintNode theAnalysisHint =
    this.theInkAnalyzerWithHint.CreateAnalysisHint();
theAnalysisHint.Location.MakeInfinite();

theAnalysisHint.AllowPartialDictionaryTerms = true;
theAnalysisHint.Name = "Allow Partial Dictionary Terms";

Jerarquía de herencia

System.Object
System.Windows.Ink.ContextNode
System.Windows.Ink.AnalysisHintNode

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

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.