ON_EVENT_RANGE

아티클
06/10/2015

ON_EVENT_RANGE 매크로를 사용하여 인접한 ID 범위 내에서 제어 ID를 갖는 임의의 OLE 컨트롤에 의해 트리거 된 이벤트에 대한 이벤트 핸들러 함수를 정의합니다.

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

매개 변수

theClass
이 이벤트 싱크 맵이 속한 클래스입니다.
idFirst
범위에서 첫 번째 OLE 컨트롤의 컨트롤 ID입니다.
idLast
범위에서 마지막 OLE 컨트롤의 컨트롤 ID입니다.
dispid
컨트롤에 의해 발생한 이벤트의 디스패치 ID입니다.
pfnHandler
이벤트를 처리하는 멤버 함수에 대한 포인터입니다. 이 함수는 UINT 형식의 첫번째 매개변수인(control ID에 대한) BOOL 반환 형식과 이벤트의 매개 변수와 일치하는 추가적인 매개 변수 형식 ( vtsParams 을 참조)을 가져야합니다.. 함수 TRUE 을 반환하여 이벤트가 처리되었음을 나타냅니다. 그렇지 않으면 FALSE를 반환합니다.
vtsParams
**VTS_**의 시퀀스는 이벤트에 대한 매개 변수 형식을 지정하는 상수입니다. 첫 번째 상수는 컨트롤 ID에대한 VTS_I4형식이어야 합니다. DISP_FUNCTION 같은 디스패치 맵 항목에서 사용되는 동일한 상수가 있습니다.

설명

vtsParams 인수는 VTS_ 상수의 공백으로 구분 된 값 목록입니다. 스페이스 (콤마가 아님)로 구분이 값 중 하나 이상이 함수의 매개 변수 목록을 지정합니다. 예를 들면 다음과 같습니다.

VTS_I2 VTS_BOOL

짧은 정수를 포함하는 목록을 BOOL로 지정합니다.

**VTS_**상수이 목록에 대하여, EVENT_CUSTOM을 참조하십시오.

예제

다음 예제에서는 세 가지 컨트롤에 대해 구현 MouseDown 이벤트에 대한 이벤트 처리기를 보여줍니다 ( IDC_MYCTRL1 - IDC_MYCTRL3 ). 이벤트 처리기 함수 OnRangeMouseDown 는 대화 상자 클래스(CMyDlg)의 헤더 파일을 선언합니다.

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

아래의 코드는 대화 상자 클래스의 구현 파일에 정의됩니다.

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