CListCtrl sınıfı, "hangi görüntüler öğeleri koleksiyonu her simge (listeden bir resim) ve etiket oluşan bir liste görünüm denetimi," işlevini saklar. Bir simge ve etiket yanı sıra, her öğenin colums simgesi ve etiketin sağında görüntülenen bilgiler olabilir. Bu denetim (ve bu nedenle CListCtrl sınıfı), yalnızca Windows 95 ve Windows NT sürüm 3.51 altında çalışan programlara ve sonrasında mevcuttur.
Aşağıdaki CListCtrl sınıfın kısa bir genel bakış verilmiştir. Detaylı ve kavramsal bir tartışma için bkz Kullanarak CListCtrl ve Denetim konuları Visual c++ programlama Kılavuzu.
Görünümler
Liste Görünümü denetimi "görünüm." adı verilen dört farklı şekillerde içeriklerini görüntüleyebilir
Her öğe, bir tam boy simgesi (32 x 32 piksel) altındaki etiket olarak görüntülenir. Kullanıcının öğeleri listesi Görünümü penceresinde herhangi bir yere sürükleyebilirsiniz.
Her maddenin küçük bir simge (16 x 16 piksel) etiketin sağında görüntülenir. Kullanıcının öğeleri listesi Görünümü penceresinde herhangi bir yere sürükleyebilirsiniz.
Her öğenin sağındaki etiketi içeren küçük bir simge görünür. Öğeleri sütunlarda düzenlenmiş ve liste görünümü penceresinde herhangi bir yere sürüklenemez.
Her öğenin sağındaki sütunlarda düzenlenmiş ek bilgilerle kendi satırında görünür. En soldaki sütunu küçük bir simge ve etiket ve uygulama tarafından belirtilen alt öğeler sonraki sütunlar içerir. Bir katıştırılmış üstbilgi denetiminin (sınıf CHeaderCtrl) bu sütunları uygular. Başlık denetimi ve Rapor Görünümü'nde sütunları hakkında daha fazla bilgi için bkz: CListCtrl kullanarak: sütunlar ekleme (rapor görünümü) denetlemek için.
Denetimin geçerli liste Görünüm stili geçerli görünümü belirler. Bunlar hakkında daha fazla bilgi için bkz: bu stilleri ve kullanımları, CListCtrl kullanma: liste denetimi stillerini değiştirme.
Genişletilmiş stil
Standart liste stillerine ek olarak, genişletilmiş stilleri, zenginleştirilmiş işlevsellik sağlayan büyük bir kümesi için sınıf CListCtrl destekler. Bu işlevselliği bazı örnekler:
İmleci öğenin üzerinde belirli bir süre kaldığında otomatik seçimi öğe etkinleştirildiğinde verir.
Etkinleştirildiğinde, dword maddelere kadar desteklemek için denetimi verir. Uygulama öğesi verileri yönetme yükü yerleştirerek bu mümkündür. Madde seçimi ve odak bilgileri dışında tüm madde bilgilerini uygulama tarafından yönetilmelidir. Daha fazla bilgi için bkz: CListCtrl kullanma: sanal liste denetimleri.
Etkinleştirildiğinde, sıcak takip (otomatik madde metni vurgulama) ve one– ya da two– tıklayın etkinleştirme vurgulanan öğenin verir.
Etkinleştirildiğinde, bir liste görünüm denetimi sütunların sürükle ve bırak reordering verir. Rapor görünümünde kullanılabilir.
Stiller genişletilmiş bu yeni kullanma hakkında bilgi için bkz: CListCtrl kullanma: liste denetimi stillerini değiştirme.
Öğeleri ve alt öğeler
Her öğe bir liste görünüm denetimi (listeden bir resim) simge, etiket, mevcut durumu ve bir uygulama tanımlı değeri ("madde veri olarak" olarak anılacaktır) oluşur. Bir veya daha fazla alt öğesi, aynı zamanda her öğe ile ilişkili olabilir. Bir "alt öğesi", bir öğenin simgesini ve etiket sağındaki sütunda rapor görünümünde görüntülenebilir bir dizedir. Tüm öğeleri bir liste görünüm denetimi alt öğeler aynı sayıda olması gerekir.
Sınıf CListCtrl , ekleme, silme, bulma ve bu öğeleri değiştirmek için çeşitli işlevler sağlar. Daha fazla bilgi için bkz: CListCtrl::GetItem, CListCtrl::InsertItemve CListCtrl::FindItem, CListCtrl kullanarak: denetim öğeleri ekleyerek, ve CListCtrl kullanarak: kaydırma, düzenleme, sıralama ve liste denetimleri bulma.
Varsayılan olarak, liste görünümü denetimi bir öğenin simgesini ve metin özniteliklerini depolamak için sorumludur. Ancak bu öğe türlerine ek olarak, sınıf CListCtrl "geri çağırma madde." destekler Liste görünümü öğesi olan bir "geri çağırma öğesi" ise uygulama — denetim yerine — metin, simge veya her ikisini de saklar. Bir geri arama maskesi (metin veya simge) öğe öznitelikleri uygulama tarafından sağlanan belirtmek için kullanılır. Uygulama geri arama öğeleri kullanıyorsa, metin ve/veya simge öznitelikler isteğe bağlı tedarik mümkün olmalıdır. Geri arama öğeleri, uygulamanız zaten bu bilgilerin bazıları tutar zaman faydalıdır. Daha fazla bilgi için bkz: CListCtrl::GetCallBackMask ve CListCtrl kullanma: geri arama öğeleri ve geri arama maskesi.
Görüntü listeleri
Simgeler, üstbilgi öğesi resimleri ve application– oluşturmak ve liste görünümü denetime atadığınız ( CImageListbir sınıf tarafından uygulanan) birkaç görüntü listeleri Birleşik liste görünümü öğeler içerdiği için tanımlanmış. Her bir liste görünüm denetimi görüntü listeleri dört farklı olabilir:
Simge görünümünde tam boyutlu simgeler için kullanılan.
Küçük bir simge, liste ve rapor görünümleri simge görünümünde kullanılan simgeleri küçük sürümleri için kullanılan.
Uygulama tanımlı bir durumu belirtmek için öğenin yanındaki simgesi devlet görüntülerini içeren.
Rapor görünümünde her başlık denetimi öğesinde görüntülenen küçük resimler için kullanılan.
Varsayılan olarak, bir liste görünüm denetimi tahrip için atanan görüntü listeleri yok eder; Ancak, geliştirici, artık kullanıldığında, her bir görüntü listesi uygulama tarafından belirlenen yok tarafından bu davranışını özelleştirebilirsiniz. Daha fazla bilgi için bkz: kullanarak CListCtrl: liste öğeleri ve görüntü listeleri ve kullanarak CListCtrl: liste öğeleri ve görüntü listeleri.
# include lt;afxcmn.h>
Sı&nıf üyeleri |nbsp; Temel sınıf | Hiyerarşi çizelgesi
Ör&neklerinbsp; mfc örnek daotable | mfc örnek httpsvr | mfc örnek LISTHDR | mfc örnek ROWLIST | mfc örnek DBVLIST
Ayrıca bkz: CImageList