AnalysisAlternate, classe

Article
11/05/2008

Mise à jour : November 2007

Représente une des propositions de mots de reconnaissance de l'écriture manuscrite possibles pour les objets ContextNode.

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

Syntaxe

'Déclaration
Public Class AnalysisAlternate
'Utilisation
Dim instance As AnalysisAlternate

public class AnalysisAlternate

public ref class AnalysisAlternate

public class AnalysisAlternate

public class AnalysisAlternate

Notes

Étant donné qu'il existe de nombreuses variations entre l'écriture des différents utilisateurs, les modules de reconnaissance de l'écriture manuscrite convertissent parfois cette écriture en un texte différent de celui auquel pensait l'utilisateur. Lorsqu'un InkAnalyzer exécute une analyse sur une collection de traits, le InkAnalyzer recherche l'ensemble de mots que l'écriture manuscrite est la plus susceptible de représenter. De plus, le InkAnalyzer recherche également des ensembles de correspondances de reconnaissance alternatifs, stockés dans un AnalysisAlternateCollection. Pour qu'un utilisateur puisse tirer parti des propositions de substitution, vous devez créer une interface utilisateur qui lui permet de sélectionner le AnalysisAlternate correct.

Les objets AnalysisAlternate sont en général obtenus via la méthode InkAnalyzer.GetAlternates. Le premier objet AnalysisAlternate de la collection est considéré par le InkAnalyzer comme la proposition la plus probable.

Exemples

Cet exemple appelle des GetAlternates sur un InkAnalyzer, theInkAnalyzer. Il parcourt en boucle le AnalysisAlternateCollection et remplit un ListBox, alternatesListBox, avec toutes les propositions de substitution qui n'ont pas de InkRecognitionConfidence de la fiabilité de la reconnaissance de Poor.

alternatesListBox.Items.Clear()
' ContextNodeCollection selectedSubNodes is obtained via
' DirectCast(theInkAnalyzer.RootNode, RootNode).GetNodesFromTextRange(selStart, selLength);
Me.currentAlternates = theInkAnalyzer.GetAlternates(selectedSubNodes)
Dim alternate As AnalysisAlternate
For Each alternate In Me.currentAlternates
    ' Add only those that are not Poor confidence
    If alternate.InkRecognitionConfidence <> _
       Microsoft.Ink.InkRecognitionConfidence.Poor Then
        alternatesListBox.Items.Add(alternate.RecognizedString)
    End If
Next alternate

            alternatesListBox.Items.Clear();
            // ContextNodeCollection selectedSubNodes is obtained via
            // ((RootNode)theInkAnalyzer.RootNode).GetNodesFromTextRange(ref selStart, ref selLength);
            this.currentAlternates = theInkAnalyzer.GetAlternates(selectedSubNodes);
            foreach (AnalysisAlternate alternate in this.currentAlternates)
            {
                // Add only those that are not Poor confidence
                if (alternate.InkRecognitionConfidence !=
                    Microsoft.Ink.InkRecognitionConfidence.Poor)
                {
                    alternatesListBox.Items.Add(alternate.RecognizedString);
                }
            }

Hiérarchie d'héritage

System.Object
Microsoft.Ink.AnalysisAlternate

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.