DeleteMenu 函式 (winuser.h)
從指定的功能表刪除專案。 如果功能表項目開啟功能表或子功能表,此函式會終結功能表或子功能表的控制碼,並釋放功能表或子功能表所使用的記憶體。
語法
BOOL DeleteMenu(
[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) |
另請參閱
概念
參考