RecognitionAlternate.GetStrokesFromTextRange (Método)

Artículo
11/26/2008

Actualización: noviembre 2007

Devuelve la colección Strokes que corresponde al conjunto más pequeño del segmento de reconocimiento que contiene un intervalo de caracteres especificado dentro de la alternativa.

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

Sintaxis

'Declaración
Public Function GetStrokesFromTextRange ( _
    ByRef selectionStart As Integer, _
    ByRef selectionLength As Integer _
) As Strokes
'Uso
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

Parámetros

selectionStart
Tipo: System.Int32%
El inicio del intervalo de caracteres dentro de esta alternativa.

selectionLength
Tipo: System.Int32%
La longitud del intervalo de caracteres dentro de la alternativa. Este parámetro debe ser mayor que 0. Este parámetro se ajusta a la longitud del conjunto más pequeño de uno o varios segmentos que incluye la selección de entrada.

Valor devuelto

Tipo: Microsoft.Ink.Strokes
Devuelve la colección Strokes que corresponde al conjunto más pequeño de segmentos que contiene un intervalo de caracteres especificado dentro de la alternativa.

Comentarios

El carácter en la posición selectionStart se incluye en el intervalo de texto reconocido. Este parámetro se ajusta al principio de conjunto reconocido más pequeño de uno o varios segmentos que incluye la selección de entrada. El parámetro selectionStart es un índice de base cero incluido en los caracteres del texto de la alternativa de reconocimiento.

Considere una colección Strokes que se haya reconocido y para la que la mejor alternativa es la frase inglesa "how are you". El parámetro pasado a este método es algún intervalo (o posiblemente todos) dentro de este resultado de cadena. Esta alternativa contiene cinco segmentos, uno para cada palabra y uno para cada espacio. Los trazos devueltos corresponden al conjunto de segmentos más pequeño que incluyen todo el rango de entrada. Si el parámetro selectionStart es 0, y el parámetro selectionLength es 5, al crear un intervalo que corresponde a "how a" en la cadena de resultado, los trazos devueltos serán todos los trazos reconocidos que constituyen los segmentos "how are". Éste es el conjunto de segmentos más pequeño que incluye el rango de entrada.

En los reconocedores basados en palabras y en caracteres, los espacios se cuentan como un carácter. Si la selección de entrada corresponde a un carácter de espacio en blanco, este método devuelve una colección Strokes vacía.

Ejemplos

En este ejemplo de C# se busca la colección Strokes, altStrokes, asociada al conjunto más pequeño de objetos RecognitionAlternate que contienen el intervalo de texto.

[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);

En este ejemplo de Microsoft® Visual Basic® .NET se busca la colección Strokes, altStrokes, asociada al conjunto más pequeño de objetos RecognitionAlternate que contienen el intervalo de texto.

[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)

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.