Función AdviseInkChange (recapis.h)

Impide que el reconocedor procese la entrada de lápiz porque se ha agregado o eliminado un trazo.

Sintaxis

HRESULT AdviseInkChange(
  HRECOCONTEXT hrc,
  BOOL         bNewStroke
);

Parámetros

hrc

Identificador del contexto del reconocedor.

bNewStroke

TRUE si agrega un nuevo trazo. Se establece en FALSE si se borran, dividen, combinan, extraen o eliminan trazos del objeto Ink.

Valor devuelto

Esta función puede devolver uno de estos valores.

Comentarios

La función AdviseInkChange indica que habrá llamadas adicionales a la función AddStroke . Esto permite que cualquier reconocimiento que ya esté en curso se detenga en cualquier punto conveniente. La finalización del reconocimiento es un punto de este tipo, por lo que AdviseInkChange no puede hacer nada de forma segura.

Por ejemplo, si tiene dos subprocesos, un subproceso puede usar AddStroke y Process con otras funciones para obtener resultados. El otro subproceso puede estar recopilando entrada de lápiz, reproducirlo y poner en cola tareas para el primer subproceso. El segundo subproceso llama a AdviseInkChange para notificar al reconocedor un cambio. Esto permite que el primer subproceso vuelva al autor de la llamada antes que sin la llamada a AdviseInkChange. El primer subproceso puede volver a llamar al reconocedor con más entrada de lápiz.

Si establece el parámetro bNewStroke en FALSE porque se modificó o eliminó un trazo, también debe llamar a la función ResetContext y, a continuación, llamar a la función AddStroke para agregar los trazos del objeto InkDisp al contexto del reconocedor. Esto se hace automáticamente si asocia el contexto del reconocedor al objeto InkDisp .

Requisitos