Função GetEnabledUnicodeRanges (recapis.h)

Recupera uma lista de intervalos de pontos Unicode habilitados no contexto. Se você não chamar a função SetEnabledUnicodeRanges para especificar os intervalos habilitados, essa função retornará os intervalos de pontos Unicode padrão do reconhecedor.

Sintaxe

HRESULT GetEnabledUnicodeRanges(
  HRECOCONTEXT    hrc,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

Parâmetros

hrc

O identificador para o contexto do reconhecedor.

pcRanges

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

pcr

Uma matriz de estruturas de CHARACTER_RANGE. Cada estrutura contém um intervalo de pontos Unicode habilitados no contexto. A ordem da matriz é arbitrária. Para determinar o tamanho 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.
E_FAIL	Ocorreu um erro não especificado.
E_INVALIDARG	Um argumento inválido foi recebido.
TPC_E_INSUFFICIENT_BUFFER	O buffer do pcr é muito pequeno.
E_OUTOFMEMORY	Memória insuficiente.

Comentários

Essa função é opcional.

Alguns reconhecedores não dão suporte à habilitação e desabilitação de pontos Unicode específicos, mas ainda podem incluir a função GetEnabledUnicodeRanges . Para esses reconhecedores, a função GetEnabledUnicodeRanges retorna os mesmos intervalos que a função 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 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	recapis.h
DLL	inkobjcore.dll

Confira também

Estrutura CHARACTER_RANGE

Função GetUnicodeRanges

Função SetEnabledUnicodeRanges