Share via

Metode IPointerInactive::GetActivationPolicy (ocidl.h)

  • Artikel

Mengambil kebijakan aktivasi saat ini untuk objek . Metode ini dipanggil oleh kontainer pada penerimaan pesan WM_SETCURSOR atau WM_MOUSEMOVE ketika objek tidak aktif berada di bawah penunjuk mouse.

Sintaks

HRESULT GetActivationPolicy(
  [out] DWORD *pdwPolicy
);

Parameter

[out] pdwPolicy

Penunjuk ke variabel yang menerima kebijakan aktivasi. Nilai yang mungkin berasal dari enumerasi POINTERINACTIVE .

Mengembalikan nilai

Jika metode berhasil, nilai yang dikembalikan S_OK. Jika tidak, itu E_FAIL.

Keterangan

Objek dapat meminta untuk diaktifkan di tempat segera setelah mouse memasukkannya melalui nilai POINTERINACTIVE_ACTIVATEONENTRY. Objek yang memberikan lebih banyak umpan balik visual daripada hanya mengatur penunjuk mouse akan menggunakan nilai ini. Misalnya, jika objek mendukung umpan balik visual khusus, objek harus memasuki status aktif sehingga dapat menarik umpan balik visual yang didukungnya.

Objek juga dapat menggunakan metode ini untuk meminta aktivasi saat mouse diseret ke atasnya selama operasi seret dan letakkan melalui POINTERINACTIVE_ACTIVATEONDRAG.

Jika objek mengembalikan salah satu nilai ini, kontainer harus segera mengaktifkan objek dan meneruskan pesan Jendela yang memicu panggilan. Objek kemudian tetap aktif dan memproses pesan berikutnya melalui jendelanya sendiri sampai kontainer mendapatkan WM_SETCURSOR atau WM_MOUSEMOVE lain. Pada titik ini, kontainer harus menonaktifkan objek .

Untuk objek OLE tanpa jendela, mekanisme ini sedikit berbeda. Lihat IOleInPlaceSiteWindowless untuk informasi selengkapnya tentang operasi seret dan letakkan untuk objek tanpa jendela.

Jika objek mengembalikan nilai POINTERINACTIVE_ACTIVATEONENTRY dan POINTERINACTIVE_DEACTIVATEONLEAVE, objek diaktifkan hanya saat mouse berada di atas objek. Jika nilai POINTERINACTIVE_ACTIVATEONENTRY saja diatur, objek diaktifkan sekali saat mouse pertama kali memasukkannya, dan tetap aktif.

Catatan untuk Penelepon

Kebijakan aktivasi tidak boleh di-cache. Kontainer harus memanggil metode ini setiap kali mouse memasuki objek yang tidak aktif.

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

Lihat juga

IOleInPlaceSiteWindowless

IPointerInactive