Metode IOleInPlaceObject::UIDeactivate (oleidl.h)

Artikel
08/25/2023

Menonaktifkan dan menghapus antarmuka pengguna dari objek aktif di tempat.

Sintaks

HRESULT UIDeactivate();

Mengembalikan nilai

Metode ini mengembalikan S_OK pada keberhasilan. Nilai pengembalian lain yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_UNEXPECTED	Terjadi kesalahan tidak terduga.

Keterangan

Catatan untuk Penelepon

Metode ini dipanggil oleh kontainer langsung objek ketika, misalnya, pengguna telah mengklik di area klien di luar objek.

Jika kontainer telah memanggil IOleInPlaceObject::UIDeactivate, kontainer nanti harus memanggil IOleInPlaceObject::InPlaceDeactivate untuk membersihkan sumber daya dengan benar. Kontainer dapat mengasumsikan bahwa menghentikan atau merilis objek membersihkan sumber daya jika perlu. Objek harus siap untuk melakukannya jika IOleInPlaceObject::InPlaceDeactivate belum dipanggil. tetapi IOleInPlaceObject::UIDeactivate atau IOleObject::Close telah dipanggil.

Catatan untuk Pelaksana

Sumber daya seperti menu dan jendela dapat dibersihkan atau disimpan dalam keadaan tersembunyi hingga objek Anda benar-benar dinonaktifkan oleh panggilan ke IOleInPlaceObject::InPlaceDeactivate atau IOleObject::Close. Aplikasi objek harus memanggil IOleInPlaceSite::OnUIDeactivate sebelum melakukan apa pun dengan menu komposit sehingga kontainer dapat terlebih dahulu dilepas dari jendela bingkai. Saat menonaktifkan antarmuka pengguna objek di tempat, objek dibiarkan dalam keadaan siap sehingga dapat diaktifkan kembali dengan cepat. Objek tetap dalam status ini hingga status batalkan dokumen berubah. Kontainer kemudian harus memanggil IOleInPlaceObject::InPlaceDeactivate untuk memberi tahu objek untuk membuang status batalkan.

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