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 |
|---|---|
|
Falha na operação. |
|
O valor em ppViewNew é NULL. |
|
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 |