Compartilhar via

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

  • Artigo

Obtém o intervalo de texto para uma palavra ou frase que contém dados de áudio.

Sintaxe

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

Parâmetros

[in] pRange

Ponteiro para um objeto ITfRange que abrange todo ou parte do texto que contém dados de áudio.

[out] ppNewRange

Ponteiro para um ponteiro ITfRange que recebe um objeto de intervalo que abrange todo o texto que contém dados de áudio. Se não houver dados de áudio para o texto coberto por pRange, esses parâmetros receberão NULL. Nesse caso, o método retorna S_OK, portanto, o chamador deve verificar se esse parâmetro não é NULL antes de usar o ponteiro.

[out] pfPlayable

Ponteiro para um BOOL que recebe zero se nenhum dos textos cobertos pelo pRange tiver dados de áudio 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.

Comentários

A implementação atual desse método é simples. Ele clona pRange, coloca o clone em ppNewRange, define pfPlayable como TRUE e retorna S_OK.

Requisitos

   
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

ITfFnPlayBack

ITfRange