Función SetGuide (recapis.h)

  • Artículo

Establece la guía de reconocimiento que se va a usar para la entrada boxed o lined. Debe llamar a esta función antes de agregar trazos al contexto.

Sintaxis

HRESULT SetGuide(
  HRECOCONTEXT     hrc,
  const RECO_GUIDE *pGuide,
  ULONG            iIndex
);

Parámetros

hrc

Identificador del contexto del reconocedor.

pGuide

Guía para usar para la entrada de cuadro o línea. Establecer este parámetro en NULL significa que el contexto no tiene ninguna guía. Este es el valor predeterminado y significa que el reconocedor está en modo de entrada libre. Para obtener más información sobre la guía, consulte la estructura de RECO_GUIDE .

iIndex

Valor de índice que se va a usar para el primer cuadro o línea en el contexto.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Correcto.
E_POINTER
 El contexto no es válido o uno de los parámetros es un puntero no válido.
E_OUTOFMEMORY
 No se puede asignar memoria para completar la operación.
E_INVALIDARG
 Se intentó establecer un modo de reconocimiento (libre, alineado, boxed, etc.) que no es compatible con el reconocedor o los valores de campo de RECO_GUIDE no son válidos (por ejemplo, alturas o anchos negativos).
E_FAIL
 Se ha producido un error no especificado.
TPC_E_OUT_OF_ORDER_CALL
 Se intentó establecer la guía cuando ya había alguna entrada de lápiz en el contexto de recuperación o, en el caso de reconocedores de caracteres asiáticos orientales, se llamó a SetCACMode anteriormente.

Comentarios

Los cuadros de guía se numeran en función del valor de iIntex .

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

Consulte también

Función GetGuide

Estructura de RECO_GUIDE