Función SetGuide (recapis.h)

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