Compartilhar via


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

Faz com que o objeto IInkRecognizer reconheça a coleção de traços associada e dispare um evento de reconhecimento quando o reconhecimento for concluído.

Sintaxe

HRESULT BackgroundRecognize(
  [in, optional] VARIANT CustomData
);

Parâmetros

[in, optional] CustomData

Especifica todos os dados definidos pelo aplicativo que estão disponíveis para o aplicativo no evento reconhecimento . Esse parâmetro pode ser um VARIANT do tipo VT_EMPTY ou VT_NULL se nenhum dado precisar ser passado. O valor padrão é NULL.

Para obter mais informações sobre a estrutura VARIANT, consulte Usando a biblioteca COM.

Valor de retorno

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
E_OUTOFMEMORY
Não é possível alocar memória para concluir a operação.
E_INK_NO_STROKES_TO_RECOGNIZE
Não existem traços.
E_INK_EXCEPTION
Ocorreu uma exceção dentro do método.

Observações

Esse método especifica que o reconhecimento de tinta é executado de forma assíncrona. Para reconhecer a tinta de forma síncrona, chame o método Recognize .

Esse método reconhece apenas a melhor cadeia de caracteres de resultado. Alternativas não são criadas. Para executar o reconhecimento que cria uma lista de alternativas disponíveis, chame o método BackgroundRecognizeWithAlternates .

O evento reconhecimento não será gerado se o reconhecedor não reconhecer nada.

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 BackgroundRecognizeWithAlternates

Propriedade Data

IInkRecognitionAlternate Interface

Iinkrecognizercontext

Classe InkRecognizerContext