Método IOleDocumentView::CloseView (docobj.h)

  • Artículo

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

Consulte también

IOleDocumentView

IOleDocumentView::SetInPlaceSite

IOleDocumentView::Show