IOleDocumentView::Show-Methode (docobj.h)

Artikel
02/27/2024

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