Función SetTextContext (recapis.h)

Proporciona las cadenas de texto que vienen antes y después del texto contenido en el contexto del reconocedor.

Llame a esta función antes de procesar la entrada de lápiz por primera vez. Por lo tanto, llame a la función SetTextContext antes de llamar a la función Process .

Sintaxis

HRESULT SetTextContext(
  HRECOCONTEXT hrc,
  ULONG        cwcBefore,
  const WCHAR  *pwcBefore,
  ULONG        cwcAfter,
  const WCHAR  *pwcAfter
);

Parámetros

hrc

Identificador del contexto del reconocedor.

cwcBefore

Número de caracteres en pwcBefore.

pwcBefore

Cadena de texto que viene antes del texto contenido en el contexto del reconocedor. La cadena no está terminada en NULL .

cwcAfter

Número de caracteres en pwcAfter.

pwcAfter

Cadena de texto que viene después del texto contenido en el contexto del reconocedor. La cadena no está terminada en NULL .

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_NOTIMPL
El reconocedor no admite esta función.
E_OUTOFMEMORY
No se puede asignar memoria para completar la operación.
E_FAIL
Se ha producido un error no especificado.
E_INVALIDARG
Se especificó un argumento no válido.

Comentarios

La función SetTextContext proporciona contexto para una frase o una palabra, lo que aumenta la precisión del reconocedor. Por ejemplo, si la cadena pwcBefore pwcBefore es "debajo de " y la cadena pwcAfter es "en la casa", puede inclinar al reconocedor mediante una palabra o palabras entre las cadenas. El reconocedor debe tener en cuenta el espacio después de "the" y antes de "in" al realizar el reconocimiento.

Sin embargo, si la cadena pwcAfter es "Hel" y la cadena pwcBefore es "o", la falta de espacio entre las cadenas indica que el reconocedor debe reconocer una o varias letras dentro de una palabra que comienza con "Hel" y termina con "o".

Se recomienda limitar la longitud del contexto de texto a más de 1024 caracteres cada uno para los contextos izquierdo y derecho.

Requisitos

   
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