Metodo RecognitionAlternate.GetStrokesFromTextRange

Articolo
10/29/2008

Aggiornamento: novembre 2007

Restituisce l'insieme Strokes che corrisponde all'insieme di segmenti di riconoscimento più piccolo che contiene un intervallo di caratteri specificato all'interno dell'alternativa.

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

Sintassi

'Dichiarazione
Public Function GetStrokesFromTextRange ( _
    ByRef selectionStart As Integer, _
    ByRef selectionLength As Integer _
) As Strokes
'Utilizzo
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

Parametri

selectionStart
Tipo: System.Int32%
Inizio dell'intervallo di caratteri all'interno di questa alternativa.

selectionLength
Tipo: System.Int32%
Lunghezza dell'intervallo di caratteri all'interno dell'alternativa. Questo parametro deve essere maggiore di 0. Il parametro viene modificato in corrispondenza della lunghezza dell'insieme di uno o più segmenti più piccolo comprendente la selezione di input.

Valore restituito

Tipo: Microsoft.Ink.Strokes
Restituisce l'insieme Strokes che corrisponde all'insieme di segmenti di riconoscimento più piccolo contenente un intervallo di caratteri specificato all'interno dell'alternativa.

Note

Carattere nella posizione selectionStart incluso nell'intervallo di testo riconosciuto. Questo parametro viene modificato in corrispondenza dell'inizio dell'insieme di uno o più segmenti più piccolo riconosciuto comprendente la selezione di input. Il parametro selectionStart è un indice in base zero nei caratteri del testo dell'alternativa di riconoscimento.

Si consideri un insieme Strokes riconosciuto e per il quale la migliore alternativa è "how are you". Il parametro passato a questo metodo è parte dell'intervallo (o forse tutto) all'interno di questo risultato della stringa. Questa alternativa contiene cinque segmenti, uno per ogni parola e uno per ogni spazio. I tratti restituiti corrispondono all'insieme di segmenti più piccolo che include tutto l'intervallo di input. Se il parametro selectionStart è 0 e il parametro selectionLength è 5, creando un intervallo corrispondente a "how a" della stringa del risultato, i tratti restituiti sono tutti i tratti riconosciuti che costituiscono i segmenti "how are". Si tratta dell'insieme di segmenti più piccolo che include l'intervallo di input.

In entrambi i sistemi di riconoscimento, sia quello basato sulla parola sia quello basato sul carattere, gli spazi vengono contati come un carattere. Se la selezione di input corrisponde a uno spazio, questo metodo restituisce un insieme Strokes vuoto.

Esempi

In questo esempio di C# viene trovato l'insieme Strokes, altStrokes associato all'insieme di oggetti RecognitionAlternate più piccolo che include l'intervallo di testo.

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

In questo esempio di Microsoft® Visual Basic® .NET viene trovato l'insieme Strokes, altStrokes associato all'insieme di oggetti RecognitionAlternate più piccolo che include l'intervallo di testo.

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

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.