IOleDocumentView::Metode kloning (docobj.h)

Artikel
08/23/2023

Membuat objek tampilan duplikat dengan status internal yang identik dengan tampilan saat ini.

Sintaks

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

Parameter

[in] pIPSiteNew

Penunjuk ke antarmuka IOleInPlaceSite yang mewakili situs tampilan tempat objek tampilan baru akan diaktifkan. Saat menerima pointer ini, tampilan yang sedang dikloning harus meneruskannya ke metode IOleDocumentView::SetInPlaceSite tampilan baru. Penunjuk ini bisa NULL, dalam hal ini pemanggil bertanggung jawab untuk memanggil IOleDocumentView::SetInPlaceSite pada tampilan baru secara langsung.

[out] ppViewNew

Penunjuk ke variabel penunjuk IOleDocumentView yang menerima penunjuk antarmuka ke objek tampilan baru. Pemanggil bertanggung jawab untuk merilis ppViewNew ketika tidak lagi diperlukan.

Menampilkan nilai

Metode ini mengembalikan S_OK pada keberhasilan. Nilai pengembalian lain yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_FAIL	Operasi gagal.
E_POINTER	Nilai dalam ppViewNew adalah NULL.
E_NOTIMPL	Objek tampilan tidak mengimplementasikan antarmuka ini.

Keterangan

Metode ini berguna untuk membuat tampilan baru dengan viewport yang berbeda dan melihat situs tetapi dengan konteks tampilan yang sama dengan tampilan yang dikloning. Biasanya, kontainer yang menghosting aplikasi MDI akan memanggil metode ini untuk menyediakan kemampuan "Jendela/Jendela baru".

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	docobj.h

Lihat juga

IOleDocumentView

IOleDocumentView::SetInPlaceSite

Bagikan melalui