getMenuBarInfo 函数 (winuser.h)

检索有关指定的菜单栏的信息。

语法

BOOL GetMenuBarInfo(
  [in]      HWND         hwnd,
  [in]      LONG         idObject,
  [in]      LONG         idItem,
  [in, out] PMENUBARINFO pmbi
);

参数

[in] hwnd

类型：HWND

要检索其信息的窗口 (菜单栏) 句柄。

[in] idObject

类型： LONG

菜单对象。 此参数的取值可为下列值之一：

值	含义
OBJID_CLIENT ( (LONG) 0xFFFFFFFC)	与窗口关联的弹出菜单。
OBJID_MENU ( (长) 0xFFFFFFFD)	与窗口关联的菜单栏 (看到 GetMenu 函数) 。
OBJID_SYSMENU ( (LONG) 0xFFFFFFFF)	与窗口关联的系统菜单 (看到 GetSystemMenu 函数) 。

[in] idItem

类型： LONG

要检索其信息的项。 如果此参数为零，则函数将检索有关菜单本身的信息。 如果此参数为 1，则函数将检索有关菜单中第一项的信息，依此类推。

[in, out] pmbi

类型： PMENUBARINFO

指向接收信息的 MENUBARINFO 结构的指针。 请注意，在调用此函数之前，必须将 cbSize 成员设置为 sizeof(MENUBARINFO) 。

返回值

类型： BOOL

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

如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。

要求

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

请参阅

概念性

获取菜单

GetSystemMenu

MENUBARINFO

菜单

引用