Método IInkRecognitionAlternate::GetStrokesFromTextRange (msinkaut.h)

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

Sintaxis

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

Parámetros

[in, out] selectionStart

Inicio del intervalo de caracteres dentro de esta alternativa. El carácter de la posición selectionStart se incluye en el intervalo de texto reconocido. Este parámetro se ajusta al principio del 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 en los caracteres del texto de la alternativa de reconocimiento.

[in, out] selectionLength

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.

[out, retval] GetStrokesFromTextRange

Tras la devolución, contiene un puntero a la colección de trazos que corresponde al intervalo conocido de texto reconocido.

Valor de retorno

Este método puede devolver uno de estos valores.

Código de retorno Descripción
S_OK
Éxito.
E_POINTER
Un parámetro contenía un puntero no válido.
E_INK_EXCEPTION
Se produjo una excepción dentro del método .
E_FAIL
Error no especificado.
E_OUTOFMEMORY
No se puede asignar el objeto auxiliar del controlador de trazos.

Observaciones

Para aclarar aún más GetStrokesFromTextRange, considere una colección de trazos que se han reconocido y para el que la mejor alternativa para esos trazos es "cómo es usted". El parámetro pasado al método es un intervalo dentro de (o posiblemente todos) este resultado de cadena. Esta alternativa contiene cinco segmentos, uno para cada palabra y otro para cada espacio. Los trazos devueltos corresponden al conjunto más pequeño de segmentos que incluyen todo el intervalo de entrada. Si el parámetro selectionStart es 0 y el parámetro selectionLength es 5, creando un intervalo correspondiente a la "forma a" de la cadena de resultado, los trazos devueltos son todos los trazos reconocidos que componen los segmentos "cómo están". Este es el conjunto más pequeño de segmentos que incluye el intervalo de entrada.

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

Requisitos

Requisito Importancia
Cliente mínimo compatible Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo admitido No se admite ninguno
de la plataforma de destino de Windows
Header msinkaut.h

Consulte también

GetStrokesFromStrokeRanges (método)

GetTextRangeFromStrokes (método)

Interfaz alternativa IInkRecognition

Colección InkStrokes