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 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | docobj.h |