Función GetUnicodeRanges (recapis.h)

Devuelve los intervalos de puntos Unicode que admite el reconocedor.

Sintaxis

HRESULT GetUnicodeRanges(
  HRECOGNIZER     hrec,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

Parámetros

hrec

Identificador del reconocedor.

pcRanges

En la entrada, el número de intervalos 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 que admite el reconocedor. El orden de la matriz es arbitrario. Para determinar el tamaño necesario 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.
TPC_E_INSUFFICIENT_BUFFER	El búfer de pcr es demasiado pequeño.
E_FAIL	Se ha producido un error no especificado.
E_INVALIDARG	Se recibió un argumento no válido.
E_OUTOFMEMORY	Memoria insuficiente.

Comentarios

Esta función es opcional.

Algunos reconocedores no admiten esta funcionalidad, pero pueden incluir la función GetUnicodeRanges Function . Para estos reconocedores, la función GetUnicodeRanges devuelve E_NOTIMPL.

Para controlar los intervalos Unicode utilizados por un contexto de reconocedor específico, use las funciones GetEnabledUnicodeRanges y SetEnabledUnicodeRanges . Estos intervalos están restringidos para ser un subconjunto de los intervalos devueltos por GetUnicodeRanges.

Los reconocedores de gestos de Microsoft usan caracteres Unicode de 0xF000 para 0xF0FF. Cada valor Unicode único 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 [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

GetEnabledUnicodeRanges (Función)

Función SetEnabledUnicodeRanges