IOleDocument::Metode CreateView (docobj.h)

Artikel
02/26/2024

Membuat objek tampilan dokumen dalam proses pemanggil dan mendapatkan penunjuk ke antarmuka IOleDocumentView objek tersebut.

Sintaks

HRESULT CreateView(
  [in]  IOleInPlaceSite  *pIPSite,
  [in]  IStream          *pstm,
  [in]  DWORD            dwReserved,
  [out] IOleDocumentView **ppView
);

Parameter

[in] pIPSite

Penunjuk ke antarmuka IOleInPlaceSite yang mewakili objek situs tampilan yang akan dikaitkan dengan objek tampilan dokumen baru. Parameter ini dapat berupa NULL, misalnya, ketika tampilan terkandung dalam objek dokumen baru yang tidak diinisialisasi, dalam hal ini pemanggil harus menginisialisasi tampilan dengan panggilan berikutnya ke IOleDocumentView::SetInPlaceSite.

[in] pstm

Penunjuk ke aliran yang berisi data tempat objek tampilan dokumen baru harus diinisialisasi sendiri. Jika NULL, objek dokumen menginisialisasi objek tampilan dokumen baru dengan status default.

[in] dwReserved

Parameter ini dicadangkan dan harus nol.

[out] ppView

Penunjuk ke variabel penunjuk IOleDocumentView yang menerima penunjuk antarmuka ke objek tampilan dokumen baru. Ketika berhasil, penelepon bertanggung jawab untuk memanggil IUnknown::Release pada pointer ppview ketika objek tampilan tidak lagi diperlukan.

Nilai kembali

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

Menampilkan kode	Deskripsi
E_FAIL	Operasi gagal.
E_OUTOFMEMORY	Tidak cukup memori yang tersedia untuk operasi.
E_UNEXPECTED	Terjadi kesalahan tidak terduga.
E_POINTER	Alamat di ppView adalah NULL.

Keterangan

Situs dokumen kontainer objek dokumen memanggil CreateView untuk menginstruksikan objek dokumen untuk membuat tampilan baru dirinya sendiri dalam proses kontainer, baik dari data default atau menggunakan konten aliran yang ada.

Memanggil CreateView tidak menyebabkan tampilan baru ditampilkan sendiri. Untuk melakukannya, memerlukan panggilan ke IOleDocumentView::Show atau IOleDocumentView::UIActivate.

Persyaratan

Persyaratan	Nilai
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