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

Artigo
02/29/2024

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