IOleInPlaceObject::InPlaceDeactivate method (oleidl.h)

Artikel
03/13/2024

Menonaktifkan objek aktif di tempat dan membuang status batalkan objek.

Sintaks

HRESULT InPlaceDeactivate();

Mengembalikan nilai

Metode ini mengembalikan S_OK pada keberhasilan. Kemungkinan nilai pengembalian lainnya termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_UNEXPECTED	Terjadi kesalahan tak terduga.

Keterangan

Catatan untuk Penelepon

Metode ini dipanggil oleh kontainer langsung objek aktif untuk menonaktifkan objek aktif dan membuang status batalkan.

Catatan untuk Pelaksana

Saat kembali dari IOleInPlaceObject::InPlaceDeactivate, objek membuang status batalkan. Aplikasi objek tidak boleh segera dimatikan setelah panggilan ini. Sebaliknya, itu harus menunggu panggilan eksplisit ke IOleObject::Close atau untuk jumlah referensi objek mencapai nol.

Sebelum menonaktifkan, aplikasi objek harus memberi kontainer kesempatan untuk menempatkan antarmuka penggunanya kembali di jendela bingkai dengan memanggil IOleInPlaceSite::OnUIDeactivate.

Jika antarmuka pengguna di tempat masih terlihat selama panggilan ke IOleInPlaceObject::InPlaceDeactivate, aplikasi objek harus memanggil metode IOleInPlaceObject::InPlaceDeactivate sendiri untuk menyembunyikan antarmuka pengguna. Antarmuka pengguna di tempat dapat dihancurkan secara opsional selama panggilan ke IOleInPlaceObject::InPlaceDeactivate dan IOleInPlaceObject::InPlaceDeactivate. Tetapi jika antarmuka pengguna belum dihancurkan ketika kontainer memanggil IOleObject::Close, maka itu harus dihancurkan selama panggilan ke IOleObject::Close.

Selama panggilan ke IOleObject::Close, objek harus memeriksa untuk melihat apakah masih aktif di tempat. Jika demikian, itu harus memanggil IOleInPlaceObject::InPlaceDeactivate.

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