Metode IOleInPlaceSiteEx::OnInPlaceActivateEx (ocidl.h)

Artikel
02/29/2024

Dipanggil oleh objek yang disematkan untuk menentukan apakah perlu menggambar ulang dirinya sendiri setelah aktivasi.

Sintaks

HRESULT OnInPlaceActivateEx(
  [out] BOOL  *pfNoRedraw,
  [in]  DWORD dwFlags
);

Parameter

[out] pfNoRedraw

Penunjuk ke variabel yang menerima status penggalian ulang saat ini. Statusnya TRUE jika objek tidak perlu digambar ulang sendiri setelah aktivasi dan FALSE sebaliknya. Objek tanpa jendela biasanya tidak memerlukan nilai yang dikembalikan oleh parameter ini dan dapat melewati penunjuk NULL untuk menyimpan kontainer beban komputasi nilai ini.

[in] dwFlags

Menunjukkan apakah objek diaktifkan sebagai objek tanpa jendela. Parameter ini mengambil nilai dari enumerasi ACTIVATEFLAGS . Lihat IOleInPlaceSiteWindowless untuk informasi selengkapnya tentang objek tanpa jendela.

Nilai kembali

Metode ini mengembalikan S_OK jika kontainer mengizinkan aktivasi di tempat. Kemungkinan nilai pengembalian lainnya termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_UNEXPECTED	Terjadi kesalahan tidak terduga.

Keterangan

Metode ini menggantikan IOleInPlaceSite::OnInPlaceActivate. Jika metode yang lebih lama digunakan, objek harus selalu menggambar ulang dirinya sendiri pada aktivasi.

Objek tanpa jendela diperlukan untuk menggunakan metode ini alih-alih IOleInPlaceSite::OnInPlaceActivate untuk memberi tahu kontainer apakah mereka mengaktifkan tanpa jendela atau tidak.

Catatan untuk Pelaksana

Kontainer harus hati-hati memeriksa status pembatalan objek, urutan z, kliping, dan parameter relevan lainnya untuk menentukan nilai yang sesuai untuk dikembalikan dalam pfNoRedraw.

Kontainer dapat menyimpan nilai enumerasi ACTIVATEFLAGS alih-alih memanggil metode GetWindow di antarmuka IOleInPlaceObjectWindowless berulang kali.

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	ocidl.h