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

Cria um objeto de exibição duplicado com um estado interno idêntico ao da exibição atual.

Sintaxe

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

Parâmetros

[in] pIPSiteNew

Um ponteiro para uma interface IOleInPlaceSite que representa o site de exibição no qual o novo objeto de exibição será ativado. Ao receber esse ponteiro, a exibição que está sendo clonada deve passá-la para o método IOleDocumentView::SetInPlaceSite da nova exibição . Esse ponteiro pode ser NULL, nesse caso, o chamador é responsável por chamar IOleDocumentView::SetInPlaceSite diretamente na nova exibição.

[out] ppViewNew

Um ponteiro para uma variável de ponteiro IOleDocumentView que recebe o ponteiro de interface para o novo objeto de exibição. O chamador é responsável por liberar ppViewNew quando ele não for mais necessário.

Valor retornado

Esse método retorna S_OK com êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno	Descrição
E_FAIL	Falha na operação.
E_POINTER	O valor em ppViewNew é NULL.
E_NOTIMPL	O objeto view não implementa essa interface.

Comentários

Esse método é útil para criar um novo modo de exibição com um visor e um site de exibição diferentes, mas com o mesmo contexto de exibição que o modo de exibição que está sendo clonado. Normalmente, os contêineres que hospedam um aplicativo MDI chamarão esse método para fornecer a funcionalidade "Janela/Nova janela".

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	docobj.h

Confira também

Ioledocumentview

IOleDocumentView::SetInPlaceSite