IOleDocumentView::CloseView-Methode (docobj.h)

Weist eine Dokumentansicht an, sich selbst zu schließen und den IOleInPlaceSite-Zeiger freizugeben.

Syntax

HRESULT CloseView(
  [in] DWORD dwReserved
);

Parameter

[in] dwReserved

Dieser Parameter ist reserviert und darf nicht NULL sein.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück.

Hinweise

Wenn ein separates Fenster nicht mehr benötigt wird, ruft der Container IOleDocumentView::CloseView auf, worauf die Ansicht den Standortzeiger auf das separate Fenster freigibt und das Fenster zerstört. Im Gegensatz zur normalen Deaktivierungssequenz für aktive Dokumente enthält eine Dokumentansicht weiterhin den IOleInPlaceSite-Zeiger . Dieser Zeiger wird nur freigegeben, wenn der Container der Ansicht SetInPlaceSite aufruft, wobei pIPSite auf NULL festgelegt ist, oder IOleDocumentView::CloseView aufruft.

Wenn ein Benutzer das separate Fenster einer Ansicht schließt, sollte sich die Ansicht nicht selbst herunterfahren. Stattdessen sollte IOleInPlaceSite::OnInPlaceActivate aufgerufen werden. Die Ansichtswebsite entscheidet dann, ob IOleDocumentView::UIActivate mit FALSE sofort oder später aufgerufen werden soll. Auf diese Weise bleibt eine Dokumentansicht, die in einem separaten Fenster angezeigt wird, für die Aktivierung im eigenen Fenster des Containers verfügbar.

Der Container muss diese Methode aufrufen, bevor er die Sicht löscht, d. h. den letzten Verweis auf die Sicht freigibt. Im Allgemeinen ruft die Implementierung dieser Methode IOleDocumentView::Show mit FALSE auf, um die Ansicht auszublenden, wenn sie nicht bereits ausgeblendet ist. Rufen Sie dann SetInPlaceSite mit NULL auf, um sich selbst zu deaktivieren und den Ansichtswebsitezeiger freizugeben.

Da IOleDocumentView::CloseView aufgerufen wird, wenn ein Container eine Ansicht vollständig heruntergefahren wird, muss diese Methode implementiert werden und hat keinen Grund zum Fehlschlagen.

Anforderungen

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::Show