ON_EVENT_RANGE

Artigo
08/25/2010

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 ID 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 MAP de coletor de eventos.
idFirst
A ID de controle do primeiro controle OLE do 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 tipo de retorno, um primeiro parâmetro do tipo UINT (para a ID de controle) e os tipos de parâmetros adicionais correspondem aos parâmetros do evento (consulte vtsParams). A função deve retornar TRUE para indicar que o evento foi tratado; caso contrário, FALSE.
vtsParams
Uma sequência de VTS_ constantes que especifica os tipos dos parâmetros para o evento.Primeira constante deve ser do tipo VTS_I4, para a ID de controle.Esses são sistema autônomo mesmas constantes que são usadas sistema autônomo entradas de MAP de despacho, sistema autônomo DISP_FUNCTION.

Comentários

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

VTS_I2 VTS_BOOL

Especifica uma lista que contém um inteiro curto seguido por um BOOL.

Para obter uma lista do 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 meio de IDC_MYCTRL3). A função de manipulador de eventos, OnRangeMouseDown, é declarada no arquivo de cabeçalho do () classe a caixa de diálogoCMyDlg) sistema autônomo:

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 de 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()