Compartilhar via


Método ITfFnReconversion::QueryRange (ctffunc.h)

O método ITfFnReconversion::QueryRange obtém o intervalo de texto ao qual a reconversão se aplica.

Sintaxe

HRESULT QueryRange(
  [in]  ITfRange *pRange,
        ITfRange **ppNewRange,
  [out] BOOL     *pfConvertable
);

Parâmetros

[in] pRange

Ponteiro para um objeto ITfRange que abrange todo ou parte do texto a ser reconvertido.

ppNewRange

[in, out] Ponteiro para um ponteiro ITfRange que recebe um objeto de intervalo que abrange todo o texto que pode ser reconvertido. Se nenhum dos textos cobertos por pRange puder ser reconvertido, esses parâmetros receberão NULL. Nesse caso, o método retornará S_OK, portanto, o chamador deve verificar se esse parâmetro não é NULL antes de usar o ponteiro.

Quando esse método é implementado por um serviço de texto, esse parâmetro é opcional e pode ser NULL. Nesse caso, o intervalo não é necessário.

Quando a implementação do gerenciador TSF desse método é chamada, esse parâmetro não é opcional e não pode ser NULL.

[out] pfConvertable

Ponteiro para um valor BOOL que recebe zero se nenhum texto coberto por pRange puder ser reconvertido ou diferente de zero.

Valor retornado

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
O método foi bem-sucedido.
E_INVALIDARG
Um ou mais parâmetros são inválidos.
E_OUTOFMEMORY
Ocorreu uma falha de alocação de memória.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho ctffunc.h
DLL Msctf.dll
Redistribuível TSF 1.0 no Windows 2000 Professional

Confira também

ITfFnReconversion

ITfRange