RecognizerContext (Clase)
Actualización: noviembre 2007
Aporta la capacidad de realizar el reconocimiento de entradas manuscritas, recuperar el resultado del reconocimiento y recuperar las alternativas. RecognizerContext permite que los diferentes reconocedores instalados en el sistema usen el reconocimiento de entradas manuscritas para procesar las entradas adecuadamente.
Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)
Sintaxis
'Declaración
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Class RecognizerContext _
Implements ICloneable, IDisposable
'Uso
Dim instance As RecognizerContext
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public class RecognizerContext : ICloneable,
IDisposable
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public ref class RecognizerContext : ICloneable,
IDisposable
/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public class RecognizerContext implements ICloneable,
IDisposable
public class RecognizerContext implements ICloneable, IDisposable
Comentarios
Advertencia
Para evitar una pérdida de memoria debe llamar explícitamente al método Dispose en cualquier colección RecognizerContext a la que se haya asociado un controlador de eventos antes de que la colección quede fuera de ámbito.
Hay dos tipos de reconocimiento: en segundo plano (asincrónico) y en primer plano (sincrónico). El reconocimiento en segundo plano se inicia por una llamada a los métodos BackgroundRecognizeWithAlternates o BackgroundRecognize, se produce en un subproceso en segundo plano e informa de los resultados a la aplicación a través de un mecanismo de eventos. El reconocimiento en primer plano no se devuelve hasta que se completa todo el reconocimiento, haciendo así que los resultados del reconocimiento estén disponibles para el subproceso de la llamada sin realizar escuchas para el evento de reconocimiento.
Las entradas manuscritas se procesan de forma continua en segundo plano. Si se agrega un objeto Stroke a la colección Strokes a la que RecognizerContext hace referencia, el objeto Stroke se reconocerá inmediatamente. Vea los comentarios del tema sobre el método EndInkInput para obtener más información.
Todo el reconocimiento se produce a través de un contexto de reconocedor. El contexto define los valores para una sesión del reconocimiento única. Recibe la entrada manuscrita que se debe reconocer y define las restricciones de la misma y de los resultados del reconocimiento. Entre las restricciones que se pueden establecer en el contexto se incluyen el idioma, el diccionario y la gramática que se va a usar.
Nota
Si se establecen otras propiedades que no sean Strokes o CharacterAutoCompletion, solamente resulta correcto si la colección Strokes es nullreferencia null (Nothing en Visual Basic). Debe establecer las otras propiedades antes de asociar la colección Strokes a RecognizerContext, o debe establecer la colección Strokes en nullreferencia null (Nothing en Visual Basic) y, a continuación, establecer las demás propiedades. Si establece la colección Strokes en nullreferencia null (Nothing en Visual Basic) y, a continuación, establece las demás propiedades, es posible que tenga que volver a asociar la colección Strokes. Esto sucede porque el reconocimiento se inicia justo después de asignar Strokes a RecognizerContext. Cuando se realiza una llamada a Recognize o a BackgroundRecognize, puede ser que los resultados de la llamada estén todavía disponibles.
Para mejorar el rendimiento de la aplicación, elimine manualmente un objeto RecognizerContext cuando ya no lo necesite.
Jerarquía de herencia
System.Object
Microsoft.Ink.RecognizerContext
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