이벤트 맵
컨트롤이 컨테이너에 키 입력, 마우스 클릭 또는 컨트롤 상태 변경과 같은 일부 작업(예: 컨트롤 개발자에 의해 결정됨)이 발생했음을 알리려고 할 때마다 이벤트 발생 함수를 호출합니다. 이 함수는 컨트롤 컨테이너에 관련 이벤트를 발생시켜 몇 가지 중요한 작업이 발생했음을 알립니다.
Microsoft Foundation 클래스 라이브러리는 이벤트 발생에 최적화된 프로그래밍 모델을 제공합니다. 이 모델에서 "이벤트 맵"은 특정 컨트롤에 대한 이벤트를 발생시키는 함수를 지정하는 데 사용됩니다. 이벤트 맵에는 각 이벤트에 대해 하나의 매크로가 포함되어 있습니다. 예를 들어 stock Click 이벤트를 발생시키는 이벤트 맵은 다음과 같습니다.
BEGIN_EVENT_MAP(CMyAxCtrl, COleControl)
EVENT_STOCK_CLICK()
END_EVENT_MAP()
매크로는 EVENT_STOCK_CLICK 컨트롤이 마우스 클릭을 감지할 때마다 stock Click 이벤트를 실행한다는 것을 나타냅니다. 다른 주식 이벤트의 자세한 목록은 ActiveX 컨트롤: 이벤트 문서를 참조하세요. 매크로를 사용하여 사용자 지정 이벤트를 나타낼 수도 있습니다.
이벤트 맵 매크로는 중요하지만 일반적으로 직접 삽입하지는 않습니다. 속성 창(클래스 뷰)은 이벤트 발생 함수를 이벤트와 연결하는 데 사용할 때 소스 파일에 이벤트 맵 항목을 자동으로 만들기 때문입니다. 이벤트 맵 항목을 편집하거나 추가하려는 경우 언제든지 속성 창을 사용할 수 있습니다.
이벤트 맵을 지원하기 위해 MFC는 다음 매크로를 제공합니다.
이벤트 맵 매크로
이벤트 맵 선언 및 경계
| 속성 | 설명 |
|---|---|
| DECLARE_EVENT_MAP | 이벤트 맵이 클래스에서 이벤트 발생 함수에 이벤트를 매핑하는 데 사용됨을 선언합니다(클래스 선언에서 사용해야 함). |
| BEGIN_EVENT_MAP | 이벤트 맵의 정의를 시작합니다(클래스 구현에서 사용해야 합니다). |
| END_EVENT_MAP | 이벤트 맵의 정의를 종료합니다(클래스 구현에서 사용해야 합니다). |
이벤트 매핑 매크로
| 속성 | 설명 |
|---|---|
| EVENT_CUSTOM | 지정된 이벤트를 발생시킬 이벤트 발생 함수를 나타냅니다. |
| EVENT_CUSTOM_ID | 지정된 디스패치 ID를 사용하여 지정된 이벤트를 발생시킬 이벤트 발생 함수를 나타냅니다. |
메시지 매핑 매크로
| 속성 | 설명 |
|---|---|
| ON_OLEVERB | OLE 컨트롤에서 처리하는 사용자 지정 동사를 나타냅니다. |
| ON_STDOLEVERB | OLE 컨트롤의 표준 동사 매핑을 재정의합니다. |
DECLARE_EVENT_MAP
프로그램에서 파생된 각 COleControl클래스는 컨트롤에서 발생하는 이벤트를 지정하는 이벤트 맵을 제공할 수 있습니다.
DECLARE_EVENT_MAP()
설명
클래스 선언의 끝에 DECLARE_EVENT_MAP 매크로를 사용합니다. 그런 다음 클래스의 멤버 함수를 정의하는 .cpp 파일에서 BEGIN_EVENT_MAP 매크로, 컨트롤의 각 이벤트에 대한 매크로 항목 및 END_EVENT_MAP 매크로를 사용하여 이벤트 목록의 끝을 선언합니다.
이벤트 맵에 대한 자세한 내용은 ActiveX 컨트롤: 이벤트 문서를 참조하세요.
요구 사항
헤더 afxctl.h
BEGIN_EVENT_MAP
이벤트 맵의 정의를 시작합니다.
BEGIN_EVENT_MAP(theClass, baseClass)
매개 변수
theClass
이벤트 맵이 있는 컨트롤 클래스의 이름을 지정합니다.
baseClass
TheClass의 기본 클래스 이름을 지정합니다.
설명
클래스의 멤버 함수를 정의하는 구현(.cpp) 파일에서 BEGIN_EVENT_MAP 매크로를 사용하여 이벤트 맵을 시작한 다음 각 이벤트에 대한 매크로 항목을 추가하고 END_EVENT_MAP 매크로를 사용하여 이벤트 맵을 완료합니다.
이벤트 맵 및 BEGIN_EVENT_MAP 매크로에 대한 자세한 내용은 ActiveX 컨트롤: 이벤트 문서를 참조하세요.
요구 사항
헤더 afxctl.h
END_EVENT_MAP
END_EVENT_MAP 매크로를 사용하여 이벤트 맵의 정의를 종료합니다.
END_EVENT_MAP()
요구 사항
헤더 afxctl.h
EVENT_CUSTOM
사용자 지정 이벤트에 대한 이벤트 맵 항목을 정의합니다.
EVENT_CUSTOM(pszName, pfnFire, vtsParams)
매개 변수
pszName
이벤트의 이름입니다.
pfnFire
이벤트 발생 함수의 이름입니다.
vtsParams
함수의 매개 변수 목록을 지정하는 하나 이상의 상수에 대한 공백으로 구분된 목록입니다.
설명
vtsParams 매개 변수는 상수에서 VTS_ 공백으로 구분된 값 목록입니다. 공백(쉼표 아님)으로 구분된 이러한 값 중 하나 이상이 함수의 매개 변수 목록을 지정합니다. 예시:
VTS_COLOR VTS_FONT
는 RGB 색 값을 나타내는 32비트 정수가 포함된 목록과 OLE 글꼴 개체의 인터페이스에 IFontDisp 대한 포인터를 지정합니다.
VTS_ 상수와 그 의미는 다음과 같습니다.
| 기호 | 매개 변수 형식 |
|---|---|
| VTS_I2 | short |
| VTS_I4 | long |
| VTS_R4 | float |
| VTS_R8 | double |
| VTS_COLOR | OLE_COLOR |
| VTS_CY | 통화 |
| VTS_DATE | DATE |
| VTS_BSTR | constchar* |
| VTS_DISPATCH | LPDISPATCH |
| VTS_FONT | IFontDispatch* |
| VTS_HANDLE | HANDLE |
| VTS_SCODE | SCODE |
| VTS_BOOL | BOOL |
| VTS_VARIANT | const VARIANT* |
| VTS_PVARIANT | VARIANT* |
| VTS_UNKNOWN | LPUNKNOWN |
| VTS_OPTEXCLUSIVE | OLE_OPTEXCLUSIVE |
| VTS_PICTURE | IPictureDisp* |
| VTS_TRISTATE | OLE_TRISTATE |
| VTS_XPOS_PIXELS | OLE_XPOS_PIXELS |
| VTS_YPOS_PIXELS | OLE_YPOS_PIXELS |
| VTS_XSIZE_PIXELS | OLE_XSIZE_PIXELS |
| VTS_YSIZE_PIXELS | OLE_YSIZE_PIXELS |
| TS_XPOS_HIMETRIC | OLE_XPOS_HIMETRIC |
| VTS_YPOS_HIMETRIC | OLE_YPOS_HIMETRIC |
| VTS_XSIZE_HIMETRIC | OLE_XSIZE_HIMETRIC |
| VTS_YSIZE_HIMETRIC | OLE_YSIZE_HIMETRIC |
참고 항목
변형 데이터 상수에 대한 포인터를 제공하는 VTS_FONT 및 VTS_PICTURE 제외하고 모든 변형 형식에 대해 추가 변형 상수가 정의되었습니다. 이러한 상수는 규칙을 사용하여 VTS_Pconstantname 명명됩니다. 예를 들어 VTS_PCOLOR VTS_COLOR 상수에 대한 포인터입니다.
요구 사항
헤더 afxctl.h
EVENT_CUSTOM_ID
dispid에서 지정한 디스패치 ID에 속하는 사용자 지정 이벤트에 대한 이벤트 발생 함수를 정의합니다.
EVENT_CUSTOM_ID(
pszName,
dispid,
pfnFire,
vtsParams)
매개 변수
pszName
이벤트의 이름입니다.
dispid
이벤트를 발생 시에 컨트롤에서 사용 하는 디스패치 ID입니다.
pfnFire
이벤트 발생 함수의 이름입니다.
vtsParams
이벤트가 발생할 때 컨트롤 컨테이너에 전달되는 매개 변수의 변수 목록입니다.
설명
vtsParams 인수는 상수에서 VTS_ 공백으로 구분된 값 목록입니다. 이러한 값 중 하나 이상이 쉼표가 아닌 공백으로 구분되어 함수의 매개 변수 목록을 지정합니다. 예시:
VTS_COLOR VTS_FONT
는 RGB 색 값을 나타내는 32비트 정수가 포함된 목록과 OLE 글꼴 개체의 인터페이스에 IFontDisp 대한 포인터를 지정합니다.
상수 목록은 VTS_ EVENT_CUSTOM 참조하세요.
요구 사항
헤더 afxctl.h
ON_OLEVERB
이 매크로는 사용자 지정 동사를 컨트롤의 특정 멤버 함수에 매핑하는 메시지 맵 항목을 정의합니다.
ON_OLEVERB(idsVerbName, memberFxn)
매개 변수
idsVerbName
동사 이름의 문자열 리소스 ID입니다.
memberFxn
동사가 호출될 때 프레임워크에서 호출하는 함수입니다.
설명
리소스 편집기를 사용하여 문자열 테이블에 추가되는 사용자 지정 동사 이름을 만들 수 있습니다.
memberFxn의 함수 프로토타입은 다음과 같습니다.
BOOL memberFxn(
LPMSG lpMsg,
HWND hWndParent,
LPCRECT lpRect);
lpMsg, hWndParent 및 lpRect 매개 변수의 값은 멤버 함수의 IOleObject::DoVerb 해당 매개 변수에서 가져옵니다.
요구 사항
헤더 afxole.h
ON_STDOLEVERB
이 매크로를 사용하여 표준 동사의 기본 동작을 재정의합니다.
ON_STDOLEVERB(iVerb, memberFxn)
매개 변수
iVerb
재정의되는 동사의 표준 동사 인덱스입니다.
memberFxn
동사가 호출될 때 프레임워크에서 호출하는 함수입니다.
설명
표준 동사 인덱스는 다음 작업 OLEIVERB_형식입니다. OLEIVERB_SHOW, OLEIVERB_HIDE 및 OLEIVERB_UIACTIVATE 표준 동사의 몇 가지 예입니다.
memberFxn 매개 변수로 사용할 함수 프로토타입에 대한 설명은 ON_OLEVERB 참조하세요.
요구 사항
헤더 afxole.h