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 參數的解譯方式。 此參數必須是下列其中一個值。
值 | 意義 |
---|---|
|
表示 uPosition 會提供功能表項的識別碼。 如果未指定 MF_BYCOMMAND 或 MF_BYPOSITION 旗標, 則MF_BYCOMMAND 旗標是預設旗標。 |
|
表示 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) |
另請參閱
概念
參考