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.

Código devuelto	Descripción
S_OK	Correcto. Esta función también devuelve S_OK si el reconocedor no admite esta función.
E_POINTER	Uno de los parámetros es un puntero no válido.
E_FAIL	Se ha producido un error no especificado.
E_INVALIDARG	Se recibió un argumento no válido.

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

Requisito	Value
Cliente mínimo compatible	Windows XP Tablet PC Edition [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	recapis.h
Archivo DLL	inkobjcore.dll