GetMenuItemInfoW 函数 (winuser.h)

  • 项目

检索有关菜单项的信息。

语法

BOOL GetMenuItemInfoW(
  [in]      HMENU           hmenu,
  [in]      UINT            item,
  [in]      BOOL            fByPosition,
  [in, out] LPMENUITEMINFOW lpmii
);

参数

[in] hmenu

类型： HMENU

包含菜单项的菜单的句柄。

[in] item

类型： UINT

要获取相关信息的菜单项的标识符或位置。 此参数的含义取决于 fByPosition 的值。

[in] fByPosition

类型： BOOL

uItem 的含义。 如果此参数为 FALSE， 则 uItem 是菜单项标识符。 否则，它是菜单项位置。 有关详细信息 ，请参阅以编程方式访问菜单项 。

[in, out] lpmii

类型： LPMENUITEMINFO

指向 MENUITEMINFO 结构的指针，该结构指定要检索和接收有关菜单项的信息。 请注意，在调用此函数之前，必须将 cbSize 成员设置为 sizeof(MENUITEMINFO) 。

返回值

类型： BOOL

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。 若要获取扩展错误信息，请使用 GetLastError 函数。

注解

若要检索MFT_STRING类型的菜单项，请先通过将 MENUITEMINFO 的 dwTypeData 成员设置为 NULL，然后调用 GetMenuItemInfo 来查找字符串的大小。 cch+1 的值是所需的大小。 然后分配此大小的缓冲区，将指针置于 dwTypeData 中，将 cch 递增 1，然后再次调用 GetMenuItemInfo 以用字符串填充缓冲区。

如果检索到的菜单项属于其他类型，则 GetMenuItemInfo 会将 dwTypeData 成员设置为其类型由 fType fType 成员指定的值，并将 cch 设置为 0。

示例

有关示例，请参阅 Owner-Drawn 菜单项的示例。

注意

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

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 Windows 10版本 10.0.14 (393 中引入的 ext-ms-win-ntuser-menu-l1-1-3)

请参阅

概念性

菜单

引用

SetMenuItemInfo