Método IOleDocument::CreateView (docobj.h)

Artículo
02/26/2024

Crea un objeto de vista de documento en el proceso del autor de la llamada y obtiene un puntero a la interfaz IOleDocumentView de ese objeto.

Sintaxis

HRESULT CreateView(
  [in]  IOleInPlaceSite  *pIPSite,
  [in]  IStream          *pstm,
  [in]  DWORD            dwReserved,
  [out] IOleDocumentView **ppView
);

Parámetros

[in] pIPSite

Puntero a la interfaz IOleInPlaceSite que representa el objeto de sitio de vista que se va a asociar al nuevo objeto de vista de documento. Este parámetro puede ser NULL, por ejemplo, cuando la vista está contenida en un nuevo objeto de documento sin inicializar, en cuyo caso el autor de la llamada debe inicializar la vista con una llamada posterior a IOleDocumentView::SetInPlaceSite.

[in] pstm

Puntero a una secuencia que contiene datos desde los que el nuevo objeto de vista de documento debe inicializarse. Si es NULL, el objeto de documento inicializa el nuevo objeto de vista de documento con un estado predeterminado.

[in] dwReserved

Este parámetro está reservado y debe ser cero.

[out] ppView

Puntero a una variable de puntero IOleDocumentView que recibe el puntero de interfaz al nuevo objeto de vista de documento. Cuando se ejecuta correctamente, el autor de la llamada es responsable de llamar a IUnknown::Release en el puntero ppview cuando el objeto de vista ya no es necesario.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto	Descripción
E_FAIL	Error en la operación.
E_OUTOFMEMORY	Memoria insuficiente disponible para la operación.
E_UNEXPECTED	Se produjo un error inesperado.
E_POINTER	La dirección de ppView es NULL.

Comentarios

Un sitio de documento del contenedor de objetos de documento llama a CreateView para indicar a un objeto de documento que cree una nueva vista de sí misma en el proceso del contenedor, ya sea a partir de datos predeterminados o mediante el contenido de una secuencia existente.

Llamar a CreateView no hace que la nueva vista se muestre a sí misma. Para ello, se requiere una llamada a IOleDocumentView::Show o IOleDocumentView::UIActivate.

Requisitos

Requisito	Value
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