IMEMENUITEMINFOA 结构 (imm.h)

包含有关 IME 菜单项的信息。

语法

typedef struct tagIMEMENUITEMINFOA {
  UINT    cbSize;
  UINT    fType;
  UINT    fState;
  UINT    wID;
  HBITMAP hbmpChecked;
  HBITMAP hbmpUnchecked;
  DWORD   dwItemData;
  CHAR    szString[IMEMENUITEM_STRING_SIZE];
  HBITMAP hbmpItem;
} IMEMENUITEMINFOA, *PIMEMENUITEMINFOA, *NPIMEMENUITEMINFOA, *LPIMEMENUITEMINFOA;

成员

cbSize

结构的大小(以字节为单位)。

fType

菜单项类型。 此成员可以具有以下值之一。

价值 意义
IMFT_RADIOCCHECK 如果 hbmpChecked 成员 NULL,则使用单选按钮标记而不是复选标记显示选中的菜单项。
IMFT_SEPARATOR 菜单项是分隔符。 菜单项分隔符显示为水平分隔线。 在这种情况下,将忽略 hbmpItemszString 成员。
IMFT_SUBMENU 菜单项是子菜单。

fState

菜单项状态。 此成员可以具有以下一个或多个值:

价值 意义
IMFS_CHECKED 选中菜单项。 有关详细信息,请参阅 hbmpChecked 成员的说明。
IMFS_DEFAULT 菜单项为默认值。 菜单只能包含一个默认菜单项,以粗体显示。
IMFS_DISABLED 菜单项处于禁用状态,并显示为灰色,因此无法选择它。 这相当于IMFS_GRAYED。
IMFS_ENABLED 已启用菜单项。 这是默认状态。
IMFS_GRAYED 菜单项处于禁用状态,并显示为灰色,因此无法选择它。 这相当于IMFS_DISABLED。
IMFS_HILITE 菜单项突出显示。
IMFS_UNCHECKED 未选中菜单项。 有关未选中的菜单项的详细信息,请参阅 hbmpUnchecked 成员的说明。
IMFS_UNHILITE 菜单项未突出显示。 这是默认状态。

wID

标识菜单项的应用程序定义的 16 位值。

hbmpChecked

选中该项时要显示的位图的句柄。 如果此成员 NULL,则使用默认位图。 如果指定了IMFT_RADIOCHECK类型值,则默认位图是项目符号。 否则,它是一个复选标记。

hbmpUnchecked

如果未选中位图,则为位图的句柄。 如果此成员 NULL,则不使用位图。

dwItemData

与菜单项关联的应用程序定义值。

szString[IMEMENUITEM_STRING_SIZE]

菜单项的内容。 这是以 null 结尾的字符串。

hbmpItem

要显示的位图的句柄。

言论

注意

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

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
标头 imm.h(包括 Immdev.h、Windows.h)

另请参阅

ImmGetImeMenuItems

输入法管理器

输入法管理器结构