Compartir a través de

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

  • Artículo

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 devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Correcto.
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
 Se ha producido un error no especificado.
E_OUTOFMEMORY
 No se puede asignar el objeto auxiliar del controlador de trazos.

Comentarios

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" 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 Value
Cliente mínimo compatible Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado msinkaut.h
Library InkObj.dll

Consulte también

GetStrokesFromStrokeRanges (método)

GetTextRangeFromStrokes (método)

Interfaz alternativa IInkRecognition

Colección InkStrokes