Enumerasi POINTERINACTIVE (ocidl.h)

Artikel
03/08/2023

Tunjukkan kebijakan aktivasi objek dan digunakan dalam metode IPointerInactive::GetActivationPolicy .

Sintaks

typedef enum tagPOINTERINACTIVE {
  POINTERINACTIVE_ACTIVATEONENTRY = 1,
  POINTERINACTIVE_DEACTIVATEONLEAVE = 2,
  POINTERINACTIVE_ACTIVATEONDRAG = 4
} POINTERINACTIVE;

Konstanta


`POINTERINACTIVE_ACTIVATEONENTRY` Nilai: 1 Objek harus diaktifkan di tempat ketika mouse memasukinya selama operasi pemindahan mouse.
`POINTERINACTIVE_DEACTIVATEONLEAVE` Nilai: 2 Objek harus dinonaktifkan ketika mouse meninggalkan objek selama operasi pemindahan mouse.
`POINTERINACTIVE_ACTIVATEONDRAG` Nilai: 4 Objek harus diaktifkan di tempat ketika mouse diseret di atasnya selama operasi seret dan letakkan.

Keterangan

Untuk informasi selengkapnya tentang menggunakan nilai POINTERINACTIVE_ACTIVATEONENTRY dan POINTERINACTIVE_DEACTIVATEONLEAVE , lihat metode IPointerInactive::GetActivationPolicy .

Nilai POINTERINACTIVE_ACTIVATEONDRAG dapat digunakan untuk mendukung operasi seret dan letakkan pada objek yang tidak aktif. Objek yang tidak aktif tidak memiliki jendela untuk mendaftarkan dirinya sebagai target penurunan potensial. Sebagian besar kontainer mengabaikan objek yang disematkan dan tidak aktif sebagai target penurunan karena overhead yang terkait dengan pengaktifannya.

Sebagai alternatif untuk mengaktifkan objek ketika penunjuk mouse berada di atasnya selama operasi seret dan letakkan, kontainer dapat terlebih dahulu QueryInterface untuk menentukan apakah objek yang tidak aktif mendukung IPointerInactive. Kemudian, jika objek tidak mendukung IPointerInactive, kontainer dapat mengasumsikan bahwa itu bukan target penurunan. Jika objek mendukung IPointerInactive, kontainer memanggil metode IPointerInactive::GetActivationPolicy . Jika nilai POINTERINACTIVE_ACTIVATEONDRAG diatur, kontainer mengaktifkan objek di tempat sehingga objek dapat mendaftarkan antarmuka IDropTarget sendiri.

Kontainer sedang memproses metode IDropTarget::D ragOver sendiri ketika semua tindakan ini terjadi. Untuk menyelesaikan metode tersebut, kontainer mengembalikan DROPEFFECT_NONE untuk parameter pdwEffect . Kemudian, operasi seret dan letakkan berlanjut dengan memanggil IDropTarget::D ragLeave kontainer dan kemudian memanggil IDropTarget::D ragEnter objek.

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

Jika penurunan terjadi pada objek yang disematkan, objek diaktifkan UI dan akan dinonaktifkan UI saat fokus berubah lagi. Jika penurunan tidak terjadi pada objek, kontainer harus menonaktifkan objek saat berikutnya mendapat panggilan ke IDropTarget::D ragEnter sendiri. Dimungkinkan bagi penurunan terjadi pada objek aktif ketiga tanpa mengintervensi panggilan ke IDropTarget::D ragEnter kontainer. Dalam hal ini, kontainer harus mencoba menonaktifkan objek sesegera mungkin, misalnya, ketika UI mengaktifkan objek lain.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	ocidl.h

Lihat juga

IDropTarget

IPointerInactive

IPointerInactive::GetActivationPolicy

Bagikan melalui