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 |
|---|---|
|
Operazione non riuscita. |
|
Il valore in ppViewNew è NULL. |
|
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 |