RemoveMenu 函式 (winuser.h)

刪除功能表項,或從指定的功能表中斷連結子功能表。 如果功能表項開啟下拉功能表或子功能表, RemoveMenu 不會終結功能表或其句柄,允許重複使用功能表。 呼叫此函式之前, GetSubMenu 函式應該會擷取下拉功能表或子功能表的句柄。

語法

BOOL RemoveMenu(
  [in] HMENU hMenu,
  [in] UINT  uPosition,
  [in] UINT  uFlags
);

參數

[in] hMenu

類型: HMENU

要變更之功能表的句柄。

[in] uPosition

類型: UINT

要刪除的功能表項,由 uFlags 參數決定。

[in] uFlags

類型: UINT

指出 uPosition 參數的解譯方式。 此參數必須是下列其中一個值。

意義
MF_BYCOMMAND
0x00000000L
表示 uPosition 會提供功能表項的識別碼。 如果未指定 MF_BYCOMMANDMF_BYPOSITION 旗標, 則MF_BYCOMMAND 旗標是預設旗標。
MF_BYPOSITION
0x00000400L
表示 uPosition 會提供功能表項以零起始的相對位置。

傳回值

類型: BOOL

如果函式成功,則傳回非零的值。

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

每當功能表變更時,應用程式都必須呼叫 DrawMenuBar 函式,無論功能表是否在顯示的視窗中。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winuser.h (包括 Windows.h)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-menu-l1-1-0 (於 Windows 8)

另請參閱

概念

CreatePopupMenu

DeleteMenu

DrawMenuBar

GetSubMenu

功能表

參考