Partager via


CustomRecognizerNode, classe

Mise à jour : November 2007

Représente un ContextNode pour une opération de reconnaissance unique. Tous les traits et nœuds qui sont sous un objet CustomRecognizerNode sont reconnus pendant une opération de reconnaissance indépendante et ne sont pas analysés par le InkAnalyzer.

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

Syntaxe

'Déclaration
Public NotInheritable Class CustomRecognizerNode _
    Inherits ContextNode
'Utilisation
Dim instance As CustomRecognizerNode
public sealed class CustomRecognizerNode : ContextNode
public ref class CustomRecognizerNode sealed : public ContextNode
public final class CustomRecognizerNode extends ContextNode
public final class CustomRecognizerNode extends ContextNode

Notes

Un nœud CustomRecognizerNode peut contenir les types d'éléments enfants suivants :

  • Un nombre quelconque de nœuds d'entrée manuscrite non classifiés.

  • Un nombre quelconque de nœuds Object.

  • Un nombre quelconque de nœuds Line.

  • Un nombre quelconque de nœuds InkWord.

  • Un nombre quelconque de nœuds comportant une valeur Guid inconnue.

Un objet CustomRecognizerNode doit être l'enfant direct du RootNode.

La méthode la plus simple pour créer une reconnaissance personnalisée consiste à utiliser InkAnalyzer.CreateCustomRecognizer pour créer le module de reconnaissance et InkAnalyzer.AddStrokesToCustomRecognizer pour lui assigner des traits. Si vous ajoutez un trait qui est déjà assigné à un nœud de l'arborescence de contexte InkAnalyzer, y compris un UnclassifiedInkNode, une ArgumentException est levée. Pour éviter cela, utilisez la méthode InkAnalyzer.RemoveStroke ou InkAnalyzer.RemoveStrokes pour supprimer ces traits de l'arborescence de contexte InkAnalyzer avant de les ajouter au module de reconnaissance personnalisée.

Exemples

L'exemple suivant prend un Guid (page pouvant être en anglais) pour un module de reconnaissance personnalisée, customRecognizerId, et crée un CustomRecognizerNode pour un InkAnalyzer, theInkAnalyzer. Les traits sont ensuite ajoutés à partir d'une collection Strokes, strokesForCustomAnalysis. La méthode Analyze est alors appelée et la chaîne reconnue est placée dans un TextBox, theResultsTextBox (page pouvant être en anglais).

Dim customRecognizer As CustomRecognizerNode = _
    theInkAnalyzer.CreateCustomRecognizer(customRecognizerId)
theInkAnalyzer.AddStrokesToCustomRecognizer(strokesForCustomAnalysis, customRecognizer)

Dim theStatus As Microsoft.Ink.AnalysisStatus = theInkAnalyzer.Analyze()
theResultsTextBox.Text = customRecognizer.GetRecognizedString()
CustomRecognizerNode customRecognizer = 
    theInkAnalyzer.CreateCustomRecognizer(customRecognizerId);
theInkAnalyzer.AddStrokesToCustomRecognizer(strokesForCustomAnalysis, customRecognizer);

Microsoft.Ink.AnalysisStatus theStatus = theInkAnalyzer.Analyze();
theResultsTextBox.Text = customRecognizer.GetRecognizedString();

Hiérarchie d'héritage

System.Object
  Microsoft.Ink.ContextNode
    Microsoft.Ink.CustomRecognizerNode

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.

Informations de version

.NET Framework

Pris en charge dans : 3.0

Voir aussi

Référence

Membres CustomRecognizerNode

Microsoft.Ink, espace de noms