Metode IOleInPlaceActiveObject::OnDocWindowActivate (oleidl.h)

Artikel
03/01/2024

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