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