Compartilhar via


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 de CHARACTER_RANGE . Cada estrutura contém um intervalo de pontos Unicode aos quais o reconhecedor dá suporte. A ordem da matriz é arbitrária. Para determinar o tamanho necessário do buffer, defina pcr como NULL; use o número de intervalos para alocar o buffer pcr .

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
E_POINTER
Um dos parâmetros é um ponteiro inválido.
TPC_E_INSUFFICIENT_BUFFER
O buffer do pcr é muito pequeno.
E_FAIL
Ocorreu um erro não especificado.
E_INVALIDARG
Um argumento inválido foi recebido.
E_OUTOFMEMORY
Memória insuficiente.

Comentários

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 para serem 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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP Tablet PC Edition [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho recapis.h
DLL inkobjcore.dll

Confira também

Função GetEnabledUnicodeRanges

Função SetEnabledUnicodeRanges