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