CWnd::GetSystemMenu

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

アプリケーションのコピーおよび変更のコントロールメニューにアクセスできます。

CMenu* GetSystemMenu(
   BOOL bRevert 
) const;

パラメータ

bRevert
関数の動作を指定します。bRevert が FALSE のとき、GetSystemMenu は現在使用中のコントロールメニューのコピーへのハンドルを返します。このコピーは初めはコントロールメニューと同じですが、変更できます。bRevert が TRUE のとき、GetSystemMenu はコントロールメニューを元の状態に戻します。以前のコントロールメニュー (変更された可能性もあります) がある場合は破棄されます。このとき、戻り値は定義されません。

戻り値

bRevert が FALSE の場合は、コントロールメニューのコピーを識別するハンドルを返します。bRevert が TRUE の場合は、戻り値は定義されません。

返されるポインタは、一時的なポインタです。後で使用するために保存しておくことはできません。

解説

コントロールメニューのコピーに GetSystemMenu 関数を使用しないウィンドウは、標準コントロールメニューを受け取ります。

GetSystemMenu メンバ関数から返されるポインタは、コントロールメニューを変更するために、CMenu::AppendMenu、CMenu::InsertMenu、CMenu::ModifyMenu 関数で使うことができます。

初期状態におけるコントロールメニューには、SC_CLOSE、SC_MOVE、SC_SIZE のような ID 値で識別される項目が含まれています。コントロールメニューの項目は、WM_SYSCOMMAND メッセージを発生させます。組み込み済みのコントロールメニューの項目は、すべて 0xF000 よりも大きい ID 番号を持っています。アプリケーションでコントロールメニューに項目を追加するときは、必ず 0xF000 よりも小さい ID 番号を使ってください。

Windows では、標準コントロールメニューの項目を自動的に使用不可にできます。CWnd は、メニューが表示される前に送られてくる WM_INITMENU メッセージに応答することによって、必要に応じて項目を選択したり使用不可にしたりできます。

使用例

// The following code fragment is taken from CMyDlg::OnInitDialog
// CMyDlg is derived from CDialog

// Add "About..." menu item to system menu.

// IDM_ABOUTBOX must be in the system command range.
ASSERT((IDM_ABOUTBOX & 0xFFF0) == IDM_ABOUTBOX);
ASSERT(IDM_ABOUTBOX < 0xF000);

CMenu* pSysMenu = GetSystemMenu(FALSE);
if (pSysMenu != NULL)
{
   CString strAboutMenu;
   strAboutMenu.LoadString(IDS_ABOUT);
   if (!strAboutMenu.IsEmpty())
   {
      pSysMenu->AppendMenu(MF_SEPARATOR);
      pSysMenu->AppendMenu(MF_STRING, IDM_ABOUTBOX, strAboutMenu);
   }
}

// Set the icon for this dialog. The framework does this automatically
// when the application's main window is not a dialog
SetIcon(m_hIcon, TRUE);   // Set big icon
SetIcon(m_hIcon, FALSE);  // Set small icon