Freigeben über


IOleDocumentView::Show-Methode (docobj.h)

Aktiviert oder deaktiviert eine Ansicht.

Syntax

HRESULT Show(
  [in] BOOL fShow
);

Parameter

[in] fShow

Wenn TRUE, soll sich die Ansicht selbst anzeigen. Bei FALSE soll sich die Ansicht selbst ausblenden.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode Beschreibung
E_FAIL
Fehler beim Vorgang.
E_OUTOFMEMORY
Unzureichender Arbeitsspeicher für den Betrieb.
E_UNEXPECTED
Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Das Aufrufen von Show ist der letzte Schritt in der Aktivierungssequenz, da ein Dokumentobjekt vor der Anzeige genau wissen muss, welchen Platz es belegt, und alle seine Tools zur Verfügung haben.

Hinweise für Anrufer

Ein Aufruf dieser Methode zum Aktivieren einer Ansicht sollte Aufrufen von IOleDocumentView::SetInPlaceSite, IOleDocumentView::UIActivate und IOleDocumentView::SetRect (oder IOleDocumentView::SetRectComplex) folgen.

Hinweise zu Implementierern

Implementierungen dieser Methode sollten den folgenden Pseudocode verkörpern.
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
    }

Alle Ansichten eines Dokumentobjekts müssen mindestens die direkte Aktivierung unterstützen. E_NOTIMPL ist kein akzeptabler Wert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile docobj.h

Weitere Informationen

IOleDocumentView

IOleDocumentView::SetInPlaceSite

IOleDocumentView::SetRect

IOleDocumentView::SetRectComplex

IOleDocumentView::UIActivate