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 參數的解譯方式。 此參數必須是下列其中一個值。

值 意義
MF_BYCOMMAND
0x00000000L
 表示 uPosition 會提供功能表項目的識別碼。 如果未指定MF_BYCOMMAND或MF_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)

另請參閱

概念

DrawMenuBar

功能表

參考

RemoveMenu