IOleDocumentSite::ActivateMe 메서드(docobj.h)
문서 사이트에 현재 위치 활성 개체가 아닌 문서 개체로 호출하는 문서를 활성화하도록 요청하고 필요에 따라 활성화할 개체 문서의 보기를 지정합니다.
구문
HRESULT ActivateMe(
[in] IOleDocumentView *pViewToActivate
);
매개 변수
[in] pViewToActivate
문서 개체를 활성화하는 데 사용할 문서 보기를 나타내는 IOleDocumentView 인터페이스 포인터에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. 이 경우 컨테이너는 IOleDocument::CreateView 를 호출하여 문서 보기 포인터를 가져와야 합니다.
반환 값
이 메서드는 성공에 대한 S_OK 반환합니다.
설명
컨테이너가 IOleObject::D oVerb 을 호출하여 문서를 활성화하는 경우 문서 개체는 IOleDocumentSite::ActivateMe를 호출하여 일반적인 현재 위치 활성화 시퀀스를 무시합니다.
문서 개체 에서 IOleObject::D oVerb 을 호출할 때 가장 적합한 활성화 동사는 일반적으로 OLEIVERB_SHOW. 다른 허용 동사에는 OLEIVERB_PRIMARY 및 OLEIVERB_UIACTIVATE 포함됩니다. OLEIVERB_OPEN 문서 개체 활성화의 의도와 반대되는 별도의 창에 포함된 개체를 여는 것을 의미하므로 권장되지 않습니다.
발신자에게 참고 사항
문서 개체만 이 메서드를 호출해야 합니다. 일반적인 현재 위치 활성 문서는 IOleInPlaceSite를 호출하여 IOleObject::D oVerb에 대한 컨테이너의 호출에 응답해야 합니다.문서 개체는 IOleDocumentSite::ActivateMe를 호출하여 활성화를 시작해야 합니다. 컨테이너가 IOleDocumentSite를 구현하지 않는 경우 문서는 기본적으로 일반적인 현재 위치 활성화 시퀀스로 설정되어야 합니다.
둘 이상의 데이터 보기를 지원하는 문서 개체는 pViewToActivate에서 해당 보기의 IOleDocumentView 인터페이스에 포인터를 전달하여 활성화할 보기를 지정할 수 있습니다.
그러나 IOleDocumentView 포인터를 가져오면 컨테이너는 더 이상 필요하지 않은 경우 포인터를 해제해야 합니다.
구현자에 대한 참고 사항
이 함수는 문서 개체 컨테이너에서 완전히 구현되어야 합니다. E_NOTIMPL 허용되는 반환 값이 아닙니다.문서 개체가 pViewToActivate에서 IOleDocumentView 포인터를 전달하는 경우 컨테이너의 IOleDocumentSite::ActivateMe 구현은 IOleDocumentView::SetInPlaceSite를 호출하고 해당 IOleInPlaceSite 인터페이스에 대한 포인터를 뷰 개체에 다시 전달해야 합니다. 컨테이너가 일반적으로 해당되는 IOleDocumentView 포인터를 유지하는 경우 IUnknown::AddRef를 호출하여 IOleDocumentView::SetInPlaceSite 호출을 따라야 합니다.
pViewToActivate가 NULL인 경우 컨테이너는 IOleDocument에 대한 문서를 쿼리한 다음 IOleDocument::CreateView를 호출하고 해당 IOleInPlaceSite 포인터를 전달하여 문서 보기에 대한 포인터를 가져올 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | docobj.h |