Compartir a través de

Función GetUnicodeRanges (recapis.h)

  • Artículo

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