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

另請參閱

概念

功能表

參考

SetMenuDefaultItem