Metodo RecognitionAlternate.GetStrokesFromStrokeRanges

Articolo
10/29/2008

Aggiornamento: novembre 2007

Restituisce l'insieme Strokes più piccolo contenente un insieme Strokes noto e per il quale il sistema di riconoscimento può fornire alternative.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

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

Parametri

s
Tipo: Microsoft.Ink.Strokes
Insieme Strokes da utilizzare per trovare l'insieme Strokes più piccolo dell'alternativa del risultato del riconoscimento contenente questo insieme.

Valore restituito

Tipo: Microsoft.Ink.Strokes
Restituisce l'insieme Strokes più piccolo contenente un insieme Strokes noto e per il quale il sistema di riconoscimento può fornire alternative.

Note

L'insieme Strokes restituito potrebbe corrispondere all'insieme di input o potrebbe essere più grande se l'insieme di input corrisponde solo alla parte del risultato del riconoscimento più piccolo che include tutti i tratti di input.

Questo metodo è molto utile per la selezione di una parola con un clic singolo. Ad esempio, per restituire i tratti che costituiscono la parola selezionata con un clic, è possibile fare clic su un oggetto Stroke, chiamare il metodo HitTest dell'oggetto Ink per restituire quel tratto, quindi chiamare l'oggetto GetStrokesFromStrokeRanges.

Gli intervalli del tratto sono validi fino a quando l'oggetto Ink non viene modificato.

Esempi

In questo esempio di C# viene restituito l'insieme Strokes associato all'insieme di oggetti RecognitionAlternate più piccolo che include l'insieme Strokes selezionato facendo clic sul mouse in corrispondenza di ptMouseDown nello spazio di disegno di Form1, dove sono stati riconosciuti i tratti dell'input penna e il risultato è in un oggetto 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);
    //...
}

In questo esempio di Visual Basic .NET viene restituito l'insieme Strokes associato all'insieme di oggetti RecognitionAlternate più piccolo che include l'insieme Strokes selezionato facendo clic sul mouse in corrispondenza di ptMouseDown nello spazio di disegno di Form1, dove sono stati riconosciuti i tratti dell'input penna e il risultato è in un oggetto 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

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.