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
E_FAIL	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

Lihat juga

IOleDocumentView

IOleDocumentView::SetInPlaceSite