Compartilhar via


ON_COMMAND_RANGE

Use esta macro para mapear um intervalo contíguo de IDs de comando a uma única função de manipulador de mensagens.

ON_COMMAND_RANGE(id1, id2, memberFxn )

Parâmetros

  • id1
    A ID do comando no início de um intervalo contíguo de IDs de comando.

  • id2
    A ID do comando no início de um intervalo contíguo de IDs de comando.

  • memberFxn
    O nome da função retornadas à qual os comandos são mapeados.

Comentários

O intervalo de inícios de IDs com id1 de e termina com id2.

Use ON_COMMAND_RANGE para mapear um intervalo de IDs de comando a uma função de membro. Use ON_COMMAND para mapear um único comando a uma função de membro. Apenas uma entrada retornadas mapa pode corresponder a uma ID do comando Ou seja, você não pode mapear um comando em mais de um manipulador. Para obter mais informações sobre os intervalos da mensagem de mapeamento, consulte Manipuladores para intervalos retornadas mapa.

Não há suporte para intervalos automático da mensagem, assim você deve colocar a macro você mesmo.

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

Requisitos

Header: afxmsg_.h

Consulte também

Referência

ON_UPDATE_COMMAND_UI_RANGE

ON_CONTROL_RANGE

ON_COMMAND

Conceitos

Macros e globais MFC