共用方式為


IOleDocumentView::CloseView 方法 (docobj.h)

指示檔檢視關閉本身,並釋放其 IOleInPlaceSite 指標。

語法

HRESULT CloseView(
  [in] DWORD dwReserved
);

參數

[in] dwReserved

此參數是保留的,不能是 Null

傳回值

此方法會在成功時傳回S_OK。

備註

不再需要個別視窗時,容器會呼叫 IOleDocumentView::CloseView,其中檢視會釋放其個別視窗的月臺指標,並終結視窗。 不同于使用中檔的一般就地停用順序,檔檢視會繼續保留 IOleInPlaceSite 指標。 只有當檢視的容器呼叫 SetInPlaceSite,並將 pIPSite 設定為 Null,或呼叫 IOleDocumentView::CloseView時,才會釋放此指標。

當使用者關閉檢視的個別視窗時,檢視不應該關閉本身。 相反地,它應該呼叫 IOleInPlaceSite::OnInPlaceActivate。 然後,檢視網站會決定是否立即或更新版本呼叫 IOleDocumentView::UIActivateFALSE 。 如此一來,在個別視窗中顯示的檔檢視仍可在容器自己的視窗中啟用。

容器必須先呼叫這個方法,才能刪除檢視,也就是釋放檢視的最後一個參考。 一般而言,此方法的實作會呼叫IOleDocumentView::Show with FALSE來隱藏檢視,如果尚未隱藏檢視,則呼叫具有NullSetInPlaceSite以停用本身並釋放檢視網站指標。

因為當容器即將完全關閉檢視時呼叫 IOleDocumentView::CloseView ,所以必須實作這個方法,而且沒有理由失敗。

需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 docobj.h

另請參閱

IOleDocumentView

IOleDocumentView::SetInPlaceSite

IOleDocumentView::Show