Metodo IOleDocumentView::CloseView (docobj.h)
Indica a una visualizzazione documento di chiudersi e rilasciare il puntatore IOleInPlaceSite .
Sintassi
HRESULT CloseView(
[in] DWORD dwReserved
);
Parametri
[in] dwReserved
Questo parametro è riservato e non può essere NULL.
Valore restituito
Questo metodo restituisce S_OK se l'operazione ha esito positivo.
Commenti
Quando una finestra separata non è più necessaria, il contenitore chiama IOleDocumentView::CloseView, in cui la visualizzazione rilascia il puntatore del sito alla finestra separata e distrugge la finestra. A differenza della normale sequenza di disattivazione sul posto per i documenti attivi, una visualizzazione documento continua a contenere il puntatore IOleInPlaceSite . Questo puntatore viene rilasciato solo quando il contenitore della visualizzazione chiama SetInPlaceSite, con pIPSite impostato su NULL o chiama IOleDocumentView::CloseView.
Quando un utente chiude la finestra separata di una visualizzazione, la visualizzazione non deve arrestarsi. Deve invece chiamare IOleInPlaceSite::OnInPlaceActivate. Il sito di visualizzazione decide quindi se chiamare IOleDocumentView::UIActivate con FALSE immediatamente o versione successiva. In questo modo, una visualizzazione documento visualizzata in una finestra separata rimane disponibile per l'attivazione nella finestra del contenitore.
Il contenitore deve chiamare questo metodo prima di eliminare la vista, ovvero rilascia l'ultimo riferimento alla vista. In generale, l'implementazione di questo metodo chiamerà IOleDocumentView::Show con FALSE per nascondere la visualizzazione se non è già nascosta, quindi chiamare SetInPlaceSite con NULL per disattivare se stesso e rilasciare il puntatore del sito di visualizzazione.
Poiché IOleDocumentView::CloseView viene chiamato quando un contenitore sta per arrestare completamente una visualizzazione, questo metodo deve essere implementato e non ha alcun motivo di errore.
Requisiti
| 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 |