IOleDocumentView::Metode CloseView (docobj.h)
Menginstruksikan tampilan dokumen untuk menutup dirinya sendiri dan melepaskan penunjuk IOleInPlaceSite-nya .
Sintaks
HRESULT CloseView(
[in] DWORD dwReserved
);
Parameter
[in] dwReserved
Parameter ini dicadangkan dan tidak boleh NULL.
Nilai kembali
Metode ini mengembalikan S_OK pada keberhasilan.
Keterangan
Ketika jendela terpisah tidak lagi diperlukan, kontainer memanggil IOleDocumentView::CloseView, di mana tampilan melepaskan penunjuk situsnya ke jendela terpisah dan menghancurkan jendela. Tidak seperti urutan pennonaktifkanan di tempat normal untuk dokumen aktif, tampilan dokumen terus menahan penunjuk IOleInPlaceSite . Pointer ini dirilis hanya ketika kontainer tampilan memanggil SetInPlaceSite, dengan pIPSite diatur ke NULL, atau memanggil IOleDocumentView::CloseView.
Saat pengguna menutup jendela terpisah tampilan, tampilan tidak boleh dimatikan sendiri. Sebaliknya, ini harus memanggil IOleInPlaceSite::OnInPlaceActivate. Situs tampilan kemudian memutuskan apakah akan memanggil IOleDocumentView::UIActivate dengan FALSE segera atau nanti. Dengan cara ini, tampilan dokumen yang ditampilkan di jendela terpisah tetap tersedia untuk aktivasi di jendela kontainer itu sendiri.
Kontainer harus memanggil metode ini sebelum menghapus tampilan, yaitu merilis referensi terakhirnya ke tampilan. Secara umum, implementasi metode ini akan memanggil IOleDocumentView::Show dengan FALSE untuk menyembunyikan tampilan jika belum disembunyikan, lalu panggil SetInPlaceSite dengan NULL untuk menonaktifkan dirinya sendiri dan melepaskan penunjuk situs tampilan.
Karena IOleDocumentView::CloseView dipanggil ketika kontainer akan sepenuhnya mematikan tampilan, metode ini harus diimplementasikan dan tidak memiliki alasan untuk gagal.
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 |