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::UIActivate 與 FALSE 。 如此一來,在個別視窗中顯示的檔檢視仍可在容器自己的視窗中啟用。
容器必須先呼叫這個方法,才能刪除檢視,也就是釋放檢視的最後一個參考。 一般而言,此方法的實作會呼叫IOleDocumentView::Show with FALSE來隱藏檢視,如果尚未隱藏檢視,則呼叫具有Null的SetInPlaceSite以停用本身並釋放檢視網站指標。
因為當容器即將完全關閉檢視時呼叫 IOleDocumentView::CloseView ,所以必須實作這個方法,而且沒有理由失敗。
需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | docobj.h |