ImmGetImeMenuItemsA 函数 (imm.h)

检索在指定输入上下文的 IME 菜单中注册的菜单项。

语法

DWORD ImmGetImeMenuItemsA(
  [in]            HIMC               unnamedParam1,
  [in]            DWORD              unnamedParam2,
  [in]            DWORD              unnamedParam3,
  [out, optional] LPIMEMENUITEMINFOA lpImeParentMenu,
  [out, optional] LPIMEMENUITEMINFOA lpImeMenu,
  [in]            DWORD              dwSize
);

parameters

[in] unnamedParam1

指定菜单项的输入上下文的句柄。

[in] unnamedParam2

指定菜单信息选项的标志。 定义了以下值。

含义
IGIMIF_RIGHTMENU
检索通过右键单击获取的上下文菜单的菜单项。

[in] unnamedParam3

要检索的菜单的类型。 此参数可以具有以下一个或多个值。

含义
IGIMII_CMODE
检索控制转换模式的菜单项。
IGIMII_SMODE
检索控制句子模式的菜单项。
IGIMII_CONFIGURE
检索与 IME 配置相关的菜单项。
IGIMII_TOOLS
检索与 IME 工具相关的菜单项。
IGIMII_HELP
检索控制 IME 帮助的菜单项。
IGIMII_OTHER
检索控制其他 IME 函数的菜单项。
IGIMII_INPUTTOOLS
检索控制与 IME 输入工具相关的菜单项的菜单项,以便扩展输入字符。

[out, optional] lpImeParentMenu

指向 IMEMENUITEMINFO 结构的指针,函数在其中检索父菜单信息。 若要检索有关此父菜单的子菜单项的信息,应用程序将 fType 成员设置为 MFT_SUBMENU。 如果函数仅检索顶级菜单项,则此参数包含 NULL

[out, optional] lpImeMenu

指向 IMEMENUITEMINFO 结构的数组的指针,函数在其中检索有关菜单项的信息。 如果函数检索已注册的菜单项数,则此参数包含 NULL

[in] dwSize

要接收 IMEMENUITEMINFO 结构的缓冲区的大小。

返回值

返回复制到 lpImeMenu 中的菜单项数。 如果 lpImeMenu 指定 NULL,则该函数返回指定输入上下文中已注册的菜单项数。

注解

注意

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

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用],已安装东亚语言支持。
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 imm.h (包括 Immdev.h、Windows.h)
Library Imm32.lib
DLL Imm32.dll

另请参阅

IMEMENUITEMINFO

输入法管理器

输入法管理器函数