RecognitionResult.GetAlternatesFromSelection, méthode (Int32, Int32, Int32)

Article
11/05/2008

Mise à jour : November 2007

Retourne la collection RecognitionAlternates à partir d'une plage dans la meilleure chaîne résultante de l'objet RecognitionResult, afin que chaque objet RecognitionAlternate de la collection ne corresponde qu'à un seul segment d'entrée manuscrite. La collection retournée est limitée à une taille donnée.

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

Syntaxe

'Déclaration
Public Function GetAlternatesFromSelection ( _
    selectionStart As Integer, _
    selectionLength As Integer, _
    maximumAlternates As Integer _
) As RecognitionAlternates
'Utilisation
Dim instance As RecognitionResult
Dim selectionStart As Integer
Dim selectionLength As Integer
Dim maximumAlternates As Integer
Dim returnValue As RecognitionAlternates

returnValue = instance.GetAlternatesFromSelection(selectionStart, _
    selectionLength, maximumAlternates)

public RecognitionAlternates GetAlternatesFromSelection(
    int selectionStart,
    int selectionLength,
    int maximumAlternates
)

public:
RecognitionAlternates^ GetAlternatesFromSelection(
    int selectionStart, 
    int selectionLength, 
    int maximumAlternates
)

public RecognitionAlternates GetAlternatesFromSelection(
    int selectionStart,
    int selectionLength,
    int maximumAlternates
)

public function GetAlternatesFromSelection(
    selectionStart : int, 
    selectionLength : int, 
    maximumAlternates : int
) : RecognitionAlternates

Paramètres

selectionStart
Type : System.Int32
Démarrage de la sélection de texte à partir de laquelle la collection RecognitionAlternates est retournée. La valeur par défaut est 0 (zéro).

selectionLength
Type : System.Int32
Longueur de la sélection de texte à partir de laquelle la collection RecognitionAlternates est retournée. La valeur par défaut est -1. Elle spécifie le début du texte, du démarrage de la sélection à la fin de la chaîne.

maximumAlternates
Type : System.Int32
Nombre maximal de propositions de substitution à retourner. La valeur par défaut est 10. Les modules de reconnaissance qui ne peuvent pas calculer le nombre de propositions de substitution, en raison de la difficulté ou de la durée, retournent un nombre arbitraire de propositions.

Valeur de retour

Type : Microsoft.Ink.RecognitionAlternates
Retourne la collection RecognitionAlternates à partir d'une sélection dans la meilleure chaîne résultante de l'objet RecognitionResult, afin que chaque objet RecognitionAlternate de la collection ne corresponde qu'à un seul segment d'entrée manuscrite.

Notes

Remarque :
Le nombre de propositions de substitution augmente de façon exponentielle pour les plages étendues et pour certaines langues. Les applications doivent spécifier le nombre de propositions plutôt que de demander au module de reconnaissance de retourner le nombre maximal de propositions.

Un module de reconnaissance peut diviser « comment ça va » en trois segments, un pour chaque mot, en fonction de l'espacement entre les segments. Appelez la méthode GetAlternatesFromSelection pour retourner les propositions de substitution d'un seul segment de cette sélection.

Notez la différence entre la méthode GetAlternatesFromSelection, la méthode AlternatesWithConstantPropertyValues, LineAlternateset les méthodes ConfidenceAlternates de l'objet RecognitionAlternate. Bien que la méthode GetAlternatesFromSelection retourne une collection RecognitionAlternates dans laquelle chaque objet RecognitionAlternate correspond à un seul segment d'entrée manuscrite dans une sélection, les méthodes AlternatesWithConstantPropertyValues, LineAlternateset ConfidenceAlternates retournent la collection RecognitionAlternates dans laquelle les objets RecognitionAlternate correspondent à chaque segment d'entrée manuscrite dans une sélection.

Exemples

Cet exemple C# retourne jusqu'à cinq objets RecognitionAlternate pour la sélection de l'utilisateur dans un contrôle TextBox, theTextBox (page pouvant être en anglais) disposant déjà du meilleur résultat de l'objet RecognitionResult. Les propositions sont stockées dans la collection RecognitionAlternates, theRecognitionAlternates, grâce à la méthode GetAlternatesFromSelection. Cette méthode permet à un utilisateur de sélectionner du texte reconnu et de rechercher ce texte dans les propositions pour le corriger.

[C#]

using Microsoft.Ink;
// . . .
try
{
    if (theTextBox.SelectionLength != 0)
    {
        RecognitionAlternates theRecognitionAlternates =
            theRecognitionResult.GetAlternatesFromSelection(
                theTextBox.SelectionStart, theTextBox.SelectionLength, 5);
        // Do something with theRecognitionAlternates here.
    }
}
catch
{
    // handle exceptions here.
}

Cet exemple Microsoft® Visual Basic® .NET retourne jusqu'à cinq objets RecognitionAlternate pour la sélection de l'utilisateur dans un contrôle TextBox (page pouvant être en anglais), theTextBox, disposant déjà du meilleur résultat de l'objet RecognitionResult. Les propositions sont stockées dans la collection RecognitionAlternates, theRecognitionAlternates, grâce à la méthode GetAlternatesFromSelection. Cette méthode permet à un utilisateur de sélectionner du texte reconnu et de rechercher ce texte dans les propositions pour le corriger.

[Visual Basic]

Imports Microsoft.Ink
' . . .
Try
    If theTextBox.SelectionLength != 0 Then
        Dim theRecognitionAlternates As RecognitionAlternates
        theRecognitionAlternates = _
            theRecognitionResult.GetAlternatesFromSelection( _
                theTextBox.SelectionStart, _
                theTextBox.SelectionLength, 5)
        'Do something with theRecognitionAlternates here.
    End If
Catch
    'Handle exceptions here.
End Try

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.