IOleDocumentView::Show

Instructs a view to in-place activate or in-place deactivate itself.

HRESULT Show(

BOOL fShow

// Boolean value specifying whether to activate or deactivate the view

);

Parameters

fShow: [in] TRUE instructs the view to show itself; FALSE instructs the view to hide itself.

Return Value

S_OK: The view was successfully shown or hidden.
E_OUTOFMEMORY: There was not enough memory to activate or hide the view.
E_FAIL: Some other critical error occurred that prevented activation or hiding.
E_UNEXPECTED: This method was called before a call to IOleDocumentView::SetInPlaceSite.

Remarks

Calling IOleDocumentView::Show is the last step in the activation sequence because before showing itself a document object must know exactly what space it occupies and have all its tools available.

Notes to Callers

A call to this method for the purpose of activating a view should follow calls to IOleDocumentView::SetInPlaceSite, IOleDocumentView::UIActivate, and IOleDocumentView::SetRect (or SetRectComplex).

Notes to Implementers

Implementations of this method should embody the following pseudo-code:

if (fShow)
    {
    In-place activate the view but do not UI activate it.
    Show the view window. 
    }
else
    {
    Call IOleDocumentView::UIActivate(FALSE) on this view
    Hide the view window
    }

All views of a document object must at least support the in-place activation mode, therefore E_NOTIMPL is not allowed as a return value.

BOOL fShow	// Boolean value specifying whether to activate or deactivate the view
);