指定されたウィンドウに、新しいメニューを割り当てます。

BOOL SetMenu(
  HWND hWnd,  // ウィンドウのハンドル
  HMENU hMenu // メニューのハンドル
);

パラメータ

hWnd

メニューの割り当て先となる、1 つのウィンドウのハンドルを指定します。

hMenu

新しいメニューのハンドルを指定します。NULL を指定すると、指定されたウィンドウの現在のメニューが削除されます。

戻り値

関数が成功すると、0 以外の値が返ります。

関数が失敗すると、0 が返ります。拡張エラー情報を取得するには、 関数を使います。

解説

ウィンドウを再描画すると、メニューに加えた変更が反映されます。子ウィンドウを除き、任意のウィンドウへメニューを割り当てることができます。

既にメニューが割り当てられているウィンドウに対して SetMenu 関数を呼び出すと、この関数は既存のメニューを置き換えますが、破棄しません。以前のメニューを破棄するには、アプリケーションは DestroyMenu 関数を呼び出すべきです。

対応情報

Windows NT/2000：Windows NT 3.1 以降
Windows 95/98：Windows 95 以降
ヘッダー：Winuser.h 内で宣言、Windows.h をインクルード
インポートライブラリ：User32.lib を使用

参照

DestroyMenu, GetMenu