AnalysisHintNode (Clase)
Actualización: noviembre 2007
Proporciona un objeto InkAnalyzer con una sugerencia de análisis para una región.
Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink.Analysis (en Microsoft.Ink.Analysis.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
Un objeto AnalysisHintNode proporciona una sugerencia sobre una área concreta, la propiedad Location de la sugerencia, para el objeto InkAnalyzer al que está asociada. La sugerencia proporciona contexto adicional al analizador de entrada manuscrita 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 cual se denomina 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 la 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 los miembros de esta clase.
Para agregar una sugerencia a un objeto InkAnalyzer, utilice InkAnalyzer.CreateAnalysisHint. Para quitar una sugerencia de un objeto InkAnalyzer, utilice DeleteAnalysisHint.
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.
El objeto InkAnalyzer actualiza la propiedad Links de la sugerencia cada vez que se llama al método Analyze o BackgroundAnalyze. El objeto InkAnalyzer agrega un objeto ContextLink entre los objetos AnalysisHintNode y ContextNode a los 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. Por ejemplo, suponga 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 el método Remove 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.
Analizar no creará ni eliminará ningún vínculo de un objeto AnalysisHintNode al objeto CustomRecognizerNode.
Si se utilizan sugerencias para una aplicación de formulario, la aplicación debería evitar mezclar el contexto de texto con la entrada manuscrita en los formularios. Esto significa por ejemplo que no se deberían crear nombres de campos de texto en el árbol de análisis. 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. La operación de análisis puede combinar la entrada manuscrita y el contexto de texto en la misma región de escritura, lo cual impediría asociar la entrada manuscrita al área de la sugerencia.
Ejemplos
En este ejemplo se crea un objeto AnalysisHintNode, theAnalysisHint para el objeto InkAnalyzer, theInkAnalyzerWithHint, y theAnalysisHint se convierte en una sugerencia global haciendo infinita su área. A continuación se establecen las propiedades Name y AllowPartialDictionaryTerms en la sugerencia.
' Add a new, global analysis hint to theInkAnalyzerWithHint.
Dim theAnalysisHint As Microsoft.Ink.AnalysisHintNode = _
Me.theInkAnalyzerWithHint.CreateAnalysisHint()
theAnalysisHint.Location.MakeInfinite()
theAnalysisHint.AllowPartialDictionaryTerms = True
theAnalysisHint.Name = "Allow Partial Dictionary Terms"
// Add a new, global analysis hint to theInkAnalyzerWithHint.
Microsoft.Ink.AnalysisHintNode theAnalysisHint =
this.theInkAnalyzerWithHint.CreateAnalysisHint();
theAnalysisHint.Location.MakeInfinite();
theAnalysisHint.AllowPartialDictionaryTerms = true;
theAnalysisHint.Name = "Allow Partial Dictionary Terms";
Jerarquía de herencia
System.Object
Microsoft.Ink.ContextNode
Microsoft.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.
Información de versión
.NET Framework
Compatible con: 3.0