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

  • Artículo

Crea un objeto de vista duplicado con un estado interno idéntico al de la vista actual.

Sintaxis

HRESULT Clone(
  [in]  IOleInPlaceSite  *pIPSiteNew,
  [out] IOleDocumentView **ppViewNew
);

Parámetros

[in] pIPSiteNew

Puntero a una interfaz IOleInPlaceSite que representa el sitio de vista en el que se activará el nuevo objeto de vista. Al recibir este puntero, la vista que se va a clonar debe pasarla al método IOleDocumentView::SetInPlaceSite de la nueva vista. Este puntero puede ser NULL, en cuyo caso el autor de la llamada es responsable de llamar a IOleDocumentView::SetInPlaceSite en la nueva vista directamente.

[out] ppViewNew

Puntero a una variable de puntero IOleDocumentView que recibe el puntero de interfaz al nuevo objeto de vista. El autor de la llamada es responsable de liberar ppViewNew cuando 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_POINTER
 El valor de ppViewNew es NULL.
E_NOTIMPL
 El objeto view no implementa esta interfaz.

Comentarios

Este método es útil para crear una nueva vista con una ventanilla y un sitio de vista diferente, pero con el mismo contexto de vista que la vista que se clona. Normalmente, los contenedores que hospedan una aplicación MDI llamarán a este método para proporcionar la funcionalidad "Ventana/Nueva ventana".

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