RecognitionAlternate.GetStrokesFromStrokeRanges (Método)

Artículo
11/26/2008

Actualización: noviembre 2007

Devuelve la colección Strokes más pequeña que contiene una colección Strokes conocida y para la que el reconocedor puede proporcionar alternativas.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Function GetStrokesFromStrokeRanges ( _
    s As Strokes _
) As Strokes
'Uso
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

Parámetros

s
Tipo: Microsoft.Ink.Strokes
La colección Strokes que se debe utilizar para buscar la colección Strokes más pequeña de la alternativa del resultado de reconocimiento que contiene esta colección.

Valor devuelto

Tipo: Microsoft.Ink.Strokes
Devuelve la colección Strokes más pequeña que contiene una colección Strokes conocida y para la que el reconocedor puede proporcionar alternativas.

Comentarios

La colección Strokes devuelta puede coincidir con la colección de entrada, o puede ser mayor si la colección de entrada coincide sólo con parte del resultado del reconocimiento más pequeño que incluye todos los trazos de entrada.

Este método es el más adecuado para la selección de palabras mediante un único clic. Por ejemplo, para devolver los trazos que forman la palabra en la que hace clic, puede hacer clic en un objeto Stroke, llamar al método HitTest del objeto Ink para devolver dicho trazo y, a continuación, llamar al método GetStrokesFromStrokeRanges.

Los intervalos de trazos son válidos hasta que se modifique el objeto Ink.

Ejemplos

En este ejemplo de C# se devuelve la colección Strokes que está asociada al conjunto de objetos RecognitionAlternate más pequeño que incluye la colección Strokes seleccionada haciendo clic con el mouse en ptMouseDown en el espacio de dibujo de Form1, en el que se han reconocido los trazos de la entrada manuscrita y el resultado se encuentra en un objeto 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);
    //...
}

En este ejemplo de Visual Basic .NET se devuelve la colección Strokes que está asociada al conjunto de objetos RecognitionAlternate más pequeño que incluye la colección Strokes seleccionada haciendo clic con el mouse en ptMouseDown en el espacio de dibujo de Form1, en el que se han reconocido los trazos de la entrada manuscrita y el resultado se encuentra en un objeto 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

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.