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

菜单

引用