IOleDocumentView::CloseView 메서드(docobj.h)
문서 보기에 자체적으로 닫고 IOleInPlaceSite 포인터를 해제하도록 지시합니다.
구문
HRESULT CloseView(
[in] DWORD dwReserved
);
매개 변수
[in] dwReserved
이 매개 변수는 예약되어 있으며 NULL일 수 없습니다.
반환 값
이 메서드는 성공에 대한 S_OK 반환합니다.
설명
별도의 창이 더 이상 필요하지 않은 경우 컨테이너는 IOleDocumentView::CloseView를 호출합니다. 이때 보기는 별도의 창에 대한 사이트 포인터를 해제하고 창을 삭제합니다. 현재 문서의 일반적인 현재 위치 비활성화 시퀀스와 달리 문서 보기에는 IOleInPlaceSite 포인터가 계속 유지됩니다. 이 포인터는 보기의 컨테이너가 PIPSite가 NULL로 설정된 SetInPlaceSite를 호출하거나 IOleDocumentView::CloseView를 호출하는 경우에만 해제됩니다.
사용자가 보기의 별도 창을 닫으면 보기가 종료되지 않아야 합니다. 대신 IOleInPlaceSite::OnInPlaceActivate를 호출해야 합니다. 그런 다음 보기 사이트에서 즉시 또는 나중에 FALSE를 사용하여 IOleDocumentView::UIActivate를 호출할지 여부를 결정합니다. 이러한 방식으로 별도의 창에 표시되는 문서 보기는 컨테이너의 자체 창에서 활성화할 수 있습니다.
컨테이너는 뷰를 삭제하기 전에 이 메서드를 호출해야 합니다. 즉, 뷰에 대한 마지막 참조를 해제합니다. 일반적으로 이 메서드의 구현은 IOleDocumentView::SHOW with FALSE 를 호출하여 뷰가 아직 숨겨져 있지 않은 경우 숨긴 다음, SetInPlaceSite with NULL 을 호출하여 자체를 비활성화하고 보기 사이트 포인터를 해제합니다.
IOleDocumentView::CloseView는 컨테이너가 뷰를 완전히 종료할 때 호출되므로 이 메서드를 구현해야 하며 실패할 이유가 없습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | docobj.h |