CDragListBox Sınıfı

Sınıfı, Windows liste kutusunun işlevselliğini sağlamanın yanı sıra, CDragListBox kullanıcının liste kutusu içinde dosya adları gibi liste kutusu öğelerini taşımasına da olanak tanır.

Sözdizimi

class CDragListBox : public CListBox

Üyeler

Ortak Oluşturucular

Ad	Tanım
CDragListBox::CDragListBox	Bir CDragListBox nesne oluşturur.

Genel Yöntemler

Ad	Tanım
CDragListBox::BeginDrag	Sürükleme işlemi başladığında çerçeve tarafından çağrılır.
CDragListBox::Canceldrag	Bir sürükleme işlemi iptal edildiğinde çerçeve tarafından çağrılır.
CDragListBox::D ragging	Bir sürükleme işlemi sırasında çerçeve tarafından çağrılır.
CDragListBox::D rawInsert	Sürükleme listesi kutusunun ekleme kılavuzunu çizer.
CDragListBox::D ropped	Öğe bırakıldıktan sonra çerçeve tarafından çağrılır.
CDragListBox::ItemFromPt	Sürüklenen öğenin koordinatlarını döndürür.

Açıklamalar

Bu özelliğe sahip liste kutuları, kullanıcıların listedeki öğeleri kendileri için en yararlı olacak şekilde sıralamasını sağlar. Varsayılan olarak, liste kutusu öğeyi listedeki yeni konuma taşır. Ancak, CDragListBox nesneler öğeleri taşımak yerine kopyalamak için özelleştirilebilir.

Sınıfla ilişkilendirilmiş liste kutusu denetiminin CDragListBox LBS_SORT veya LBS_MULTIPLESELECT stili olmamalıdır. Liste kutusu stillerinin açıklaması için bkz . Liste Kutusu Stilleri.

Uygulamanızın var olan bir iletişim kutusunda sürükleme listesi kutusu kullanmak için, iletişim kutusu düzenleyicisini kullanarak iletişim kutusu şablonunuza bir liste kutusu denetimi ekleyin ve ardından iletişim kutusu şablonunuzdaki liste kutusu denetimine karşılık gelen bir üye değişkeni (Kategori Control ve Değişken Türü CDragListBox) atayın.

Üye değişkenlerine denetim atama hakkında daha fazla bilgi için bkz . İletişim Kutusu Denetimleri için Üye Değişkenlerini Tanımlama Kısayolu.

Devralma Hiyerarşisi

Cobject

Ccmdtarget

Cwnd

Clistbox

CDragListBox

Gereksinimler

Üst bilgi: afxcmn.h

CDragListBox::BeginDrag

Sol fare düğmesine basmak gibi bir sürükleme işlemi başlatabilecek bir olay oluştuğunda çerçeve tarafından çağrılır.

virtual BOOL BeginDrag(CPoint pt);

Parametreler

Pt
Sürüklenen öğenin koordinatlarını içeren bir CPoint nesnesi.

İade Değeri

Sürüklemeye izin veriliyorsa sıfır olmayan, aksi takdirde 0.

Açıklamalar

Sürükleme işlemi başladığında ne olacağını denetlemek istiyorsanız bu işlevi geçersiz kılın. Varsayılan uygulama fareyi yakalar ve kullanıcı sol veya sağ fare düğmesine tıklayana veya ESC tuşuna basana kadar sürükleme modunda kalır ve bu sırada sürükleme işlemi iptal edilir.

CDragListBox::Canceldrag

Bir sürükleme işlemi iptal edildiğinde çerçeve tarafından çağrılır.

virtual void CancelDrag(CPoint pt);

Parametreler

Pt
Sürüklenen öğenin koordinatlarını içeren bir CPoint nesnesi.

Açıklamalar

Liste kutusu denetiminize yönelik özel işlemleri işlemek için bu işlevi geçersiz kılın.

CDragListBox::CDragListBox

Bir CDragListBox nesne oluşturur.

CDragListBox();

CDragListBox::D ragging

Nesne içinde bir liste kutusu öğesi sürüklenirken çerçeve tarafından çağrılır CDragListBox .

virtual UINT Dragging(CPoint pt);

Parametreler

Pt
İmlecin x ve y ekran koordinatlarını içeren bir CPoint nesnesi.

İade Değeri

Görüntülenecek imlecin kaynak kimliği. Aşağıdaki değerler mümkündür:

• DL_COPYCURSOR Öğenin kopyalandığını gösterir.

• DL_MOVECURSOR Öğenin taşınacağını gösterir.

• DL_STOPCURSOR Geçerli bırakma hedefinin kabul edilebilir olmadığını gösterir.

Açıklamalar

Varsayılan davranış DL_MOVECURSOR döndürür. Ek işlevsellik sağlamak istiyorsanız bu işlevi geçersiz kılın.

CDragListBox::D rawInsert

Belirtilen dizine sahip öğenin önüne ekleme kılavuzunu çizmek için çerçeve tarafından çağrılır.

virtual void DrawInsert(int nItem);

Parametreler

nItem
Ekleme noktasının sıfır tabanlı dizini.

Açıklamalar

- 1 değeri ekleme kılavuzunu temizler. Ekleme kılavuzunun görünümünü veya davranışını değiştirmek için bu işlevi geçersiz kılın.

CDragListBox::D ropped

Bir öğe bir nesnenin içine CDragListBox bırakıldığında çerçeve tarafından çağrılır.

virtual void Dropped(
    int nSrcIndex,
    CPoint pt);

Parametreler

nSrcIndex
Bırakılan dizenin sıfır tabanlı dizinini belirtir.

Pt
Bırakma sitesinin koordinatlarını içeren bir CPoint nesnesi.

Açıklamalar

Varsayılan davranış, liste kutusu öğesini ve verilerini yeni konuma kopyalar ve özgün öğeyi siler. Liste kutusu öğelerinin kopyalarının listedeki diğer konumlara sürüklenmesi gibi varsayılan davranışı özelleştirmek için bu işlevi geçersiz kılın.

CDragListBox::ItemFromPt

Pt konumunda bulunan liste kutusu öğesinin sıfır tabanlı dizinini almak için bu işlevi çağırın.

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

Parametreler

Pt
Liste kutusu içindeki bir noktanın koordinatlarını içeren bir CPoint nesnesi.

bAutoScroll
Kaydırmaya izin veriliyorsa sıfır olmayan, aksi takdirde 0.

İade Değeri

Sürükleme listesi kutusu öğesinin sıfır tabanlı dizini.

Ayrıca bkz.

MFC Örnek TSTCON
CListBox Sınıfı
Hiyerarşi Grafiği
CListBox Sınıfı