IOleDocumentView::Metode buka (docobj.h)

Artikel
08/23/2023

Menampilkan tampilan dokumen dalam jendela pop-up terpisah. Semantik setara dengan IOleObject::D oVerb dengan OLEIVERB_OPEN.

Sintaks

HRESULT Open();

Mengembalikan nilai

Metode ini mengembalikan S_OK pada keberhasilan. Kemungkinan nilai pengembalian lainnya termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_FAIL	Operasi gagal.
E_OUTOFMEMORY	Tidak tersedia cukup memori untuk operasi ini.
E_UNEXPECTED	Terjadi kesalahan tak terduga.
E_NOTIMPL	Objek dokumen yang memiliki tampilan ini tidak mendukung aktivasi jendela terpisah.

Keterangan

Pengguna yang melihat objek dokumen dalam aplikasi kontainer seperti browser atau "pengikat" mungkin ingin melihat dua atau beberapa tampilan atau dokumen sekaligus. Karena browser hanya menampilkan satu tampilan pada satu waktu, kontainer memerlukan cara untuk meminta tampilan atau dokumen lain untuk ditampilkan sendiri, sesuai kebutuhan, di jendela terpisah. Metode IOleDocumentView::Open menyediakan cara tersebut.

Catatan untuk Penelepon

Panggilan yang berhasil ke IOleDocumentView::Open harus diikuti dengan panggilan ke IOleDocumentView::Show untuk menyembunyikan jendela atau untuk menampilkan jendela dan membawanya ke latar depan. Saat tampilan aktif di jendela terpisah, kontainer dapat menampilkan atau menyembunyikan jendela sebanyak yang mungkin diperlukan.

Catatan untuk Pelaksana

Objek dokumen menunjukkan bahwa objek tersebut tidak mendukung aktivasi di jendela terpisah dengan mengatur bendera status DOCMISC_CANTOPENEDIT dan mengembalikan E_NOTIMPL ke kontainer yang memanggil metode ini.

Implementasi terutama terdiri dari objek tampilan yang memanggil metode IOleInPlaceObject::InPlaceDeactivate sendiri, yang meninggalkan objek dokumen dalam keadaan berjalan tetapi tanpa aktivasi di tempat. Antarmuka pengguna objek dokumen tidak terlihat sampai kontainer memanggil IOleDocumentView::Show (lihat Catatan untuk Penelepon di atas).

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