Compartilhar via


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

Obtém o intervalo de texto ao qual uma reconversão se aplica.

Sintaxe

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

Parâmetros

[in] pRange

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

[out] ppNewRange

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; o chamador deve verificar se esse parâmetro não é NULL antes de usar o ponteiro.

Esse parâmetro é opcional e pode ser NULL. Nesse caso, o intervalo não é necessário.

[out] pfAccepted

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

Retornar valor

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.

Comentários

Esse método é idêntico a ITfFnReconversion::QueryRange. Quando ITfFnReconversion::QueryRange é chamado no serviço de texto, o serviço de texto deve encaminhar a chamada para esse método se um processador de modelo de linguagem estiver instalado. Se nenhum processador de modelo de linguagem estiver instalado, o serviço de texto deverá executar seu processamento padrão.

Requisitos

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

Confira também

ITfFnLMProcessor

ITfFnReconversion::QueryRange

ITfRange