RecognizerContext, classe

Article
11/05/2008

Mise à jour : November 2007

Permet d'exécuter la reconnaissance de l'écriture manuscrite et d'extraire les résultats de reconnaissance et les propositions de substitution. Le RecognizerContext active les différents modules de reconnaissance installés sur un système afin d'utiliser la reconnaissance de l'écriture manuscrite pour traiter correctement les entrées.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Class RecognizerContext _
    Implements ICloneable, IDisposable
'Utilisation
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

Notes

Attention :
Pour éviter toute fuite de mémoire, vous devez appeler explicitement la méthode Dispose sur toutes les collections RecognizerContext auxquelles un gestionnaire d'événements a été attaché avant que les collections ne soient hors de portée.

Il existe deux types de reconnaissance : arrière-plan (asynchrone) ou premier plan (synchrone). La reconnaissance d'arrière-plan commence par un appel à la méthode BackgroundRecognize ou BackgroundRecognizeWithAlternates, s'effectue sur un thread d'arrière-plan et transmet les résultats à l'application grâce à un mécanisme d'événement. La reconnaissance de premier plan n'effectue pas de retour tant que la reconnaissance n'est pas terminée. Les résultats de reconnaissance sont donc disponibles au thread appelant sans écoute de l'événement de reconnaissance.

L'entrée manuscrite est continuellement traitée en arrière-plan. Si un Stroke est ajouté à la collection Strokes à laquelle le RecognizerContext fait référence, le Stroke est reconnu immédiatement. Pour plus d'informations, consultez les remarques de la rubrique consacrée à la méthode EndInkInput.

L'ensemble de la reconnaissance s'effectue via un contexte de reconnaissance. Le contexte définit les paramètres pour une session de reconnaissance unique. Il reçoit l'écriture manuscrite à reconnaître et définit les contraintes sur l'entrée manuscrite et sur la sortie de reconnaissance. Les contraintes qui peuvent être définies sur le contexte incluent notamment la langue, le dictionnaire et la grammaire utilisés.

Remarque :
La définition de propriétés autres que Strokes ou CharacterAutoCompletion aboutit uniquement si la collection Strokes a la valeur nullune référence null (Nothing en Visual Basic). Vous devez définir les autres propriétés avant d'attacher la collection Strokes au RecognizerContext ou affecter la valeur nullune référence null (Nothing en Visual Basic) à la collection Strokes, puis définir les autres propriétés. Si vous affectez la valeur nullune référence null (Nothing en Visual Basic) à la collection Strokes, puis que vous définissez les autres propriétés, vous devrez peut-être rattacher la collection Strokes. Cela tient au fait que la reconnaissance commence juste après l'assignation de la propriété Strokes au RecognizerContext. Lorsqu'un appel est passé à Recognize ou BackgroundRecognize, les résultats d'appel peuvent être déjà disponibles.

La définition de propriétés autres que Strokes ou CharacterAutoCompletion aboutit uniquement si la collection Strokes a la valeur nullune référence null (Nothing en Visual Basic). Vous devez définir les autres propriétés avant d'attacher la collection Strokes au RecognizerContext ou affecter la valeur nullune référence null (Nothing en Visual Basic) à la collection Strokes, puis définir les autres propriétés. Si vous affectez la valeur nullune référence null (Nothing en Visual Basic) à la collection Strokes, puis que vous définissez les autres propriétés, vous devrez peut-être rattacher la collection Strokes. Cela tient au fait que la reconnaissance commence juste après l'assignation de la propriété Strokes au RecognizerContext. Lorsqu'un appel est passé à Recognize ou BackgroundRecognize, les résultats d'appel peuvent être déjà disponibles.

Pour améliorer les performances de votre application, supprimez manuellement un objet RecognizerContext lorsque il n'est plus nécessaire.

Hiérarchie d'héritage

System.Object
Microsoft.Ink.RecognizerContext

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.