IOleDocumentView::Open 方法 (docobj.h)

在单独的弹出窗口中显示文档视图。 语义等效于 具有 OLEIVERB_OPEN 的 IOleObject::D oVerb

语法

HRESULT Open();

返回值

此方法在成功时返回S_OK。 其他可能的返回值包括以下内容。

返回代码 说明
E_FAIL
此操作失败。
E_OUTOFMEMORY
可用于操作的内存不足。
E_UNEXPECTED
发生了意外错误。
E_NOTIMPL
拥有此视图的文档对象不支持单独的窗口激活。

注解

在容器应用程序(如浏览器或“绑定器”)中查看文档对象的用户可能希望同时查看两个或多个视图或文档。 由于浏览器一次只显示一个视图,因此容器需要一种方法来要求其他视图或文档根据需要在单独的窗口中显示自己。 IOleDocumentView::Open 方法提供这种方式。

给调用方的说明

成功调用 IOleDocumentView::Open 后,应调用 IOleDocumentView::Show 以隐藏窗口或显示窗口并将其带到前台。 当视图在其单独的窗口中处于活动状态时,容器可以根据需要多次显示或隐藏窗口。

实施者说明

文档对象通过设置 DOCMISC_CANTOPENEDIT状态标志并将E_NOTIMPL返回到调用此方法的容器,指示它不支持在单独的窗口中激活。

实现主要由调用其自己的 IOleInPlaceObject::InPlaceDeactivate 方法的视图对象组成,该方法使文档对象处于运行状态,但没有就地激活。 在容器调用 IOleDocumentView::Show 之前,文档对象的用户界面不可见 (请参阅上述) 的调用方说明。

要求

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

另请参阅

IOleDocumentView

IOleDocumentView::CloseView

IOleDocumentView::Show

IOleDocumentView::UIActivate

IOleInPlaceObject::InPlaceDeactivate

IOleInPlaceSite

IOleInPlaceSite::OnInPlaceActivate