Compartir a través de


Función SetGuide (recapis.h)

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

Syntax

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

Parámetros

hrc

Controle el 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 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 de retorno Description
S_OK
Éxito.
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, boxizado, etc.) que no es compatible con el reconocedor o los valores de campo de RECO_GUIDE no son válidos (alturas o anchos negativos, por ejemplo).
E_FAIL
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 reco, o bien, en el caso de reconocedores de caracteres del Este asiático, se llamó a SetCACMode anteriormente.

Observaciones

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

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows XP Tablet PC Edition [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo admitido No se admite ninguno
de la plataforma de destino de Windows
Header recapis.h
Library inkobjcore.lib
DLL de inkobjcore.dll

Consulte también

Función GetGuide

estructura de RECO_GUIDE