RecognitionAlternate.GetStrokesFromStrokeRanges, méthode

Article
11/05/2008

Mise à jour : November 2007

Retourne la plus petite collection Strokes qui contient une collection Strokes connue et pour laquelle le module de reconnaissance peut fournir des propositions de substitution.

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

Syntaxe

'Déclaration
Public Function GetStrokesFromStrokeRanges ( _
    s As Strokes _
) As Strokes
'Utilisation
Dim instance As RecognitionAlternate
Dim s As Strokes
Dim returnValue As Strokes

returnValue = instance.GetStrokesFromStrokeRanges(s)

public Strokes GetStrokesFromStrokeRanges(
    Strokes s
)

public:
Strokes^ GetStrokesFromStrokeRanges(
    Strokes^ s
)

public Strokes GetStrokesFromStrokeRanges(
    Strokes s
)

public function GetStrokesFromStrokeRanges(
    s : Strokes
) : Strokes

Paramètres

s
Type : Microsoft.Ink.Strokes
Collection Strokes à utiliser pour rechercher la plus petite collection Strokes de la proposition de substitution du résultat de la reconnaissance.

Valeur de retour

Type : Microsoft.Ink.Strokes
Retourne la plus petite collection Strokes qui contient une collection Strokes connue et pour laquelle le module de reconnaissance peut fournir des propositions de substitution.

Notes

La collection Strokes retournée peut correspondre à la collection d'entrée ou être plus grande si cette dernière correspond uniquement à une partie du plus petit résultat de reconnaissance qui inclut tous les traits d'entrée.

Cette méthode est particulièrement utile pour la sélection de mots par clic simple. Par exemple, pour retourner les traits qui composent le mot sur lequel vous cliquez, vous pouvez cliquer sur un objet Stroke, appeler la méthode HitTest de l'objet Ink pour retourner ce trait, puis appeler la méthode GetStrokesFromStrokeRanges.

Les plages de traits sont valides jusqu'à la modification de l'objet Ink.

Exemples

Cet exemple C# retourne la collection Strokes associée au plus petit ensemble d'objets RecognitionAlternate qui inclut la collection Strokes sélectionnée par un clic au niveau de ptMouseDown dans l'espace de dessin de Form1, dans lequel les traits d'entrée manuscrite ont été reconnus, et le résultat se trouve dans un objet RecognitionResult, theRecognitionResult.

[C#]

Strokes hitStrokes;
Strokes altStrokes;
// Convert the mouse down to ink space coordinates
theInkCollector.Renderer.PixelToInkSpace(this.CreateGraphics(), ref ptMouseDown);
// Get the strokes hit by the mouse (within a radius of 100 HIMETRIC)
hitStrokes = theInkCollector.Ink.HitTest(ptMouseDown, 100);
if (hitStrokes.Count > 0)
{
    altStrokes = theRecognitionResult.TopAlternate.GetStrokesFromStrokeRanges(hitStrokes);
    //...
}

Cet exemple Visual Basic .NET retourne la collection Strokes associée au plus petit ensemble d'objets RecognitionAlternate qui inclut la collection Strokes sélectionnée par un clic au niveau de ptMouseDown dans l'espace de dessin de Form1, dans lequel les traits d'entrée manuscrite ont été reconnus et le résultat se trouve dans un objet RecognitionResult, theRecognitionResult.

[Visual Basic]

Dim hitStrokes As Strokes
Dim altStrokes As Strokes
' Convert the mouse down to ink space coordinates
theInkCollector.Renderer.PixelToInkSpace( _
    Me.CreateGraphics(), ptMouseDown)
' Get the strokes hit by the mouse (within a radius of 100 HIMETRIC)
hitStrokes = theInkCollector.Ink.HitTest(ptMouseDown, 100)
If hitStrokes.Count > 0 Then
    altStrokes = theRecognitionResult.TopAlternate.GetStrokesFromStrokeRanges( _
        hitStrokes)
    '...
End If

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.