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 code | Description |
|---|---|
|
The operation failed. |
|
Insufficient memory available for the operation. |
|
An unexpected error occurred. |
|
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 |
|
|
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