Metode IOleDocumentView::SetInPlaceSite (docobj.h)
Mengaitkan situs tampilan dokumen kontainer dengan objek tampilan dokumen.
Sintaks
HRESULT SetInPlaceSite(
[in] IOleInPlaceSite *pIPSite
);
Parameter
[in] pIPSite
Penunjuk ke antarmuka IOleInPlaceSite situs tampilan dokumen. Parameter ini bisa NULL, dalam hal ini objek tampilan dokumen kehilangan semua asosiasi dengan kontainer.
Nilai kembali
Metode ini mengembalikan S_OK jika situs tampilan dokumen berhasil dikaitkan (atau dikaitkan jika pIPSiteNULL) dengan objek tampilan dokumen. Kemungkinan nilai pengembalian lainnya termasuk yang berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Operasi gagal. |
Keterangan
Sebagai bagian dari mengaktifkan objek dokumen, kontainer harus meneruskan objek penunjuk ke implementasi kontainer IOleInPlaceSite. Penunjuk ini menunjuk situs tampilan dokumen yang akan dikaitkan dengan tampilan di mana metode ini dipanggil.
Kontainer biasanya meneruskan penunjuk ini sebagai respons terhadap permintaan dokumen yang akan diaktifkan. Dokumen membuat permintaan tersebut dengan memanggil IOleDocumentSite::ActivateMe dan meneruskan kontainer ke tampilan untuk diaktifkan. Kontainer, pada gilirannya, menggunakan penunjuk ini untuk memanggil IOleDocumentView::SetInPlaceSite.
Catatan untuk Penelepon
Jika kontainer meminta pembuatan dan aktivasi instans baru objek dokumen, bukan hanya aktivasi instans objek dokumen yang dimuat, situs tampilan diteruskan dalam argumen pIPSiteIOleDocument::CreateView. Oleh karena itu, panggilan eksplisit ke IOleDocumentView::SetInPlaceSite tidak perlu.Catatan untuk Pelaksana
Jika metode ini dipanggil pada tampilan yang sudah terkait dengan situs tampilan, tampilan harus melakukan beberapa housekeeping sebagai persiapan untuk mengaktifkan dirinya sendiri di situs baru. Pertama, tampilan harus menonaktifkan dirinya sendiri di situs saat ini dan melepaskan penunjuknya ke situs tersebut. Selanjutnya, jika penunjuk IOleInPlaceSite baru bukan NULL, tampilan harus menyimpan pointer dan memanggil IUnknown::AddRef di dalamnya. Tampilan kemudian harus menunggu kontainer untuk memberi tahu kapan mengaktifkannya sendiri di situs tampilan baru.Tampilan dokumen harus menerapkan metode ini sepenuhnya; E_NOTIMPL bukan nilai pengembalian yang dapat diterima.
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 |