Metodo IInkRecognitionAlternate::GetStrokesFromTextRange (msinkaut.h)

Recupera la raccolta che corrisponde al set più piccolo di segmenti di riconoscimento che contiene un intervallo di caratteri specificato all'interno dell'alternativa.

Sintassi

HRESULT GetStrokesFromTextRange(
  [in, out]     long        *selectionStart,
  [in, out]     long        *selectionLength,
  [out, retval] IInkStrokes **GetStrokesFromTextRange
);

Parametri

[in, out] selectionStart

Inizio dell'intervallo di caratteri all'interno di questa alternativa. Il carattere nella posizione selectionStart è incluso nell'intervallo di testo riconosciuto. Questo parametro viene modificato all'inizio del set riconosciuto più piccolo di uno o più segmenti che includono la selezione di input. Il parametro selectionStart è un indice in base zero nei caratteri nel testo dell'alternativo di riconoscimento.

[in, out] selectionLength

Lunghezza dell'intervallo di caratteri all'interno dell'alternativa. Questo parametro deve essere maggiore di 0. Questo parametro viene regolato in base alla lunghezza del set più piccolo di uno o più segmenti che include la selezione di input.

[out, retval] GetStrokesFromTextRange

Al ritorno, contiene un puntatore alla raccolta di tratti che corrisponde all'intervallo noto di testo riconosciuto.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_POINTER	Un parametro contiene un puntatore non valido.
E_INK_EXCEPTION	Si è verificata un'eccezione all'interno del metodo .
E_FAIL	Si è verificato un errore non specificato.
E_OUTOFMEMORY	Impossibile allocare l'oggetto helper del gestore tratti.

Commenti

Per chiarire ulteriormente GetStrokesFromTextRange, prendere in considerazione una raccolta di tratti riconosciuti e per i quali il miglior alternativa per tali tratti è "come sei". Il parametro passato al metodo è un intervallo compreso tra (o possibilmente tutti) il risultato della stringa. Questo alternativo contiene cinque segmenti, uno per ogni parola e uno per ogni spazio. I tratti restituiti corrispondono al set più piccolo di segmenti che includono tutti gli intervalli di input. Se il parametro selectionStart è 0 e il parametro selectionLength è 5, creando un intervallo corrispondente alla "modalità" della stringa di risultato, i tratti restituiti sono tutti i tratti riconosciuti che costituiscono i segmenti "how are". Si tratta del set più piccolo di segmenti che include l'intervallo di input.

Nei riconoscitori basati su parole e caratteri, gli spazi vengono conteggiati come carattere. Se la selezione di input corrisponde a uno spazio, questo metodo restituisce e un insieme InkStrokes vuoto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	msinkaut.h
Libreria	InkObj.dll

Vedi anche

Metodo GetStrokesFromStrokeRanges

Metodo GetTextRangeFromStrokes

Interfaccia alternativa IInkRecognition

Insieme InkStrokes