システムメニュー

ウィンドウ制御用のメニュー

メニューはメニューバー、ショートカットメニューのほか、システムメニューがあります。
(現在はウィンドウメニューと呼ぶのが正式名称のようです)
システムメニューはタイトルバーの左端に表示されているアプリケーションアイコンをクリックしたときに表示されるメニューです。
これはWindowsが提供するもので、CreateWindow関数のウィンドウスタイルにWS_SYSMENUフラグを含めることで表示されるようになります。

何もプログラミングしていない状態でもウィンドウの移動や最大化などの操作が可能です。

メッセージ

システムメニューを開いたり項目を選択したとき、親ウィンドウにWM_SYSCOMMANDメッセージが送信されます。
(正確には、Windowsが提供するウィンドウ操作の機能を実行しようとしたとき。例えばウィンドウ右上の「閉じる」等のボタンやウィンドウの移動など)

WPARAMには以下の定数のいずれかが格納されています。
(コマンドID)

これらの動作はDefWindowProc関数が提供しています。
動作を変更したい場合はウィンドウプロシージャでWM_SYSCOMMANDメッセージを捕捉し、WPARAMの値によって処理を割り振ります。

ただし通常の比較(等価演算子==やswitch文など)では正しく一致しないことがあります。
WPARAMの値にGET_SC_WPARAMというマクロを通すことで、上記の定数と一致する値を得ることができます。

#define GET_SC_WPARAM(wParam) ((int)wParam & 0xFFF0)

//以下のように使用する
case  WM_SYSCOMMAND:
	switch (GET_SC_WPARAM(wParam))
	{
	case SC_CLOSE:
		//何か処理
	}
	return DefWindowProc(hWnd, message, wParam, lParam);

ウィンドウプロシージャでWM_SYSCOMMANDメッセージを捕捉する場合、処理の目的としていないIDが送られた来た時はDefWindowProc関数を実行してください。
そうしないとシステムメニューが正しく動作しなくなります。
DefWindowProc関数に渡すWPARAMは加工前のものをそのまま渡してください。

LPARAMは、コマンドIDがSC_MOUSEMENUの時にマウスの座標が格納されています。
座標の取得方法はマウス座標の項を参照してください。
また、コマンドIDがSC_KEYMENUの時に、システムメニュー内の項目を実行するのに使用したキーの文字コードが格納されています。
例えば「Alt + X」を実行した場合は「x」が格納されています。
これら以外のコマンドIDではLPARAMは使用されません。

項目の追加

システムメニューのハンドルはGetSystemMenu関数で取得することができます。

HMENU GetSystemMenu(
 HWND hWnd,
 BOOL bRevert
 );

ウィンドウhWndのシステムメニューハンドルを取得する。

第二引数のbRevertは、FALSEを指定するとシステムメニューのハンドルを返します。
TRUEを指定するとシステムメニューを初期状態にリセットします。
このときの戻り値はNULLです。

このハンドルを通して、システムメニューに項目を追加することができます。

項目の追加はメニューの動的生成で使用したInsertMenuItem関数で行います。
ただし既存の項目との重複を防ぐため、追加する項目の識別子の値は0xF000未満にする必要があります。
(0xF000 = 61440)
また、独自の項目を処理した場合はDefWindowProc関数は実行しないでください。

サンプルコード

システムメニューのメッセージ処理と項目の追加のサンプルです。

#include <windows.h>

//ウィンドウの生成等は省略

#define ID_RESETSYSMENU					0x0010

LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
	HMENU hMenu;
	MENUITEMINFO mii;

	switch (message)
	{
	case WM_CREATE:
		//システムメニューのハンドルを取得
		hMenu = GetSystemMenu(hWnd, FALSE);

		mii.cbSize = sizeof(MENUITEMINFO);
		mii.fMask = MIIM_FTYPE | MIIM_STRING | MIIM_ID;
		mii.fType = MFT_STRING;

		mii.dwTypeData = L"スタートメニューをアクティブにする";
		mii.wID = SC_TASKLIST;
		InsertMenuItem(hMenu, 0, TRUE, &mii);

		mii.dwTypeData = L"メニューを初期状態に戻す";
		mii.wID = ID_RESETSYSMENU;
		InsertMenuItem(hMenu, 1, TRUE, &mii);
		break;

	case  WM_SYSCOMMAND:
		switch (wParam)
		{
		case ID_RESETSYSMENU:
			//システムメニューを初期化
			GetSystemMenu(hWnd, TRUE);
			return 0;
		}
		//DefWindowProc関数を呼ぶ
		return DefWindowProc(hWnd, message, wParam, lParam);

	case WM_DESTROY: //ウィンドウの破棄
		PostQuitMessage(0);
		break;

	default:
		return DefWindowProc(hWnd, message, wParam, lParam);
	}
	return 0;
}

SC_TASKLISTはシステム定義済みの動作で、DefWindowProc関数によって処理されます。
実行するとWindowsのスタートメニューが開きます。
ID_RESETSYSMENUは独自に追加した動作で、システムメニューを初期状態に戻します。