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 retorna, contém um ponteiro para os resultados IInkRecognitionResult de uma coleção reconhecida de traços ou null se o reconhecedor não pôde calcular um resultado para a tinta.

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

Comentários

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 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 BackgroundRecognize

Método BackgroundRecognizeWithAlternates

IInkRecognitionResult Interface

Iinkrecognizercontext

Classe InkDisp

Classe InkRecognizerContext

Coleção InkStrokes