Função GetUnicodeRanges (recapis.h)

Retorna os intervalos de pontos Unicode aos quais o reconhecedor dá suporte.

Sintaxe

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

Parâmetros

hrec

Manipule para o reconhecedor.

pcRanges

Na entrada, o número de intervalos que o buffer pcr pode conter. Na saída, o número de intervalos que o buffer pcr contém.

pcr

Matriz de estruturas CHARACTER_RANGE . Cada estrutura contém um intervalo de pontos Unicode compatíveis com o reconhecedor. A ordem da matriz é arbitrária. Para determinar o tamanho necessário do buffer, defina o pcr como NULL; use o número de intervalos para alocar o buffer do pcr .

Valor de retorno

Essa função pode retornar um desses valores.

Observações

Essa função é opcional.

Alguns reconhecedores não dão suporte a essa funcionalidade, mas ainda podem incluir a função GetUnicodeRanges Function . Para esses reconhecedores, a função GetUnicodeRanges retorna E_NOTIMPL.

Para controlar os intervalos Unicode usados por um contexto de reconhecedor específico, use as funções GetEnabledUnicodeRanges e SetEnabledUnicodeRanges . Esses intervalos são restritos a ser um subconjunto dos intervalos retornados por GetUnicodeRanges.

Os reconhecedores de gestos da Microsoft usam caracteres Unicode de 0xF000 para 0xF0FF. Cada valor Unicode único nesse intervalo representa um único gesto. Para obter uma lista completa de valores Unicode para gestos, consulte Valores de Intervalo Unicode de Gestos.

Requirements

Consulte também

Função GetEnabledUnicodeRanges

Função SetEnabledUnicodeRanges