imm.h) (ImmGetConversionListA 函数

  • 项目

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

语法

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

parameters

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 [仅限桌面应用]
目标平台 Windows
标头 imm.h (包括 Immdev.h、Windows.h)
Library Imm32.lib
DLL Imm32.dll

另请参阅

候选列表

输入法管理器

输入法管理器函数