연결 맵
OLE 컨트롤은 인터페이스를 다른 애플리케이션에 노출할 수 있습니다. 이러한 인터페이스는 컨테이너에서 해당 컨트롤로의 액세스만 허용합니다. OLE 컨트롤이 다른 OLE 개체의 외부 인터페이스에 액세스하려는 경우 연결점을 설정해야 합니다. 이 연결점을 사용하면 이벤트 맵 또는 알림 함수와 같은 외부 디스패치 맵에 대한 제어 나가는 액세스를 허용합니다.
Microsoft Foundation 클래스 라이브러리는 연결점을 지원하는 프로그래밍 모델을 제공합니다. 이 모델에서 "연결 맵"은 OLE 컨트롤의 인터페이스 또는 연결점을 지정하는 데 사용됩니다. 연결 맵에는 각 연결 지점에 대해 하나의 매크로가 포함되어 있습니다. 연결 맵에 대한 자세한 내용은 클래스를 참조하세요 CConnectionPoint .
일반적으로 컨트롤은 두 개의 연결 지점만 지원합니다. 하나는 이벤트용이고 다른 하나는 속성 알림용입니다. 이는 기본 클래스에 COleControl 의해 구현되며 컨트롤 작성기에서 추가 작업이 필요하지 않습니다. 클래스에서 구현하려는 다른 연결점을 수동으로 추가해야 합니다. 연결 맵 및 지점을 지원하기 위해 MFC는 다음 매크로를 제공합니다.
연결 맵 선언 및 경계
| 속성 | 설명 |
|---|---|
BEGIN_CONNECTION_PART |
추가 연결점을 구현하는 포함된 클래스를 선언합니다(클래스 선언에서 사용해야 합니다). |
END_CONNECTION_PART |
연결점 선언을 종료합니다(클래스 선언에 사용해야 합니다). |
CONNECTION_IID |
컨트롤 연결 지점의 인터페이스 ID를 지정합니다. |
DECLARE_CONNECTION_MAP |
클래스에서 연결 맵이 사용되도록 선언합니다(클래스 선언에서 사용해야 합니다). |
BEGIN_CONNECTION_MAP |
연결 맵의 정의를 시작합니다(클래스 구현에서 사용해야 합니다). |
END_CONNECTION_MAP |
연결 맵의 정의를 종료합니다(클래스 구현에서 사용해야 합니다). |
CONNECTION_PART |
컨트롤의 연결 맵에 연결점을 지정합니다. |
다음 함수는 싱크가 연결 지점을 사용하여 연결을 설정하고 연결을 끊는 데 도움이 됩니다.
연결 지점 초기화/종료
| 속성 | 설명 |
|---|---|
AfxConnectionAdvise |
원본과 싱크 간에 연결을 설정합니다. |
AfxConnectionUnadvise |
원본과 싱크 간의 연결을 끊습니다. |
BEGIN_CONNECTION_PART
매크로를 BEGIN_CONNECTION_PART 사용하여 이벤트 및 속성 알림 연결 지점 이외의 추가 연결점 정의를 시작합니다.
BEGIN_CONNECTION_PART(theClass, localClass)
매개 변수
theClass 연결점이 있는 컨트롤 클래스의 이름을 지정합니다.
localClass 연결점을 구현하는 로컬 클래스의 이름을 지정합니다.
설명
클래스의 멤버 함수를 정의하는 선언(.h) 파일에서 매크로를 BEGIN_CONNECTION_PART 사용하여 연결점을 시작합니다. 그런 다음 매크로 및 구현하려는 다른 멤버 함수를 추가 CONNECTION_IID 합니다. 마지막으로 매크로를 사용하여 연결점 맵을 완료합니다 END_CONNECTION_PART .
요구 사항
머리글 afxdisp.h
END_CONNECTION_PART
연결 지점의 선언을 종료합니다.
END_CONNECTION_PART(localClass)
매개 변수
localClass
연결 지점을 구현하는 로컬 클래스의 이름을 지정합니다.
요구 사항
머리글 afxdisp.h
CONNECTION_IID
매크로와 END_CONNECTION_PART 매크로를 사용하여 BEGIN_CONNECTION_PART OLE 컨트롤에서 지원하는 연결점에 대한 인터페이스 ID를 정의합니다.
CONNECTION_IID(iid)
매개 변수
iid
연결점에서 호출하는 인터페이스의 인터페이스 ID입니다.
설명
인수는 iid 연결 지점이 연결된 싱크에서 호출하는 인터페이스를 식별하는 데 사용되는 인터페이스 ID입니다. 예시:
CONNECTION_IID(IID_ISampleSink)
인터페이스를 호출하는 연결점을 지정합니다 ISinkInterface .
요구 사항
머리글 afxdisp.h
DECLARE_CONNECTION_MAP
프로그램의 각 COleControl파생 클래스는 컨트롤이 지원하는 추가 연결 지점을 지정하는 연결 맵을 제공할 수 있습니다.
DECLARE_CONNECTION_MAP()
설명
컨트롤이 추가 지점을 지원하는 경우 클래스 선언의 끝에 있는 매크로를 사용합니다 DECLARE_CONNECTION_MAP . 그런 다음 클래스의 멤버 함수를 정의하는 .cpp 파일에서 매크로, CONNECTION_PART 컨트롤의 각 연결점에 대한 매크로 및 END_CONNECTION_MAP 매크로를 사용하여 BEGIN_CONNECTION_MAP 연결 맵의 끝을 선언합니다.
요구 사항
머리글 afxdisp.h
BEGIN_CONNECTION_MAP
프로그램에서 각 COleControl 파생 클래스는 컨트롤을 지원하는 연결 포인트를 지정하기 위해 연결 맵을 제공할 수 있습니다.
BEGIN_CONNECTION_MAP(theClass, theBase)
매개 변수
theClass
이 연결을 매핑할 컨트롤 클래스의 이름을 지정합니다.
theBase
기본 클래스 theClass의 이름을 지정합니다.
설명
클래스의 멤버 함수를 정의하는 구현(.CPP) 파일에서 매크로를 사용하여 연결 맵을 BEGIN_CONNECTION_MAP 시작한 다음 매크로를 사용하여 CONNECTION_PART 각 연결 지점에 대한 매크로 항목을 추가합니다. 마지막으로 매크로를 사용하여 연결 맵을 완료합니다 END_CONNECTION_MAP .
요구 사항
머리글 afxdisp.h
END_CONNECTION_MAP
연결 맵의 정의를 끝냅니다.
END_CONNECTION_MAP()
요구 사항
머리글 afxdisp.h
CONNECTION_PART
OLE 컨트롤의 연결점을 특정 인터페이스 ID에 매핑합니다.
CONNECTION_PART(theClass, iid, localClass)
매개 변수
theClass
연결점이 있는 컨트롤 클래스의 이름을 지정합니다.
iid
연결점에서 호출하는 인터페이스의 인터페이스 ID입니다.
localClass
연결 지점을 구현하는 로컬 클래스의 이름을 지정합니다.
설명
예시:
BEGIN_CONNECTION_MAP(CMyClass, CCmdTarget)
CONNECTION_PART(CMyClass, IID_ISampleSink, SampleConnPt)
END_CONNECTION_MAP()
는 인터페이스를 호출하는 연결 지점을 사용하여 연결 맵을 구현합니다 IID_ISinkInterface .
요구 사항
머리글 afxdisp.h
AfxConnectionAdvise
이 함수를 호출하여 지정된 원본 pUnkSrc과 지정된 싱크 pUnkSink간에 연결을 설정합니다.
BOOL AFXAPI AfxConnectionAdvise(
LPUNKNOWN pUnkSrc,
REFIID iid,
LPUNKNOWN pUnkSink,
BOOL bRefCount,
DWORD FAR* pdwCookie);
매개 변수
pUnkSrc
인터페이스를 호출하는 개체에 대한 포인터입니다.
pUnkSink
인터페이스를 구현하는 개체에 대한 포인터입니다.
iid
연결의 인터페이스 ID입니다.
bRefCount
Out-of-process 연결의 경우 이 매개 변수는 여야 TRUE하며 연결을 만들면 참조 수가 pUnkSink 증가해야 임을 나타냅니다.
In-Process 연결의 TRUE 경우 연결을 만들면 참조 수가 pUnkSink 증가해야 하므로 FALSE 는 참조 수를 증가해서는 안 됨을 나타냅니다.
경고: 일반적으로 어떤 연결이 처리 중이고 어떤 연결이 처리되지 않는지 예측할 수 없으므로 항상 이 매개 변수를 TRUE로 설정하는 것이 좋습니다.
pdwCookie
연결 식별자가 반환되는 위치에 대한 포인터 DWORD 입니다. 이 값은 연결 끊을 때 매개 변수 AfxConnectionUnadvise 로 dwCookie 전달되어야 합니다.
Return Value
연결이 설정된 경우 0이 아닌 경우 그렇지 않으면 0입니다.
예시
//CMySink is a CCmdTarget-derived class supporting automation.
//Instantiate the sink class.
CMySink mysink;
//Get a pointer to sink's IUnknown, no AddRef done.
IID iid = IID_IUnknown;
IUnknown* pUnkSink = mysink.GetInterface(&iid);
//Establish a connection between source and sink.
//pUnkSrc is IUnknown of server obtained by CoCreateInstance().
//dwCookie is a cookie identifying the connection, and is needed
//to terminate this connection.
AfxConnectionAdvise(pUnkSrc, IID_ISampleSink, pUnkSink, FALSE, &dwCookie);
요구 사항
머리글: afxctl.h
AfxConnectionUnadvise
이 함수를 호출하여 지정된 원본 pUnkSrc과 지정된 싱크 pUnkSink간의 연결을 끊습니다.
BOOL AFXAPI AfxConnectionUnadvise(
LPUNKNOWN pUnkSrc,
REFIID iid,
LPUNKNOWN pUnkSink,
BOOL bRefCount,
DWORD dwCookie);
매개 변수
pUnkSrc
인터페이스를 호출하는 개체에 대한 포인터입니다.
pUnkSink
인터페이스를 구현하는 개체에 대한 포인터입니다.
iid
연결점 인터페이스의 인터페이스 ID입니다.
bRefCount
Out-of-process 연결의 경우 이 매개 변수는 반드시 연결이어야 TRUE하며 연결을 만들면 참조 수가 pUnkSink 감소해야 임을 나타냅니다.
In-Process 연결의 TRUE 경우 연결을 만들면 참조 수가 pUnkSink 감소해야 임을 나타냅니다. FALSE 는 참조 수를 줄여서는 안 됨을 나타냅니다.
경고: 일반적으로 어떤 연결이 처리 중이고 어떤 연결이 처리되지 않는지 예측할 수 없으므로 항상 이 매개 변수를 TRUE로 설정하는 것이 좋습니다.
dwCookie
에서 반환한 AfxConnectionAdvise연결 식별자입니다.
반환 값
연결이 끊어진 경우 0이 아닌 경우 그렇지 않으면 0입니다.
예시
//mysink is a CCmdTarget-derived class supporting automation.
//Get a pointer to sink's IUnknown, no AddRef done.
IID iid = IID_IUnknown;
IUnknown* pUnkSink = mysink.GetInterface(&iid);
//Terminate a connection between source and sink.
//pUnkSrc is IUnknown of server obtained by CoCreateInstance().
//dwCookie is a value obtained through AfxConnectionAdvise().
AfxConnectionUnadvise(pUnkSrc, IID_ISampleSink, pUnkSink, FALSE, dwCookie);
요구 사항
머리글: afxctl.h
참고 항목
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기