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.

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

Consulte también

GetEnabledUnicodeRanges (Función)

Función SetEnabledUnicodeRanges