ON_COMMAND_RANGE

發行項
02/28/2013

若要將命令 Id 的連續範圍對應到單一訊息處理函式中使用此巨集。

ON_COMMAND_RANGE(id1, id2, memberFxn )

參數

id1
命令 Id 的連續範圍的開頭的命令 ID。
id2
結尾的連續範圍的命令 Id 的命令 ID。
memberFxn
命令所對應的訊息處理常式函式的名稱。

備註

之 Id 範圍開頭 id1 ，並結束id2。

使用ON_COMMAND_RANGE ，將一系列的命令 Id 對應至一個成員函式。使用 ON_COMMAND ，將單一命令對應至成員函式。只有一個訊息對應項目可以比對指定的命令 id。也就是指令無法對應至一個以上的處理常式。如需有關對應訊息範圍的詳細資訊，請參閱的訊息對應範圍處理常式。

沒有任何自動式支援的訊息對應範圍，因此您必須自行將巨集。

範例

// 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);
}