Método IInkRecognitionAlternate::GetStrokesFromTextRange (msinkaut.h)
Recupera a coleção que corresponde ao menor conjunto de segmentos de reconhecimento que contém um intervalo de caracteres especificado dentro da alternativa.
Sintaxe
HRESULT GetStrokesFromTextRange(
[in, out] long *selectionStart,
[in, out] long *selectionLength,
[out, retval] IInkStrokes **GetStrokesFromTextRange
);
Parâmetros
[in, out] selectionStart
O início do intervalo de caracteres dentro dessa alternativa. O caractere na posição selectionStart está incluído no intervalo de texto reconhecido. Esse parâmetro é ajustado para o início do menor conjunto reconhecido de um ou mais segmentos que inclui a seleção de entrada. O parâmetro selectionStart é um índice baseado em zero nos caracteres no texto da alternativa de reconhecimento.
[in, out] selectionLength
O comprimento do intervalo de caracteres dentro da alternativa. Esse parâmetro deve ser maior que 0. Esse parâmetro é ajustado para o comprimento do menor conjunto de um ou mais segmentos que inclui a seleção de entrada.
[out, retval] GetStrokesFromTextRange
Após o retorno, contém um ponteiro para a coleção de traços que corresponde ao intervalo conhecido de texto reconhecido.
Retornar valor
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
Um parâmetro continha um ponteiro inválido. |
|
Ocorreu uma exceção dentro do método . |
|
Ocorreu um erro não especificado. |
|
Não é possível alocar o objeto auxiliar do manipulador de traços. |
Comentários
Para esclarecer ainda mais GetStrokesFromTextRange, considere uma coleção de traços que foi reconhecida e para a qual a melhor alternativa para esses traços é "como você está". O parâmetro passado para o método é algum intervalo dentro (ou possivelmente de todos) desse resultado de cadeia de caracteres. Essa alternativa contém cinco segmentos, um para cada palavra e outro para cada espaço. Os traços retornados correspondem ao menor conjunto de segmentos que incluem todo o intervalo de entrada. Se o parâmetro selectionStart for 0 e o parâmetro selectionLength for 5, criando um intervalo correspondente ao "como um" da cadeia de caracteres de resultado, os traços retornados serão todos os traços reconhecidos que compõem os segmentos "como estão". Esse é o menor conjunto de segmentos que inclui o intervalo de entrada.
Em reconhecedores baseados em palavras e caracteres, os espaços são contados como um caractere. Se a seleção de entrada corresponder a um caractere de espaço, esse método retornará e a coleção InkStrokes vazia.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP Tablet PC Edition [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | msinkaut.h |
| Biblioteca | InkObj.dll |
Confira também
Método GetStrokesFromStrokeRanges
Método GetTextRangeFromStrokes