Classe RecognizerContext
Aggiornamento: novembre 2007
Attiva la possibilità di eseguire il riconoscimento dell'input penna e di recuperare il risultato del riconoscimento e le alternative. RecognizerContext attiva i diversi sistemi di riconoscimento installati in un sistema al fine di utilizzare il riconoscimento dell'input penna per elaborare l'input in modo appropriato.
Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Sintassi
'Dichiarazione
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Class RecognizerContext _
Implements ICloneable, IDisposable
'Utilizzo
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
Note
Avviso
Per evitare una perdita di memoria, è necessario chiamare in modo esplicito il metodo Dispose su qualsiasi insieme RecognizerContext a cui è stato associato un gestore eventi, prima che l'insieme esca dall'ambito.
Sono disponibili due tipi di riconoscimento: in background (asincrono) o in primo piano (sincrono). Il riconoscimento in background viene avviato tramite una chiamata ai metodi BackgroundRecognize o BackgroundRecognizeWithAlternates, si verifica su un thread in background e segnala i risultati all'applicazione tramite un meccanismo di eventi. Il riconoscimento in primo piano non esegue nessuna restituzione finché non sono stati completati tutti i riconoscimenti, pertanto rende disponibili i risultati del riconoscimento al thread chiamante senza rimanere in attesa dell'evento di riconoscimento.
L'input penna viene elaborato continuamente in background. Se un oggetto Stroke viene aggiunto all'insieme Strokes a cui l'oggetto RecognizerContext fa riferimento, l'oggetto Stroke viene immediatamente riconosciuto. Per ulteriori informazioni, vedere le note nell'argomento del metodo EndInkInput.
Tutti i riconoscimenti si verificano tramite un contesto del sistema di riconoscimento. Il contesto definisce le impostazioni per una singola sessione di riconoscimento. Riceve l'input penna che deve essere riconosciuto e definisce i vincoli relativi all'input penna e all'output del riconoscimento. I vincoli che possono essere impostati sul contesto includono la lingua, il dizionario e la grammatica utilizzati.
Nota
L'impostazione di proprietà diverse dalle proprietà Strokes o CharacterAutoCompletion ha esito positivo solo se l'insieme Strokes è nullriferimento null (Nothing in Visual Basic). Le altre proprietà devono essere impostate prima di associare l'insieme Strokes all'oggetto RecognizerContext oppure è necessario impostare l'insieme Strokes su nullriferimento null (Nothing in Visual Basic) e quindi impostare le altre proprietà. Se l'insieme Strokes viene impostato su nullriferimento null (Nothing in Visual Basic) e successivamente vengono impostate le altre proprietà, è necessario riassociare l'insieme Strokes. Ciò è dovuto al fatto che il riconoscimento inizia subito dopo l'assegnazione dell'oggetto Strokes all'oggetto RecognizerContext. Quando si esegue una chiamata all'oggetto Recognize o BackgroundRecognize, i risultati della chiamata potrebbero essere già disponibili.
Per migliorare le prestazioni dell'applicazione, eliminare manualmente un oggetto RecognizerContext quando non è più necessario.
Gerarchia di ereditarietà
System.Object
Microsoft.Ink.RecognizerContext
Codice thread safe
Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Piattaforme
Windows Vista
.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Informazioni sulla versione
.NET Framework
Supportato in: 3.0