Método IOleDocumentView::CloseView (docobj.h)
Indica a una vista de documento que se cierre y suelte su puntero IOleInPlaceSite .
Sintaxis
HRESULT CloseView(
[in] DWORD dwReserved
);
Parámetros
[in] dwReserved
Este parámetro está reservado y no puede ser NULL.
Valor devuelto
Este método devuelve S_OK cuando funciona correctamente.
Comentarios
Cuando ya no se necesita una ventana independiente, el contenedor llama a IOleDocumentView::CloseView, donde la vista libera su puntero de sitio a la ventana independiente y destruye la ventana. A diferencia de la secuencia de desactivación local normal para los documentos activos, una vista de documento continúa manteniendo el puntero IOleInPlaceSite . Este puntero solo se libera cuando el contenedor de la vista llama a SetInPlaceSite, con pIPSite establecido en NULL o llama a IOleDocumentView::CloseView.
Cuando un usuario cierra la ventana independiente de una vista, la vista no se debe apagar. En su lugar, debe llamar a IOleInPlaceSite::OnInPlaceActivate. A continuación, el sitio de vista decide si llamar a IOleDocumentView::UIActivate con FALSE inmediatamente o posterior. De este modo, una vista de documento mostrada en una ventana independiente permanece disponible para la activación en la ventana propia del contenedor.
El contenedor debe llamar a este método antes de eliminar la vista, es decir, libera su última referencia a la vista. En general, la implementación de este método llamará a IOleDocumentView::Show con FALSE para ocultar la vista si aún no está oculta, luego llamará a SetInPlaceSite con NULL para desactivarse y liberar el puntero del sitio de vista.
Dado que se llama a IOleDocumentView::CloseView cuando un contenedor va a apagar completamente una vista, este método debe implementarse y no tiene ninguna razón para producir un error.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | docobj.h |