Função AdviseInkChange (recapis.h)

Impede que o reconhecedor processe a tinta porque um traço foi adicionado ou excluído.

Sintaxe

HRESULT AdviseInkChange(
  HRECOCONTEXT hrc,
  BOOL         bNewStroke
);

Parâmetros

hrc

O identificador para o contexto do reconhecedor.

bNewStroke

TRUE se adicionar um novo traço. Defina como FALSE se os traços foram apagados, divididos, mesclados, extraídos ou excluídos do objeto Ink.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno	Descrição
S_OK	Êxito. Essa função também retornará S_OK se o reconhecedor não der suporte a essa função.
E_POINTER	Um dos parâmetros é um ponteiro inválido.
E_FAIL	Ocorreu um erro não especificado.
E_INVALIDARG	Um argumento inválido foi recebido.

Comentários

A função AdviseInkChange sinaliza que haverá chamadas adicionais para a função AddStroke . Isso permite que qualquer reconhecimento já em andamento pare em qualquer ponto conveniente. A conclusão do reconhecimento é um desses pontos, portanto , AdviseInkChange não pode fazer nada com segurança.

Por exemplo, se você tiver dois threads, um thread poderá estar usando AddStroke e Process com outras funções para obter resultados. O outro thread pode estar coletando tinta, ecoando-a e enfileirando tarefas para o primeiro thread. O segundo thread chama AdviseInkChange para notificar o reconhecedor de que uma alteração está chegando. Isso permite que o primeiro thread retorne ao chamador mais cedo do que sem a chamada para AdviseInkChange. O primeiro thread pode chamar o reconhecedor novamente com mais tinta.

Se você definir o parâmetro bNewStroke como FALSE porque um traço foi modificado ou excluído, você também deve chamar a função ResetContext e, em seguida, chamar a função AddStroke para adicionar os traços do objeto InkDisp ao contexto do reconhecedor. Isso será feito automaticamente se você anexar o contexto do reconhecedor ao objeto InkDisp .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP Tablet PC Edition [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	recapis.h
DLL	inkobjcore.dll