Bagikan melalui

Enumerasi POINTERINACTIVE (ocidl.h)

  • Artikel

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