Metode IOleInPlaceActiveObject::OnDocWindowActivate (oleidl.h)
Memberi tahu objek aktif di tempat saat jendela dokumen kontainer diaktifkan atau dinonaktifkan.
Sintaks
HRESULT OnDocWindowActivate(
[in] BOOL fActivate
);
Parameter
[in] fActivate
Status jendela dokumen anak MDI. Jika parameter ini TRUE, jendela sedang dalam tindakan mengaktifkan; jika FALSE, itu adalah tindakan penonaktifan.
Nilai kembali
Metode ini mengembalikan S_OK pada keberhasilan.
Keterangan
Catatan untuk Penelepon
Panggil IOleInPlaceActiveObject::OnDocWindowActivate saat jendela dokumen anak MDI diaktifkan atau dinonaktifkan dan objek saat ini adalah objek aktif untuk dokumen.Catatan untuk Pelaksana
Anda harus menyertakan kode dalam metode ini yang menginstal alat tingkat bingkai selama aktivasi objek. Alat-alat ini termasuk menu komposit bersama dan/atau toolbar opsional dan hiasan bingkai. Anda kemudian harus mengambil fokus. Saat menonaktifkan, objek harus menghapus alat tingkat bingkai. Perhatikan bahwa jika Anda tidak memanggil IOleInPlaceUIWindow::SetBorderSpace dengan pborderwidths diatur ke NULL, Anda dapat menghindari harus menegosiasikan ulang ruang batas.Saat menjalankan IOleInPlaceActiveObject::OnDocWindowActivate, jangan melakukan panggilan ke fungsi PeekMessage atau GetMessage , atau kotak dialog. Melakukannya dapat menyebabkan kebuntuan sistem. Ada pembatasan lebih lanjut di mana metode dan fungsi antarmuka OLE dapat dipanggil dari dalam IOleInPlaceActiveObject::OnDocWindowActivate.
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 |