ON_COMMAND_RANGE

2011-08-09

このマクロを使って連続する範囲のコマンド ID を 1 つのメッセージハンドラー関数に割り当てます。

ON_COMMAND_RANGE(id1, id2, memberFxn )

パラメーター

id1
連続するコマンド ID の先頭のコマンド ID。
id2
連続するコマンド ID の末尾のコマンド ID。
memberFxn
コマンドが割り当てられるメッセージハンドラー関数名。

解説

ID の範囲は id1 から id2 までです。

ある範囲のコマンド ID を 1 つのメンバー関数に割り当てるには ON_COMMAND_RANGE を使用します。 1 つのコマンドを 1 つのメンバー関数に割り当てるには ON_COMMAND を使用します。メッセージマップのエントリに一致するコマンド ID は 1 つだけです。つまり、コマンドを複数のハンドラーに割り当てることはできません。メッセージマップ範囲の詳細については、「範囲内のメッセージのハンドラー」を参照してください。

メッセージマップの範囲の自動サポートはないので、ユーザー自身がこのマクロを記述する必要があります。

使用例

// The code fragment below shows how to use ON_COMMAND_RANGE macro
// to map a contiguous range of command IDs to a single message 
// handler function (i.e. OnRangeCmds() in the sample below). In 
// addition, it also shows how to use CheckMenuRadioItem() to check a 
// selected menu item and makes it a radio item.
BEGIN_MESSAGE_MAP(CChildFrame, CMDIChildWnd)
   ON_COMMAND_RANGE(ID_COMMAND_RANGECMD1, ID_COMMAND_RANGECMD3, &CChildFrame::OnRangeCmds)
END_MESSAGE_MAP()

void CChildFrame::OnRangeCmds(UINT nID)
{
   CMenu* mmenu = AfxGetMainWnd()->GetMenu();
   CMenu* submenu = mmenu->GetSubMenu(5);
   submenu->CheckMenuRadioItem(ID_COMMAND_RANGECMD1, ID_COMMAND_RANGECMD3, 
      nID, MF_BYCOMMAND);
}