Compartilhar via


Método IInkRecognizerContext::Recognize (msinkaut.h)

Executa o reconhecimento em uma coleção InkStrokes e retorna resultados de reconhecimento.

Sintaxe

HRESULT Recognize(
  [in, out]     InkRecognitionStatus  *RecognitionStatus,
  [out, retval] IInkRecognitionResult **RecognitionResult
);

Parâmetros

[in, out] RecognitionStatus

O valor inkrecognitionStatus mais recente.

[out, retval] RecognitionResult

Quando esse método é retornado, contém um ponteiro para os resultados de IInkRecognitionResult de uma coleção reconhecida de traços ou, em outra forma, NULL se o reconhecedor não pôde calcular um resultado para a tinta.

Valor de retorno

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_UNEXPECTED
Parâmetro inesperado ou tipo de propriedade.
E_INK_EXCEPTION
Ocorreu uma exceção dentro do método.
E_OUTOFMEMORY
Não é possível alocar a operação de memória.

Observações

Esse método executa o reconhecimento de forma síncrona. Para iniciar o reconhecimento em segundo plano ou assíncrono, chame os métodos BackgroundRecognize ou BackgroundRecognizeWithAlternates .

Você deve usar um bloco try/catch ao chamar Recognize porque uma exceção é gerada quando o objeto InkDisp não contém traços ou apenas traços excluídos.

Requisitos

Requisito Valor
Cliente mínimo suportado Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo compatível Nenhum compatível
da Plataforma de Destino Windows
Header msinkaut.h

Consulte também

Método BackgroundRecognize

Método BackgroundRecognizeWithAlternates

IInkRecognitionResult Interface

Iinkrecognizercontext

Classe InkDisp

Classe InkRecognizerContext

Coleção InkStrokes