iTfFnPlayBack::QueryRange 方法 (ctffunc.h)

获取包含音频数据的单词或短语的文本范围。

语法

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

参数

[in] pRange

指向 ITfRange 对象的指针,该对象涵盖包含音频数据的全部或部分文本。

[out] ppNewRange

指向 ITfRange 指针的指针,该指针接收涵盖包含音频数据的所有文本的范围对象。 如果 pRange 所涵盖的文本没有音频数据,此参数将接收 NULL。 在这种情况下, 方法返回 S_OK,因此调用方在使用指针之前必须验证此参数是否不为 NULL

[out] pfPlayable

指向 BOOL 的指针,如果 pRange 覆盖的文本中没有任何音频数据或非零值,则接收零。

返回值

此方法可以返回其中一个值。

Value 说明
S_OK
方法成功。
E_INVALIDARG
一个或多个参数无效。
E_OUTOFMEMORY
发生内存分配失败。

注解

此方法的当前实现非常简单。 它将克隆 pRange,将克隆置于 ppNewRange 中,将 pfPlayable 设置为 TRUE 并返回S_OK。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ctffunc.h
DLL Msctf.dll
可再发行组件 Windows 2000 专业版上的 TSF 1.0

另请参阅

ITfFnPlayBack

ITfRange