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 |