iTfReverseConversionMgr::GetReverseConversion 方法 (msctf.h)

[GetReverseConversion 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 仅供内部使用。]

检索可以执行反向转换的 ITfReverseConversion 对象。

语法

HRESULT GetReverseConversion(
  [in]  LANGID               langid,
  [in]  REFGUID              guidProfile,
  [in]  DWORD                dwflag,
  [out] ITfReverseConversion **ppReverseConversion
);

参数

[in] langid

目标字符串所属的配置文件的语言 ID。

[in] guidProfile

目标字符串所属的配置文件的 GUID。

[in] dwflag

含义
TF_RCM_COMLESS
0x00000001
在没有 COM 的情况下激活反向转换接口。
TF_RCM_VKEY
0x00000002
输出应是 (的虚拟键代码数组,而不是) 字符键代码。
TF_RCM_HINT_READING_LENGTH
0x00000004
反向转换应根据输入序列的长度确定输出列表中的条目顺序的优先级,将最短序列排在最前面。 冲突计数较低的输入序列可能远高于具有相似 (但) 冲突计数略高一些的输入序列。 此标志的解释因输入法而异。
TF_RCM_HINT_COLLISION
0x00000008
反向转换应根据冲突计数确定输出列表中的条目顺序的优先级,其中条目包含的冲突次数最少。 如果输入序列对应于的字符多于稍长一点的输入序列,则最好改用较长的输入序列。 输入法确定此标志是否会影响反向转换输出。

[out] ppReverseConversion

指向可以执行指定反向转换的 ITfReverseConversion 对象的地址的指针。

返回值

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

返回值 说明
S_OK
指定的 langidguidProfile 组合的 ITfReverseConversion 可用。
E_NOTIMPL
指定的 langidguidProfile 组合不支持反向转换。
E_FAIL
发生了未指定的错误。

注解

反向转换提供创建指定字符串所需的击键序列。

如果未为 dwflag 指定TF_RCM_HINT_COLLISIONTF_RCM_HINT_READING_LENGTH标志,则输入法可能不会按任何顺序排列输出。

要求

要求
最低受支持的客户端 Windows Vista SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 SP1 [仅限桌面应用]
目标平台 Windows
标头 msctf.h
DLL Msctf.dll

另请参阅

ITfReverseConversionMgr