CListBox sınıfı

Makale
02/26/2013

Windows liste kutusunun işlevlerini sağlar.

class CListBox : public CWnd

Üyeler

Ortak Oluşturucusu

Ad	Description
CListBox::CListBox	Yapıları bir CListBox nesnesi.

Public yöntemler

Ad	Description
CListBox::AddString	Bir dize, bir liste kutusu ekler.
CListBox::CharToItem	Geçersiz kılma özel sağlamak için WM_CHAR , dizeleri yoksa sahibi tarafından çizilen liste kutuları için işleme.
CListBox::CompareItem	Göre sıralanmış sahibi tarafından çizilen liste kutusundaki yeni öğenin konumunu belirlemek için çerçeve olarak adlandırılır.
CListBox::Create	Windows liste kutusu oluşturur ve ekler CListBox nesnesi.
CListBox::DeleteItem	Kullanıcı sahibi tarafından çizilen liste kutusundan bir öğeyi sildiğinde çerçevesi tarafından çağrıldı.
CListBox::DeleteString	Bir dize listesi kutusundan siler.
CListBox::Dir	Dosya adları, sürücüleri veya her ikisi de geçerli dizinden bir liste kutusu ekler.
CListBox::DrawItem	Görsel yönü sahibi tarafından çizilen liste kutusunda değişikliklerin zaman çerçevesi tarafından çağrıldı.
CListBox::FindString	Liste kutusundaki bir dize arar.
CListBox::FindStringExact	Belirtilen bir dizenin eşleşen ilk liste kutusunu bulur.
CListBox::GetAnchorIndex	Geçerli bağlantı öğeyi liste kutusunda sıfır tabanlı dizini alır.
CListBox::GetCaretIndex	Odak dörtgenini bir çoklu seçim liste kutusu olan öğenin dizini belirler.
CListBox::GetCount	Liste kutusunda dizeleri sayısını verir.
CListBox::GetCurSel	Liste kutusunda seçili olan dize sıfır tabanlı dizini döndürür.
CListBox::GetHorizontalExtent	Liste kutusunda yatay olarak kaydırılabileceği piksel cinsinden genişliğini döndürür.
CListBox::GetItemData	Liste kutusu öğesiyle ilişkili 32-bit değeri döndürür.
CListBox::GetItemDataPtr	Bir liste kutusu öğesi için bir işaretçi döndürür.
CListBox::GetItemHeight	Liste kutusundaki öğelerin yüksekliğini belirler.
CListBox::GetItemRect	Şu anda görüntülenen liste kutusu öğesi sınırlayıcı dikdörtgenin döndürür.
CListBox::GetListBoxInfo	Sütun başına düşen öğelerin sayısını alır.
CListBox::GetLocale	Bir liste kutusu için yerel ayar tanıtıcısını alır.
CListBox::GetSel	Liste kutusuna öğenin seçim durumunu verir.
CListBox::GetSelCount	Çoklu seçim liste kutusunda şu anda seçili dizeleri sayısını verir.
CListBox::GetSelItems	Liste kutusunda şu anda seçili dizeleri indisler döndürür.
CListBox::GetText	Bir liste kutusu öğesi bir arabelleğine kopyalar.
CListBox::GetTextLen	Liste kutusundaki bir öğeyi bayt cinsinden uzunluğu döndürür.
CListBox::GetTopIndex	Liste kutusunda ilk görünen dizenin dizini döndürür.
CListBox::InitStorage	Liste kutusu öğeleri ve dizeleri için bellek bloklarını preallocates.
CListBox::InsertString	Liste kutusundaki belirli bir konuma bir dize ekler.
CListBox::ItemFromPoint	Liste kutusu öğesi bir noktaya en yakın dizinini döndürür.
CListBox::MeasureItem	Sahibi tarafından çizilen liste kutusu, liste kutusu boyutlarını belirlemek için oluşturulduğunda çerçevesi tarafından çağrıldı.
CListBox::ResetContent	Liste kutusundan tüm girişleri temizler.
CListBox::SelectString	Arar ve bir tek seçimli liste kutusu içinde bir dize seçer.
CListBox::SelItemRange	Seçer veya çoklu seçim liste kutusu içindeki dizeleri bir dizi seçimini kaldırır.
CListBox::SetAnchorIndex	Genişletilmiş seçim başlamak için bir çoklu seçim liste kutusu çapa ayarlar.
CListBox::SetCaretIndex	Odak dikdörtgeni çoklu seçim liste kutusunda öğe belirtilen dizine ayarlar.
CListBox::SetColumnWidth	Sütunlu liste kutusu sütun genişliğini ayarlar.
CListBox::SetCurSel	Liste kutusunda dize seçer.
CListBox::SetHorizontalExtent	Liste kutusunda yatay olarak kaydırılabileceği piksellerindeki genişliği ayarlar.
CListBox::SetItemData	Liste kutusu öğesiyle ilişkili 32-bit değerini ayarlar.
CListBox::SetItemDataPtr	Liste kutusu öğesi için bir işaretçi ayarlar.
CListBox::SetItemHeight	Liste kutusunda öğelerin yüksekliğini ayarlar.
CListBox::SetLocale	Bir liste kutusu için dil tanıtıcısını ayarlar.
CListBox::SetSel	Seçer veya bir liste kutusu öğesi çoklu seçim liste kutusu seçimini kaldırır.
CListBox::SetTabStops	Liste kutusundaki sekme durağı konumlarını belirler.
CListBox::SetTopIndex	İlk görünen dize sıfır tabanlı dizini liste kutusundaki ayarlar.
CListBox::VKeyToItem	Geçersiz kılma özel sağlamak için WM_KEYDOWN liste kutuları ile işleme LBS_WANTKEYBOARDINPUT stil kümesi.

Notlar

Bir liste kutusu kullanıcının görüntüleyin ve seçin, dosya adları gibi öğeleri listesini görüntüler.

Tek seçimli liste kutusunda, kullanıcı yalnızca bir öğe seçebilir. Çoklu seçim liste kutusuna bir öğe aralığı seçilebilir. Kullanıcı bir öğeyi seçtiğinde vurgulanır ve liste kutusu için ana penceresinde bir bildirim iletisi gönderir.

İletişim şablonu veya doğrudan kodunuzun içinde liste kutusu oluşturabilirsiniz. Doğrudan oluşturmak için oluşturmak CListBox nesnesini ve sonra call Create Windows liste kutusu denetimi oluşturur ve dosyaya eklemek için üye işlev CListBox nesne. İletişim şablonunda bir liste kutusu kullanmak için iletişim kutusu sınıfındaki bir liste kutusu değişken bildirip, ardından kullanmak DDX_Control iletişim kutusunu sınıfının içinde DoDataExchange üye değişkeni denetime bağlamak için işlevi. (iletişim kutusu sınıfınızın kontrol değişkeninin eklediğinizde, bu sizin için otomatik olarak yapılır.)

İnşaat alanından türetilmiş bir sınıf içinde tek adımlık bir işlemle olabilir CListBox. Türetilmiş bir sınıf ve çağrı için bir kurucu Create karşı yapıcısı içindeki.

Bunun üst liste kutusu tarafından gönderilen Windows bildirim iletileri işlemek istiyorsanız (genellikle türetilmiş bir sınıf tarafından CDialog), üst sınıf her ileti için ileti eşleme girdisi ve ileti işleyicisi üye işlev ekleyin.

Her ileti eşleme girdisini aşağıdaki biçimdedir:

ON_Notification( id, memberFxn )

Burada id bildirim gönderme liste kutusu denetimi alt pencere Kimliğini belirtir ve memberFxn bilgilendirmeyi yönetmek için yazılmış üst üye işlev adıdır.

Anne Babalar işlev prototipi aþaðýdaki gibidir:

afx_msg void memberFxn( );

Olası ileti eşleme girdilerini ve bir açıklama içinde oldukları üst gönderilecek taleplerinin listesi aşağıdadır:

on_lbn_dblclk kullanıcı çift tıklattığında bir liste kutusundaki bir dize. Yalnızca sahip bir liste kutusu LBS_NOTIFY stili bu bildirim iletisi gönderir.
on_lbn_errspace liste kutusunda isteği karşılamak için yeterli bellek ayrılamıyor.
ON_LBN_KILLFOCUS liste kutusu giriş odağı kaybetmeden.
on_lbn_selcancel geçerli liste kutusu seçimini iptal edildi. Bir liste kutusu varsa, bu iletiyi yalnızca gönderilen LBS_NOTIFY stili.
on_lbn_selchange liste kutusundaki seçimi değişti. Seçim tarafından değiştirilirse, bu bildirimi gönderilmez CListBox::SetCurSel üye işlevi. Bu bildirim sahip yalnızca bir liste kutusu için geçerlidir LBS_NOTIFY stili. lbn_selchange bildirim iletisi gönderilen çoklu seçim liste kutusu için kullanıcı bir ok tuşuna her bastığında bile seçim değişmez.
on_lbn_setfocus liste kutusunda girdi odağını alıyor.
ON_WM_CHARTOITEM hiçbir dizeleri vardır sahibi tarafından çizilen liste kutusu alır bir WM_CHAR ileti.
ON_WM_VKEYTOITEM bir liste kutusu ile LBS_WANTKEYBOARDINPUT stilini alır bir WM_KEYDOWN ileti.

Oluşturursanız, bir CListBox (aracılığıyla bir iletişim kaynağı), bir iletişim kutusu içindeki nesneyi CListBox nesnesi kullanıcı iletişim kutusu kapandığında otomatik olarak bozulur.

Oluşturursanız, bir CListBox nesneyi yıkmak gerekebilir bir pencere içinde CListBox nesnesi. Oluşturursanız, CListBox nesne yığın üzerinde otomatik olarak bozulur. Oluşturursanız, CListBox nesnesini kullanarak öbek üzerindeki Yeni işlevini çağırmanız gerekir silmek nesnesinde kullanıcı üst pencere kapatıldığında yıkmak için.

Herhangi bir bellek tahsis ederseniz CListBox nesne, geçersiz kılma CListBox ayrılması elden yıkıcı.