IOleDocumentView::Open method

Displays a document view in a separate pop-up window. The semantics are equivalent to IOleObject::DoVerb with OLEIVERB_OPEN.

Syntax


HRESULT Open();

Parameters

This method has no parameters.

Return value

This method returns S_OK on success. Other possible return values include the following.

Return codeDescription
E_FAIL

The operation failed.

E_OUTOFMEMORY

Insufficient memory available for the operation.

E_UNEXPECTED

An unexpected error occurred.

E_NOTIMPL

The document object that owns this view does not support separate window activation.

 

Remarks

A user viewing a document object in a container application such as a browser or "binder" may want to see two or more views or documents at once. Because the browser displays only one view at a time, the container needs a way to ask the other views or documents to display themselves, as required, in separate windows. The IOleDocumentView::Open method provides that way.

Notes to Callers

A successful call to IOleDocumentView::Open should be followed by a call to IOleDocumentView::Show to hide the window or to show the window and bring it to the foreground. While the view is active in its separate window, a container can show or hide the window as many times as it may require.

Notes to Implementers

A document object indicates that it does not support activation in a separate window by setting the DOCMISC_CANTOPENEDIT status flag and returning E_NOTIMPL to containers that call this method.

Implementation consists mainly of the view object calling its own IOleInPlaceObject::InPlaceDeactivate method, which leaves the document object in a running state but without in-place activation. The document object's user interface is not visible until the container calls IOleDocumentView::Show (see Notes to Callers above).

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

DocObj.h

IDL

DocObj.Idl

IID

IID_IOleDocumentView is defined as b722bcc6-4e68-101b-a2bc-00aa00404770

See also

IOleDocumentView
IOleDocumentView::CloseView
IOleDocumentView::Show
IOleDocumentView::UIActivate
IOleInPlaceObject::InPlaceDeactivate
IOleInPlaceSite
IOleInPlaceSite::OnInPlaceActivate

 

 

Show: