SetMenu 函式 (winuser.h)

  • 發行項

將新功能表指派給指定的視窗。

語法

BOOL SetMenu(
  [in]           HWND  hWnd,
  [in, optional] HMENU hMenu
);

參數

[in] hWnd

類型： HWND

要指派功能表之視窗的句柄。

[in, optional] hMenu

類型： HMENU

新功能表的句柄。 如果此參數為 NULL，則會移除視窗的目前功能表。

傳回值

類型： BOOL

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

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

備註

視窗會重新繪製以反映功能表變更。 功能表可以指派給任何不是子視窗的視窗。

SetMenu 函式會取代上一個功能表，如果有的話，但不會終結它。 應用程式應該呼叫 DestroyMenu 函式來完成這項工作。

規格需求

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

另請參閱

概念

DestroyMenu

GetMenu

功能表

參考