ON_COMMAND_RANGE

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

更新 : 2007 年 11 月

このマクロを使って連続する範囲のコマンド 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);
}