通过

ImmGetConversionListA 函数 （imm.h）

  • 项目

检索字符或单词的转换结果列表，而不生成任何与 IME 相关的消息。

语法

DWORD ImmGetConversionListA(
        HKL             unnamedParam1,
        HIMC            unnamedParam2,
  [in]  LPCSTR          lpSrc,
  [out] LPCANDIDATELIST lpDst,
  [in]  DWORD           dwBufLen,
  [in]  UINT            uFlag
);

参数

unnamedParam1

unnamedParam2

[in] lpSrc

指向指定列表源的以 null 结尾的字符串的指针。

[out] lpDst

指向函数在其中检索列表 结构的 CANDIDATELIST 的指针。

[in] dwBufLen

输出缓冲区的大小（以字节为单位）。 如果函数返回完整转换结果列表所需的缓冲区大小，则应用程序将此参数设置为 0。

[in] uFlag

操作标志。 此参数可以具有以下值之一。

价值 意义
GCL_CONVERSION
 源字符串是读取字符串。 该函数将结果字符串复制到目标缓冲区。
GCL_REVERSECONVERSION
 源字符串是结果字符串。 该函数将读取字符串复制到目标缓冲区。
GCL_REVERSE_LENGTH
 源字符串是结果字符串。 该函数返回指定GCL_REVERSECONVERSION时创建的读取字符串的大小（以字节为单位）。

返回值

返回复制到输出缓冲区的字节数。 如果应用程序将 dwBufLen 参数设置为 0，则函数将返回所需输出缓冲区的大小（以字节为单位）。

言论

注意

imm.h 标头将 ImmGetConversionList 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]，已安装东亚语言支持。
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 imm.h（包括 Immdev.h、Windows.h）
库 Imm32.lib
DLL Imm32.dll

另请参阅

CANDIDATELIST

输入法管理器

输入法管理器函数