Compartilhar via

Função GetEnabledUnicodeRanges (recapis.h)

  • Artigo

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