RecognitionAlternate.GetStrokesFromStrokeRanges-Methode

Artikel
11/26/2008

Gibt die kleinste Strokes-Auflistung zurück, die eine bekannte Strokes-Auflistung enthält und für die das Erkennungsmodul Alternativen bereitstellen kann.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Function GetStrokesFromStrokeRanges ( _
    s As Strokes _
) As Strokes
'Usage
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

Parameter

s
Typ: Microsoft.Ink.Strokes
Die Strokes-Auflistung, mit der die kleinste Strokes-Auflistung der Erkennungsergebnisalternative gesucht werden soll, die diese Auflistung enthält.

Rückgabewert

Typ: Microsoft.Ink.Strokes
Gibt die kleinste Strokes-Auflistung zurück, die eine bekannte Strokes-Auflistung enthält und für die das Erkennungsmodul Alternativen bereitstellen kann.

Hinweise

Die zurückgegebene Strokes-Auflistung kann der Eingabeauflistung entsprechen oder größer sein, wenn die Eingabeauflistung nur einem Teil des kleinsten Erkennungsergebnisses entspricht, das alle Eingabestriche umfasst.

Diese Methode ist für die Wortauswahl durch einfaches Klicken äußerst nützlich. Um beispielsweise die Striche zurückzugeben, aus denen das angeklickte Wort besteht, können Sie auf ein Stroke-Objekt klicken, die HitTest-Methode des Ink-Objekts aufrufen, um diesen Strich zurückzugeben, und dann GetStrokesFromStrokeRanges aufrufen.

Die Strichbereiche sind so lange gültig, bis das Ink-Objekt geändert wird.

Beispiele

In diesem C#-Beispiel wird die Strokes-Auflistung zurückgegeben, die dem kleinsten Satz von RecognitionAlternate-Objekten mit der Strokes-Auflistung zugeordnet ist, die durch Klicken mit der Maus bei ptMouseDown im Zeichenbereich von Form1 ausgewählt wird, in dem die Striche erkannt wurden und das Ergebnis sich in einem RecognitionResult-Objekt mit dem Namen theRecognitionResult befindet.

[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);
    //...
}

In diesem Visual Basic .NET-Beispiel wird die Strokes-Auflistung zurückgegeben, die dem kleinsten Satz von RecognitionAlternate-Objekten mit der Strokes-Auflistung zugeordnet ist, die durch Klicken mit der Maus bei ptMouseDown im Zeichenbereich von Form1 ausgewählt wird, in dem die Striche erkannt wurden und das Ergebnis sich in einem RecognitionResult-Objekt mit dem Namen theRecognitionResult befindet.

[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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.