IOleDocumentView::CloseView 方法 (docobj.h)

指示文档视图关闭自身并释放其 IOleInPlaceSite 指针。

语法

HRESULT CloseView(
  [in] DWORD dwReserved
);

参数

[in] dwReserved

此参数是保留的,不能为 NULL

返回值

此方法在成功时返回S_OK。

备注

当不再需要单独的窗口时,容器将调用 IOleDocumentView::CloseView,其中视图释放其指向单独窗口的站点指针并销毁该窗口。 与活动文档的正常就地停用序列不同,文档视图继续保留 IOleInPlaceSite 指针。 仅当视图的容器调用 SetInPlaceSitepIPSite 设置为 NULL 或调用 IOleDocumentView::CloseView 时,才会释放此指针。

当用户关闭视图的单独窗口时,视图不应自行关闭。 相反,它应调用 IOleInPlaceSite::OnInPlaceActivate。 然后,视图站点会决定是立即调用 IOleDocumentView::UIActivate ,还是立即调用 FALSE 。 这样,在单独的窗口中显示的文档视图仍可在容器自己的窗口中激活。

容器必须先调用此方法,然后才能删除视图,即释放对视图的最后一个引用。 通常,此方法的实现将调用 IOleDocumentView::Show with FALSE 以隐藏视图(如果视图尚未隐藏),然后调用具有 NULLSetInPlaceSite 以停用自身并释放视图网站指针。

由于在容器要完全关闭视图时调用 IOleDocumentView::CloseView ,因此必须实现此方法,并且没有理由失败。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 docobj.h

请参阅

IOleDocumentView

IOleDocumentView::SetInPlaceSite

IOleDocumentView::Show