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)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-menu-l1-1-0 (Windows 8)

另請參閱

概念

參考

SetMenuDefaultItem