GetMenuDefaultItem 函数 (winuser.h)

项目
03/04/2024

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

语法

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