Kelas CDragListBox

Selain menyediakan fungsionalitas kotak daftar Windows, CDragListBox kelas memungkinkan pengguna memindahkan item kotak daftar, seperti nama file, dalam kotak daftar.

Sintaks

class CDragListBox : public CListBox

Anggota

Konstruktor Publik

Metode Publik

Keterangan

Kotak daftar dengan kemampuan ini memungkinkan pengguna untuk memesan item dalam daftar dengan cara apa pun yang paling berguna bagi mereka. Secara default, kotak daftar akan memindahkan item ke lokasi baru dalam daftar. Namun, CDragListBox objek dapat disesuaikan untuk menyalin item alih-alih memindahkannya.

Kontrol kotak daftar yang CDragListBox terkait dengan kelas tidak boleh memiliki gaya LBS_SORT atau LBS_MULTIPLESELECT. Untuk deskripsi gaya kotak daftar, lihat Gaya Kotak Daftar.

Untuk menggunakan kotak daftar seret dalam kotak dialog aplikasi Anda yang sudah ada, tambahkan kontrol kotak daftar ke templat dialog Anda menggunakan editor dialog lalu tetapkan variabel anggota (Kategori Control dan Tipe CDragListBoxVariabel ) yang sesuai dengan kontrol kotak daftar di templat dialog Anda.

Untuk informasi selengkapnya tentang menetapkan kontrol ke variabel anggota, lihat Pintasan untuk Menentukan Variabel Anggota untuk Kontrol Dialog.

Hierarki Warisan

CObject

CCmdTarget

CWnd

CListBox

CDragListBox

Persyaratan

Header: afxcmn.h

CDragListBox::BeginDrag

Dipanggil oleh kerangka kerja ketika peristiwa terjadi yang dapat memulai operasi seret, seperti menekan tombol mouse kiri.

virtual BOOL BeginDrag(CPoint pt);

Parameter

Pt
Objek CPoint yang berisi koordinat item yang sedang diseret.

Tampilkan Nilai

Bukan nol jika menyeret diizinkan, jika tidak, 0.

Keterangan

Ambil alih fungsi ini jika Anda ingin mengontrol apa yang terjadi saat operasi seret dimulai. Implementasi default menangkap mouse dan tetap dalam mode seret hingga pengguna mengklik tombol mouse kiri atau kanan atau menekan ESC, saat operasi seret dibatalkan.

CDragListBox::CancelDrag

Dipanggil oleh kerangka kerja ketika operasi seret telah dibatalkan.

virtual void CancelDrag(CPoint pt);

Parameter

Pt
Objek CPoint yang berisi koordinat item yang sedang diseret.

Keterangan

Ambil alih fungsi ini untuk menangani pemrosesan khusus untuk kontrol kotak daftar Anda.

CDragListBox::CDragListBox

Membuat CDragListBox objek.

CDragListBox();

CDragListBox::D ragging

Dipanggil oleh kerangka kerja saat item kotak daftar sedang diseret di dalam CDragListBox objek.

virtual UINT Dragging(CPoint pt);

Parameter

Pt
Objek CPoint yang berisi koordinat layar x dan y dari kursor.

Tampilkan Nilai

ID sumber daya kursor yang akan ditampilkan. Nilai berikut dimungkinkan:

• DL_COPYCURSOR Menunjukkan bahwa item akan disalin.

• DL_MOVECURSOR Menunjukkan bahwa item akan dipindahkan.

• DL_STOPCURSOR Menunjukkan bahwa target penurunan saat ini tidak dapat diterima.

Keterangan

Perilaku default mengembalikan DL_MOVECURSOR. Ambil alih fungsi ini jika Anda ingin menyediakan fungsionalitas tambahan.

CDragListBox::D rawInsert

Dipanggil oleh kerangka kerja untuk menggambar panduan penyisipan sebelum item dengan indeks yang ditunjukkan.

virtual void DrawInsert(int nItem);

Parameter

nItem
Indeks berbasis nol dari titik penyisipan.

Keterangan

Nilai - 1 menghapus panduan penyisipan. Ambil alih fungsi ini untuk mengubah tampilan atau perilaku panduan penyisipan.

CDragListBox::D ropped

Dipanggil oleh kerangka kerja saat item dihilangkan dalam CDragListBox objek.

virtual void Dropped(
    int nSrcIndex,
    CPoint pt);

Parameter

nSrcIndex
Menentukan indeks berbasis nol dari string yang dihilangkan.

Pt
Objek CPoint yang berisi koordinat situs penghilangan.

Keterangan

Perilaku default menyalin item kotak daftar dan datanya ke lokasi baru lalu menghapus item asli. Ambil alih fungsi ini untuk menyesuaikan perilaku default, seperti mengaktifkan salinan item kotak daftar untuk diseret ke lokasi lain dalam daftar.

CDragListBox::ItemFromPt

Panggil fungsi ini untuk mengambil indeks berbasis nol dari item kotak daftar yang terletak di pt.

int ItemFromPt(
    CPoint pt,
    BOOL bAutoScroll = TRUE) const;

Parameter

Pt
Objek CPoint yang berisi koordinat titik dalam kotak daftar.

bAutoScroll
Bukan nol jika pengguliran diizinkan, jika tidak, 0.

Tampilkan Nilai

Indeks berbasis nol dari item kotak daftar seret.

Lihat juga

TSTCON Sampel MFC
Kelas CListBox
Bagan Hierarki
Kelas CListBox