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

  • Artigo

Recupera a menor coleção InkStrokes que contém uma coleção InkStrokes de entrada conhecida e para a qual o objeto IInkRecognizer pode fornecer alternativas.

Sintaxe

HRESULT GetStrokesFromStrokeRanges(
  [in]          IInkStrokes *Strokes,
  [out, retval] IInkStrokes **GetStrokesFromStrokeRanges
);

Parâmetros

[in] Strokes

A coleção de objetos stroke a serem usados para localizar a menor coleção de traços da alternativa de resultado de reconhecimento que contém essa coleção.

[out, retval] GetStrokesFromStrokeRanges

Quando este método retorna, contém um ponteiro para a menor coleção de traços que contém uma coleção de entrada conhecida de traços e para a qual o reconhecedor pode fornecer alternativas.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.
E_POINTER
 Um parâmetro continha um ponteiro inválido.
E_INK_EXCEPTION
 Ocorreu uma exceção dentro do método .
E_INK_MISMATCHED_INK_OBJECT
 O parâmetro strokes está associado a um objeto Ink diferente.
E_FAIL
 Ocorreu um erro não especificado.

Comentários

A coleção retornada pode corresponder à coleção de entrada ou pode ser maior se a coleção de entrada corresponder apenas a parte do menor resultado de reconhecimento que inclui todos os traços de entrada.

Esse método é mais útil para seleção de palavras de clique único. Por exemplo, para retornar os traços que compõem a palavra clicada, você pode clicar em um traço, chamar o método HitTest do objeto IInkStrokeDisp para recuperar o traço que foi clicado e, em seguida, chamar GetStrokesFromStrokeRanges.

Os intervalos de traço são válidos até que o objeto InkDisp seja modificado.

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 GetStrokesFromTextRange

Método GetTextRangeFromStrokes

Interface alternativa IInkRecognition

Coleção InkStrokes