Función GetEnabledUnicodeRanges (recapis.h)

Recupera una lista de intervalos de puntos Unicode habilitados en el contexto. Si no llama a la función SetEnabledUnicodeRanges para especificar los intervalos habilitados, esta función devuelve los intervalos de puntos Unicode predeterminados del reconocedor.

Sintaxis

HRESULT GetEnabledUnicodeRanges(
  HRECOCONTEXT    hrc,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

Parámetros

hrc

Identificador del contexto del reconocedor.

pcRanges

En la entrada, el número de estructuras de CHARACTER_RANGE que puede contener el búfer de pcr . En la salida, el número de intervalos que contiene el búfer de pcr .

pcr

Matriz de estructuras de CHARACTER_RANGE. Cada estructura contiene un intervalo de puntos Unicode habilitados en el contexto. El orden de la matriz es arbitrario. Para determinar el tamaño del búfer, establezca pcr en NULL; use el número de intervalos para asignar el búfer de pcr .

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
Correcto.
E_POINTER
Uno de los parámetros es un puntero no válido.
E_FAIL
Se ha producido un error no especificado.
E_INVALIDARG
Se recibió un argumento no válido.
TPC_E_INSUFFICIENT_BUFFER
El búfer de pcr es demasiado pequeño.
E_OUTOFMEMORY
Memoria insuficiente.

Comentarios

Esta función es opcional.

Algunos reconocedores no admiten la habilitación y deshabilitación de puntos Unicode específicos, pero pueden incluir la función GetEnabledUnicodeRanges . Para estos reconocedores, la función GetEnabledUnicodeRanges devuelve los mismos intervalos que la función GetUnicodeRanges .

Los reconocedores de gestos de Microsoft usan caracteres Unicode de 0xF000 para 0xF0FF. Cada único valor Unicode de este intervalo representa un solo gesto. Para obtener una lista completa de valores Unicode para gestos, vea Valores de intervalo Unicode de gestos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado recapis.h
Archivo DLL inkobjcore.dll

Consulte también

Estructura de CHARACTER_RANGE

GetUnicodeRanges (función)

Función SetEnabledUnicodeRanges