Metodo IOleDocumentView::Show (docobj.h)

Articolo
02/26/2024

Attiva o disattiva una visualizzazione.

Sintassi

HRESULT Show(
  [in] BOOL fShow
);

Parametri

[in] fShow

Se TRUE, la visualizzazione deve essere visualizzata. Se FALSE, la visualizzazione deve nascondersi.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
E_FAIL	Operazione non riuscita.
E_OUTOFMEMORY	Memoria insufficiente disponibile per l'operazione.
E_UNEXPECTED	Si è verificato un errore imprevisto.

Commenti

La chiamata a Show è l'ultimo passaggio della sequenza di attivazione, perché prima di visualizzare un oggetto documento deve conoscere esattamente lo spazio che occupa e avere tutti gli strumenti disponibili.

Note ai chiamanti

Una chiamata a questo metodo allo scopo di attivare una visualizzazione deve seguire le chiamate a IOleDocumentView::SetInPlaceSite, IOleDocumentView::UIActivate e IOleDocumentView::SetRect (o IOleDocumentView::SetRectComplex).

Note per gli implementatori

Le implementazioni di questo metodo devono rappresentare lo pseudocodice seguente.

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
    }

Tutte le visualizzazioni di un oggetto documento devono supportare almeno l'attivazione sul posto; E_NOTIMPL non è un valore accettabile.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	docobj.h