RecognitionAlternate.GetStrokesFromTextRange, méthode

Article
11/05/2008

Mise à jour : November 2007

Retourne la collection Strokes qui correspond au plus petit ensemble de segments de reconnaissance qui contient une plage de caractères spécifiée dans la proposition de substitution.

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

Syntaxe

'Déclaration
Public Function GetStrokesFromTextRange ( _
    ByRef selectionStart As Integer, _
    ByRef selectionLength As Integer _
) As Strokes
'Utilisation
Dim instance As RecognitionAlternate
Dim selectionStart As Integer
Dim selectionLength As Integer
Dim returnValue As Strokes

returnValue = instance.GetStrokesFromTextRange(selectionStart, _
    selectionLength)

public Strokes GetStrokesFromTextRange(
    ref int selectionStart,
    ref int selectionLength
)

public:
Strokes^ GetStrokesFromTextRange(
    int% selectionStart, 
    int% selectionLength
)

public Strokes GetStrokesFromTextRange(
    /** @ref */int selectionStart,
    /** @ref */int selectionLength
)

public function GetStrokesFromTextRange(
    selectionStart : int, 
    selectionLength : int
) : Strokes

Paramètres

selectionStart
Type : System.Int32%
Début de la plage de caractères dans cette proposition de substitution.

selectionLength
Type : System.Int32%
Longueur de la plage de caractères dans cette proposition de substitution. Ce paramètre doit être supérieur à 0. Il est ajusté à la longueur du plus petit ensemble constitué d'un ou de plusieurs segments qui inclut la sélection d'entrée.

Valeur de retour

Type : Microsoft.Ink.Strokes
Retourne la collection Strokes qui correspond au plus petit ensemble de segments de reconnaissance qui contient une plage de caractères spécifiée dans la proposition de substitution.

Notes

Le caractère à la position selectionStart est inclus dans la plage de texte reconnu. Ce paramètre est ajusté au début du plus petit ensemble reconnu d'un ou de plusieurs segments qui inclut la sélection d'entrée. Le paramètre selectionStart est un index de base zéro dans les caractères du texte de la proposition de substitution de reconnaissance.

Prenons une collection Strokes reconnue pour laquelle la meilleure proposition de substitution est « comment ça va ». Le paramètre passé à cette méthode correspond à une plage (ou éventuellement à l'ensemble) de ce résultat de chaîne. Cette proposition de substitution contient cinq segments, un pour chaque mot et un pour chaque espace. Les traits retournés correspondent au plus petit ensemble de segments qui inclut l'ensemble de la plage d'entrée. Si le paramètre selectionStart est égal à 0 et le paramètre selectionLength à 9, ce qui crée une plage correspondant à la chaîne de résultat « comment ç », les traits retournés sont tous les traits reconnus qui composent les segments « comment ça ». Il s'agit du plus petit ensemble de segments qui inclut la plage d'entrée.

Dans les deux modules de reconnaissance (basés sur les mots et sur les caractères), un espace est considéré comme un caractère. Si la sélection d'entrée correspond à un espace, cette méthode retourne une collection Strokes vide.

Exemples

Cet exemple C# recherche la collection Strokes, altStrokes, associée au plus petit ensemble d'objets RecognitionAlternate qui inclut la plage de texte.

[C#]

theTextBox.Text = theRecognitionResult.TopString;
//... Assume the user has selected a range within theTextBox.
int selStart = theTextBox.SelectionStart;
int selLength = theTextBox.SelectionLength;
Strokes altStrokes;
altStrokes = theRecognitionResult.TopAlternate.GetStrokesFromTextRange(
    ref selStart, ref selLength);

Cet exemple Microsoft® Visual Basic® .NET recherche la collection Strokes, altStrokes, associée au plus petit ensemble d'objets RecognitionAlternate qui inclut la plage de texte.

[Visual Basic]

theTextBox.Text = theRecognitionResult.TopString
'... Assume the user has selected a range within theTextBox.
Dim selStart As Integer = theTextBox.SelectionStart
Dim selLength As Integer = theTextBox.SelectionLength
Dim altStrokes As Strokes
altStrokes = theRecognitionResult.TopAlternate.GetStrokesFromTextRange( _
    selStart, selLength)

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.