Función SetFlags (recapis.h)

Especifica cómo interpreta el reconocedor la entrada de lápiz y determina la cadena de resultado.

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

Sintaxis

HRESULT SetFlags(
  [in] HRECOCONTEXT hrc,
  [in] DWORD        dwFlags
);

Parámetros

[in] hrc

Identificador del contexto del reconocedor.

[in] dwFlags

En la tabla siguiente se enumeran las marcas que puede establecer para especificar cómo interpreta el reconocedor la entrada de lápiz y determina la cadena de resultado. Use el operador OR (|) para combinar marcas según corresponda.

Marca de bit	Significado
RECOFLAG_AUTOSPACE	Recognizer usa espaciado inteligente en función de las reglas del modelo de lenguaje.
RECOFLAG_COERCE	Recognizer coerce el resultado en función del factoid que especifique para el contexto. Por ejemplo, si especifica un factoid de número de teléfono y el usuario escribe la palabra "hello", el reconocedor puede devolver un número de teléfono aleatorio o una cadena vacía. Si no especifica esta marca, el reconocedor devuelve "hello" como resultado.
RECOFLAG_PREFIXOK	Recognizer admite el reconocimiento de cualquier parte de prefijo de las cadenas definidas en el modelo de lenguaje predeterminado o especificado (factoid). Por ejemplo, sin esta marca, el usuario escribe "handw" y el reconocedor devuelve sugerencias (como "hander" o "hander") que son palabras que existen en el léxico del reconocedor. Con la marca , el reconocedor puede devolver "handw" como una de las sugerencias, ya que es un prefijo válido de la palabra "escritura a mano" que existe en el léxico del reconocedor. En la mayoría de los casos, el Panel de entrada del PC tablet establece esta marca, excepto cuando el ámbito de entrada es IS_DEFAULT (o ningún ámbito de entrada) o cuando no hay ninguna lista de palabras de usuario o expresión regular. Los reconocedores de caracteres asiáticos orientales deben devolver E_INVALIDARG cuando un llamador pasa esta marca.
RECOFLAG_LINEMODE	El reconocedor no divide las líneas, pero todavía debe realizar la separación de caracteres y palabras. Esto es lo mismo que el modo alineado, excepto que no hay ninguna guía, y se supone que toda la entrada de lápiz está en una sola línea. Cuando se establece esta marca, se omite una guía, si se establece.
RECOFLAG_SINGLESEG	Deshabilita varias segmentaciones. De forma predeterminada, el reconocedor devuelve varias segmentaciones (alternativas) para la entrada de lápiz. Por ejemplo, si escribe "juntos" como trazos independientes, el reconocedor puede segmentar la entrada de lápiz como "para obtenerla", "para reunir" o "juntos". Establezca esta marca si no necesita varias segmentaciones de la entrada de lápiz al consultar alternativas. Esto mejora el rendimiento y reduce el uso de memoria.
RECOFLAG_WORDMODE	Recognizer trata la entrada de lápiz como una sola palabra. Por ejemplo, si el contexto contiene "para obtenerla", el reconocedor devuelve "juntos".

Valor devuelto

Esta función puede devolver uno de estos valores.

Valor HRESULT	Descripción
S_OK	Correcto.
E_INVALIDARG	La marca no es válida.
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_POINTER	El contexto no es válido o uno de los parámetros es un puntero no válido.

Comentarios

Antes de Microsoft Windows XP Tablet PC Development Kit 1.7, tablet PC Input Panel realizó espaciado inteligente. A partir de Tablet PC SDK 1.7, el Panel de entrada sigue generando resultados con recomendaciones preliminares de espaciado. Sin embargo, los resultados de espaciado del Panel de entrada del pc tableta pueden cambiarse por las recomendaciones (resultados) del reconocedor. El reconocedor puede hacerlo mediante el uso de información contextual de texto (basada en la llamada SetTextContext realizada por el Panel de entrada) y sus reglas de modelo de lenguaje interno.

El Panel de entrada puede determinar si el reconocedor es capaz de realizar el espaciado automático mediante una llamada a esta función con la marca RECOFLAG_AUTOSPACE establecida. Si el reconocedor no admite el espaciado automático, se devuelve E_INVALIDARG.

Nota Solo se admite el modo de línea en la función SetFlags . No se admite el modo boxed, el modo libre ni el modo de una sola línea.

 

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 SetFactoid

SetTextContext (función)