ITfFnReconversion::QueryRange 方法 (ctffunc.h)

ITfFnReconversion::QueryRange 方法获取重新转换适用的文本范围。

语法

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

参数

[in] pRange

指向 ITfRange 对象的指针,该对象涵盖要重新转换的全部或部分文本。

ppNewRange

[in, out]指向 ITfRange 指针的指针,该指针接收涵盖可重新转换的所有文本的范围对象。 如果 pRange 涵盖的任何文本都无法重新转换,则此参数接收 NULL。 在这种情况下,方法将返回S_OK,因此调用方在使用指针之前必须验证此参数是否不是 NULL。

当此方法由文本服务实现时,此参数是可选的,可以为 NULL。 在这种情况下,范围不是必需的。

调用此方法的 TSF 管理器实现时,此参数不是可选的,不能为 NULL。

[out] pfConvertable

指向 BOOL 值的指针,如果 pRange 所涵盖的任何文本都不能重新转换或非零,则接收零。

返回值

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

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

要求

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

另请参阅

ITfFnReconversion

ITfRange