Metodo IOleDocumentView::Clone (docobj.h)

Crea un oggetto visualizzazione duplicato con uno stato interno identico a quello della visualizzazione corrente.

Sintassi

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

Parametri

[in] pIPSiteNew

Puntatore a un'interfaccia IOleInPlaceSite che rappresenta il sito di visualizzazione in cui verrà attivato il nuovo oggetto visualizzazione. Quando riceve questo puntatore, la visualizzazione clonata deve passarla al metodo IOleDocumentView::SetInPlaceSite della nuova visualizzazione. Questo puntatore può essere NULL, nel qual caso il chiamante è responsabile della chiamata diretta di IOleDocumentView::SetInPlaceSite .

[out] ppViewNew

Puntatore a una variabile puntatore IOleDocumentView che riceve il puntatore dell'interfaccia al nuovo oggetto visualizzazione. Il chiamante è responsabile del rilascio di ppViewNew quando non è più necessario.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
E_FAIL	Operazione non riuscita.
E_POINTER	Il valore in ppViewNew è NULL.
E_NOTIMPL	L'oggetto view non implementa questa interfaccia.

Commenti

Questo metodo è utile per creare una nuova visualizzazione con un viewport e un sito di visualizzazione diversi, ma con lo stesso contesto di visualizzazione della vista clonata. In genere, i contenitori che ospitano un'applicazione MDI chiameranno questo metodo per fornire la funzionalità "Finestra/Nuova finestra".

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	docobj.h

Vedi anche

IOleDocumentView

IOleDocumentView::SetInPlaceSite