GetMenuDefaultItem 函数 (winuser.h)

  • 项目

确定指定菜单上的默认菜单项。

语法

UINT GetMenuDefaultItem(
  [in] HMENU hMenu,
  [in] UINT  fByPos,
  [in] UINT  gmdiFlags
);

参数

[in] hMenu

类型： HMENU

要检索其默认菜单项的菜单的句柄。

[in] fByPos

类型： UINT

指示是检索菜单项的标识符还是其位置。 如果此参数为 FALSE，则返回标识符。 否则，返回位置。

[in] gmdiFlags

类型： UINT

指示函数应如何搜索菜单项。 此参数可以是以下值的零个或多个。

值 含义
GMDI_GOINTOPOPUPS
0x0002L
 如果默认项是打开子菜单的项，则函数将在相应的子菜单以递归方式搜索。 如果子菜单没有默认项，则由返回值来标识打开子菜单的项。 默认情况下，该函数返回指定菜单上的第一个默认项，不管该项是否是打开子菜单的项。
GMDI_USEDISABLED
0x0001L
 函数将返回默认项，即使它被禁用。 默认情况下，该函数会跳过禁用或灰显项。

返回值

类型： UINT

如果函数成功，返回值是菜单项的标识符或位置。

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

要求

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

请参阅

概念性

菜单

引用

SetMenuDefaultItem