ON_COMMAND_RANGE

Artikel
02/26/2013

Verwenden Sie dieses Makro, um einen zusammenhängenden Bereich von Befehls-IDs für eine einzelne Meldung handlerfunktion zuzuordnen.

ON_COMMAND_RANGE(id1, id2, memberFxn )

Parameter

id1
Befehls-ID am Anfang eines zusammenhängenden Bereich von Befehls-IDs.
id2
Befehls-ID am Ende eines zusammenhängenden Bereich von Befehls-IDs.
memberFxn
Der Name der Meldung Handler Funktion, mit der die Befehle zugeordnet sind.

Hinweise

Der Bereich von IDs und id1 mit Start endet mit id2.

Verwenden Sie ON_COMMAND_RANGE, um einen Bereich von Befehls-IDs für die einköpfigen Funktion zugeordnet werden soll.Verwenden Sie ON_COMMAND, um einen einzelnen Befehl zu einer Memberfunktion zu verknüpfen.Nur ein Meldungszuordnungseintrag kann eine angegebene Befehls-ID übereinstimmenDas heißt, Sie können einen Befehl nicht mehr als einem Handler.Weitere Informationen über Bereiche finden Sie meldungs Zuordnungen Handler für Meldungszuordnungs-Bereiche.

Es gibt keine automatische Unterstützung für Meldungszuordnungs Bereiche. Daher müssen Sie das Makro einfügen.

Beispiel

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