Função SetEnabledUnicodeRanges (recapis.h)

Habilita um ou mais intervalos de pontos Unicode no contexto.

Sintaxe

HRESULT SetEnabledUnicodeRanges(
  HRECOCONTEXT    hrc,
  ULONG           cRanges,
  CHARACTER_RANGE *pcr
);

Parâmetros

hrc

O identificador para o contexto do reconhecedor.

cRanges

O número de intervalos no buffer pRanges .

pcr

Uma matriz de estruturas CHARACTER_RANGE . Cada estrutura identifica um intervalo de pontos Unicode que você deseja habilitar no reconhecedor. A ordem da matriz é arbitrária.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
TPC_S_TRUNCATED
O reconhecedor não dá suporte a um dos intervalos de pontos Unicode especificados.
E_FAIL
Ocorreu um erro não especificado.
E_INVALIDARG
Um argumento inválido foi recebido.
E_POINTER
Um dos parâmetros é um ponteiro inválido.

Comentários

A função SetEnabledUnicodeRanges é opcional.

Alguns reconhecedores não dão suporte à habilitação e desabilitação de pontos de código específicos, mas ainda podem incluir a função SetEnabledUnicodeRanges . Para esses reconhecedores, a função SetEnabledUnicodeRanges retorna E_NOTIMPL.

Cada reconhecedor dá suporte a um ou mais intervalos de pontos Unicode. Para determinar quais intervalos de pontos Unicode o reconhecedor dá suporte, chame a função GetUnicodeRanges . Se você não chamar essa função, o reconhecedor usará um conjunto padrão de intervalos de pontos Unicode. Os intervalos padrão são específicos do reconhecedor.

O reconhecedor de gestos da Microsoft usa 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

   
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

Estrutura CHARACTER_RANGE

Função GetEnabledUnicodeRanges

Função GetUnicodeRanges