ON_COMMAND_RANGE

Artigo
08/25/2010

Usar essa macro para MAP um intervalo contíguo de IDs de comando para uma função de manipulador de mensagens única.

ON_COMMAND_RANGE(id1, id2, memberFxn )

Parâmetros

id1
ID de comando no início de um intervalo contíguo de IDs de comando.
id2
ID de comando no participante de um intervalo contíguo de IDs de comando.
memberFxn
O nome da função de manipulador de mensagens aos quais os comandos são mapeados.

Comentários

Inicia o intervalo de identificações com id1 e termina com id2.

Use ON_COMMAND_RANGE para MAP um intervalo de IDs de comando para um membro de função. Use ON_COMMAND para MAP um único comando para uma função de membro.Apenas uma entrada de MAP da mensagem pode corresponder a uma ID de determinado comando.Ou seja, não é possível mapear um comando para mais de um manipulador.Para obter mais informações sobre o mapeamento de intervalos de mensagem, consulte Manipuladores para os intervalos de MAP de mensagens.

Não há nenhum suporte automático para intervalos de MAP da mensagem, portanto, você deve colocar a macro.

Exemplo

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