ON_EVENT_RANGE

Artigo
02/25/2013

Use o ON_EVENT_RANGE macro para definir uma função de manipulador de eventos para um evento disparado por qualquer outro controle OLE ter uma identificação de controle dentro de um intervalo contíguo de identificações.

ON_EVENT_RANGE(theClass, idFirst, idLast, dispid, pfnHandler, vtsParams )

Parâmetros

theClass
A classe à qual pertence este mapa de coletor de eventos.
idFirst
A ID de controle do primeiro controle OLE no intervalo.
idLast
A ID de controle do último controle OLE no intervalo.
dispid
A ID de expedição do evento disparado pelo controle.
pfnHandler
Ponteiro para uma função de membro que manipula o evento.Esta função deve ter um BOOL um primeiro parâmetro de tipo, o tipo de retorno UINT (para a identificação de controle) e tipos de parâmetros adicionais que correspondam aos parâmetros do evento (consulte vtsParams).A função deve retornar TRUE para indicar o evento foi tratado; Caso contrário, FALSE.
vtsParams
Uma seqüência de VTS_ constantes que especifica os tipos dos parâmetros para o evento.A primeira constante deve ser do tipo VTS_I4, para a identificação do controle.Esses são os mesmas constantes que são usadas nas entradas de mapa de expedição como DISP_FUNCTION.

Comentários

O vtsParams argumento é uma lista separada por espaço de valores do VTS_ constantes.Um ou mais desses valores separados por espaços (não vírgulas) Especifica a lista de parâmetros da função.Por exemplo:

VTS_I2 VTS_BOOL

Especifica uma lista contendo um inteiro curto seguido de um BOOL.

Para obter uma lista de VTS_ constantes, consulte EVENT_CUSTOM.

Exemplo

O exemplo a seguir demonstra um manipulador de eventos para o evento MouseDown, implementado para três controles (IDC_MYCTRL1 por IDC_MYCTRL3).A função de manipulador de eventos OnRangeMouseDown, é declarada no arquivo de cabeçalho da classe diálogo (CMyDlg) como:

BOOL OnRangeMouseDown(UINT CtlID, short MouseButton, short Shift,
   long x, long y);

O código a seguir é definido no arquivo de implementação da classe caixa de diálogo.

BEGIN_EVENTSINK_MAP(CMyDlg, CDialog)
   ON_EVENT_RANGE(CMyDlg, IDC_MYCTRL1, IDC_MYCTRL3, -605, OnRangeMouseDown,
      VTS_I4 VTS_I2 VTS_I2 VTS_I4 VTS_I4)
END_EVENTSINK_MAP()