IOleDocumentSite::ActivateMe method (docobj.h)
Meminta situs dokumen untuk mengaktifkan dokumen yang melakukan panggilan sebagai objek dokumen daripada objek yang aktif di tempat dan, secara opsional, menentukan tampilan dokumen objek mana yang akan diaktifkan.
Sintaks
HRESULT ActivateMe(
[in] IOleDocumentView *pViewToActivate
);
Parameter
[in] pViewToActivate
Penunjuk ke penunjuk antarmuka IOleDocumentView yang mewakili tampilan dokumen yang akan digunakan dalam mengaktifkan objek dokumen. Parameter ini bisa NULL, dalam hal ini kontainer harus memanggil IOleDocument::CreateView untuk mendapatkan penunjuk tampilan dokumen.
Nilai kembali
Metode ini mengembalikan S_OK pada keberhasilan.
Keterangan
Saat kontainer memanggil IOleObject::D oVerb untuk mengaktifkan dokumen, objek dokumen melewati urutan aktivasi di tempat yang biasa dengan memanggil IOleDocumentSite::ActivateMe.
Saat memanggil IOleObject::D oVerb pada objek dokumen, kata kerja aktivasi yang paling tepat biasanya OLEIVERB_SHOW. Kata kerja lain yang diizinkan termasuk OLEIVERB_PRIMARY dan OLEIVERB_UIACTIVATE. OLEIVERB_OPEN tidak disarankan karena itu berarti membuka objek yang disematkan di jendela terpisah, yang bertentangan dengan niat aktivasi objek dokumen.
Catatan untuk Penelepon
Hanya objek dokumen yang harus memanggil metode ini. Dokumen aktif di tempat normal harus merespons panggilan kontainer ke IOleObject::D oVerb dengan memanggil IOleInPlaceSite.Objek dokumen harus memulai aktivasinya dengan memanggil IOleDocumentSite::ActivateMe. Jika kontainer tidak mengimplementasikan IOleDocumentSite, maka dokumen harus default ke urutan aktivasi normal di tempat.
Objek dokumen yang mendukung lebih dari satu tampilan datanya dapat menentukan tampilan mana yang akan diaktifkan dengan meneruskan penunjuk ke antarmuka IOleDocumentView tampilan tersebut di pViewToActivate.
Namun penunjuk IOleDocumentView diperoleh, kontainer harus melepaskan pointer ketika tidak lagi diperlukan.
Catatan untuk Pelaksana
Fungsi ini harus sepenuhnya diimplementasikan dalam kontainer objek dokumen; E_NOTIMPL bukan nilai pengembalian yang dapat diterima.Jika objek dokumen melewati penunjuk IOleDocumentView di pViewToActivate, implementasi kontainer IOleDocumentSite::ActivateMe harus memanggil IOleDocumentView::SetInPlaceSite dan meneruskan penunjuk ke antarmuka IOleInPlaceSite-nya kembali ke objek tampilan. Jika kontainer memegang pointer IOleDocumentView , yang biasanya akan terjadi, kontainer harus mengikuti panggilan ke IOleDocumentView::SetInPlaceSite dengan panggilan ke IUnknown::AddRef.
Jika pViewToActivateADALAH NULL, kontainer dapat memperoleh penunjuk ke tampilan dokumen dengan mengkueri dokumen untuk IOleDocument, lalu memanggil IOleDocument::CreateView dan meneruskan penunjuk IOleInPlaceSite-nya .
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 |