CListCtrl sınıfı

Makale
02/26/2013

"Görüntüleyen topluluğu (yansıma listesinden) bir simge ve bir etiket oluşan her öğe bir liste görünüm denetimi," işlevini saklar.

class CListCtrl : public CWnd

Üyeler

Ortak Oluşturucusu

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

Public yöntemler

Ad	Description
CListCtrl::ApproximateViewRect	Genişlik ve Yükseklik bir liste görünüm denetimi öğeleri görüntülemek için gereken belirler.
CListCtrl::Arrange	Öğeleri kılavuz hizalar.
CListCtrl::CancelEditLabel	Öğe metin düzenleme işlemini iptal eder.
CListCtrl::Create	Liste denetimi oluşturur ve ekler bir CListCtrl nesnesi.
CListCtrl::CreateDragImage	Belirli bir madde için sürükle resim listesi oluşturur.
CListCtrl::CreateEx	Belirtilen Windows genişletilmiş stilleri içeren bir liste denetimi oluşturur ve ekler bir CListCtrl nesnesi.
CListCtrl::DeleteAllItems	Denetimden tüm öğeleri siler.
CListCtrl::DeleteColumn	Bir sütunun liste görünüm denetimi ' siler.
CListCtrl::DeleteItem	Denetimden bir öğeyi siler.
CListCtrl::DrawItem	Görsel yönü sahibi tarafından çizilen denetimi değişiklikleri olduğunda denir.
CListCtrl::EditLabel	Bir öğenin metnini yerinde düzenlemeyi başlar.
CListCtrl::EnableGroupView	Etkinleştirir veya bir grup bir liste görünüm denetimi öğeleri görüntüleme mi devre dışı bırakır.
CListCtrl::EnsureVisible	Öğenin görünür olmasını sağlar.
CListCtrl::FindItem	Belirtilen özelliklere bir liste görünümü öğesi arar.
CListCtrl::GetBkColor	Bir liste görünüm denetimi arka plan rengini alır.
CListCtrl::GetBkImage	Bir liste görünüm denetimi geçerli arka plan görüntüsünü alır.
CListCtrl::GetCallbackMask	Bir liste görünüm denetimi için geri arama maskesi alır.
CListCtrl::GetCheck	Bir maddeyle bağlantılı durumu resmi geçerli görüntü durumunu alır.
CListCtrl::GetColumn	Bir denetimin sütun özniteliklerini alır.
CListCtrl::GetColumnOrderArray	Bir liste görünüm denetimi sütun sırası (soldan sağa) alır.
CListCtrl::GetColumnWidth	Rapor görünümü veya liste görünümünde sütunun genişliğini alır.
CListCtrl::GetCountPerPage	Dikey bir liste görünüm denetimi sığabilecek öğe sayısını hesaplar.
CListCtrl::GetEditControl	Bir öğenin metin düzenlemek için kullanılan bir düzenleme denetimini tanıtıcı alır.
CListCtrl::GetEmptyText	Geçerli liste görünümü Denetim boş olduğunda görüntülenecek dize alır.
CListCtrl::GetExtendedStyle	Bir liste görünüm denetimi geçerli genişletilmiş stillerini alır.
CListCtrl::GetFirstSelectedItemPosition	Bir liste görünüm denetimi ilk seçili liste görünümü öğesi konumunu alır.
CListCtrl::GetFocusedGroup	Geçerli liste görünüm denetimi klavye odaklamasına sahip grubunu alır.
CListCtrl::GetGroupCount	Geçerli liste görünüm denetimi gruplarının sayısını alır.
CListCtrl::GetGroupInfo	Belirtilen bir liste görünüm denetimi grubu için bilgi alır.
CListCtrl::GetGroupInfoByIndex	Geçerli liste görünüm denetimi içinde belirtilen bir gruba ilişkin bilgileri alır.
CListCtrl::GetGroupMetrics	Bir grubun ölçümleri alır.
CListCtrl::GetGroupRect	Geçerli liste görünüm denetimi belirli bir grup için sınırlayıcı dikdörtgeni alır.
CListCtrl::GetGroupState	Geçerli liste görünüm denetimi belirli bir grup durumunu alır.
CListCtrl::GetHeaderCtrl	Bir liste görünüm denetimi üstbilgi denetiminin alır.
CListCtrl::GetHotCursor	Sıcak izleme için bir liste görünüm denetimi etkinleştirildiğinde, kullanılan imleç alır.
CListCtrl::GetHotItem	Şu anda İmlecin altındaki liste görünümü öğesi alır.
CListCtrl::GetHoverTime	Bir liste görünüm denetimi geçerli vurgulu saatini alır.
CListCtrl::GetImageList	Çizim liste görünümünde öğeler için kullanılan bir resim listesi tanıtıcı alır.
CListCtrl::GetInsertMark	Ekleme işareti geçerli konumunu alır.
CListCtrl::GetInsertMarkColor	Ekleme işareti geçerli rengini alır.
CListCtrl::GetInsertMarkRect	Ekleme noktasını bounds dikdörtgenini alır.
CListCtrl::GetItem	Liste görünümünde öğenin özniteliklerini alır.
CListCtrl::GetItemCount	Bir liste görünüm denetimi öğelerin sayısını alır.
CListCtrl::GetItemData	Bir madde ile ilişkili uygulamaya özgü değerini alır.
CListCtrl::GetItemIndexRect	Geçerli liste görünüm denetimi AltÖğe bir bölümünü veya tümünü için sınırlayıcı dikdörtgeni alır.
CListCtrl::GetItemPosition	Liste görünümü öğesi konumunu alır.
CListCtrl::GetItemRect	Bir madde için sınırlayıcı dikdörtgeni alır.
CListCtrl::GetItemSpacing	Geçerli liste görünüm denetimi öğeleri arasındaki aralığı hesaplar.
CListCtrl::GetItemState	Liste görünümü öğesi durumunu alır.
CListCtrl::GetItemText	Liste görünümü öğesi veya alt metnini alır.
CListCtrl::GetNextItem	Liste görünümü öğesi belirtilen özelliklere sahip ve belirli bir madde için belirtilen ilişki ile arar.
CListCtrl::GetNextItemIndex	Belirtilen bir özellikler kümesi vardır geçerli liste görünüm denetimi öğenin dizin alır.
CListCtrl::GetNextSelectedItem	Liste görünümü öğesi konumu ve yineleme için sonraki seçili liste görünümü öğesi konumunu dizin alır.
CListCtrl::GetNumberOfWorkAreas	Geçerli bir liste görünüm denetimi çalışma alanlarına sayısını alır.
CListCtrl::GetOrigin	Bir liste görünüm denetimi için geçerli görünümü kaynak alır.
CListCtrl::GetOutlineColor	Bir liste görünüm denetimi kenarlık rengini alır.
CListCtrl::GetSelectedColumn	Liste denetimi seçili sütunun dizin alır.
CListCtrl::GetSelectedCount	Liste görünümü denetimi seçili olan öğelerin sayısını alır.
CListCtrl::GetSelectionMark	Bir liste görünüm denetimi seçim imine alır.
CListCtrl::GetStringWidth	Verilen bir dize tümünü görüntülemek gerekli minimum sütun genişliğini belirler.
CListCtrl::GetSubItemRect	Bir liste görünüm denetimi içindeki bir öğeyi sınırlayıcı dikdörtgenin alır.
CListCtrl::GetTextBkColor	Bir liste görünüm denetimi metin arka plan rengini alır.
CListCtrl::GetTextColor	Bir liste görünüm denetimi metin rengini alır.
CListCtrl::GetTileInfo	Bir liste görünüm denetimi döşemedeki hakkındaki bilgileri alır.
CListCtrl::GetTileViewInfo	Tile görünümündeki bir liste görünüm denetimi hakkında bilgi alır.
CListCtrl::GetToolTips	Araç İpuçları'nı görüntülemek için liste görünümü denetimi kullanan bir tooltip denetimi alır.
CListCtrl::GetTopIndex	En üstte görünen öğenin dizini alır.
CListCtrl::GetView	Liste görünümü denetimi görünümünü alır.
CListCtrl::GetViewRect	Liste görünümü denetimi içindeki tüm öğeler çevreleyen dikdörtgenin alır.
CListCtrl::GetWorkAreas	Geçerli bir liste görünüm denetimi çalışma alanları alır.
CListCtrl::HasGroup	Liste görünümü denetimi belirtilen grup olup olmadığını belirler.
CListCtrl::HitTest	Belirleyen liste görünümü öğesi belirtilen konumda değil.
CListCtrl::InsertColumn	Bir liste görünüm denetimi yeni bir sütun ekler.
CListCtrl::InsertGroup	Bir grup liste görünüm denetimi ekler.
CListCtrl::InsertGroupSorted	Belirtilen grup gruplar sıralı bir listesini ekler.
CListCtrl::InsertItem	Yeni bir öğe bir liste görünüm denetimi ekler.
CListCtrl::InsertMarkHitTest	Ekleme noktasını belirli bir noktaya en yakın alır.
CListCtrl::IsGroupViewEnabled	Grup görünüm için bir liste görünüm denetimi etkin olup olmadığını belirler.
CListCtrl::IsItemVisible	Belirtilen öğe geçerli liste görünüm denetimi içinde görünür olup olmadığını gösterir.
CListCtrl::MapIDToIndex	Geçerli liste görünüm denetimi içindeki bir öğeyi benzersiz kimliği için bir dizin eşleştirir.
CListCtrl::MapIndexToID	Geçerli liste görünüm denetimi içindeki bir öğenin dizin benzersiz bir kimliği eşlemeleri
CListCtrl::MoveGroup	Belirtilen grup taşır.
CListCtrl::MoveItemToGroup	Liste görünümü denetimi sıfır tabanlı dizini belirtilen belirtilen grup taşır.
CListCtrl::RedrawItems	Bir öğe aralığı çizilecek bir liste görünüm denetimi zorlar.
CListCtrl::RemoveAllGroups	Tüm grupların bir liste görünüm denetimi ' kaldırır.
CListCtrl::RemoveGroup	Belirtilen grup Liste Görünüm Denetimi ' kaldırır.
CListCtrl::Scroll	Bir liste görünüm denetimi içeriğini kaydıran.
CListCtrl::SetBkColor	Liste görünümü denetimi arka plan rengini ayarlar.
CListCtrl::SetBkImage	Bir liste görünüm denetimi geçerli arka plan görüntüsünü belirler.
CListCtrl::SetCallbackMask	Bir liste görünüm denetimi için geri arama maskesi ayarlar.
CListCtrl::SetCheck	Ayarlar geçerli bir öğeyle ilişkili durumu resmi durumunu görüntüler.
CListCtrl::SetColumn	Liste görünümünde sütun özniteliklerini ayarlar.
CListCtrl::SetColumnOrderArray	Bir liste görünüm denetimi sütun sırası (soldan sağa) ayarlar.
CListCtrl::SetColumnWidth	Rapor görünümü veya liste görünümünde sütunun genişliğini değiştirir.
CListCtrl::SetExtendedStyle	Bir liste görünüm denetimi geçerli genişletilmiş stillerini ayarlar.
CListCtrl::SetGroupInfo	Bir liste görünüm denetimi belirtilen grup bilgilerini ayarlar.
CListCtrl::SetGroupMetrics	Bir liste görünüm denetimi grup ölçümlerini ayarlar.
CListCtrl::SetHotCursor	Sıcak izleme için bir liste görünüm denetimi etkinleştirildiğinde, kullanılan imleç ayarlar.
CListCtrl::SetHotItem	Bir liste görünüm denetimi geçerli etkin öğeyi ayarlar.
CListCtrl::SetHoverTime	Bir liste görünüm denetimi geçerli vurgulama süresini ayarlar.
CListCtrl::SetIconSpacing	Bir liste görünüm denetimi simgeler arasındaki boşluğu ayarlar.
CListCtrl::SetImageList	Resim listesi bir liste görünüm denetimi atar.
CListCtrl::SetInfoTip	Araç İpucu metni ayarlar.
CListCtrl::SetInsertMark	Ekleme noktası için tanımlanan konumunu ayarlar.
CListCtrl::SetInsertMarkColor	Ekleme noktasını rengini ayarlar.
CListCtrl::SetItem	Liste görünümü tümünün veya öğenin özniteliklerini ayarlar.
CListCtrl::SetItemCount	Çok sayıda öğe eklemek için bir liste görünüm denetimi hazırlar.
CListCtrl::SetItemCountEx	Sanal liste görünümü denetimi için öğe sayısını ayarlar.
CListCtrl::SetItemData	Maddenin uygulamaya özgü değerini ayarlar.
CListCtrl::SetItemIndexState	Geçerli liste görünüm denetimi bir öğenin durumunu ayarlar.
CListCtrl::SetItemPosition	Bir öğeyi bir liste görünüm denetimi belirli bir konuma taşır.
CListCtrl::SetItemState	Bir liste görünüm denetimi içindeki bir öğeyi durumunu değiştirir.
CListCtrl::SetItemText	Liste görünümü öğesi veya alt metnini değiştirir.
CListCtrl::SetOutlineColor	Bir liste görünüm denetimi kenarlık rengini ayarlar.
CListCtrl::SetSelectedColumn	Liste görünümü denetimi seçili sütunu ayarlar.
CListCtrl::SetSelectionMark	Bir liste görünüm denetimi seçim imine ayarlar.
CListCtrl::SetTextBkColor	Bir liste görünüm denetimi metnin arka plan rengini ayarlar.
CListCtrl::SetTextColor	Bir liste görünüm denetimi metin rengini belirler.
CListCtrl::SetTileInfo	Liste görünümü denetimi için bir taş bilgileri ayarlar.
CListCtrl::SetTileViewInfo	Döşeme görünümü'nde bir liste görünüm denetimi kullandığı bilgileri ayarlar.
CListCtrl::SetToolTips	Liste Görünümü Denetimi Araç İpuçları'nı görüntülemek için kullanacağı tooltip denetimi ayarlar.
CListCtrl::SetView	Liste görünümü denetimi görünümünü belirler.
CListCtrl::SetWorkAreas	Burada bir liste görünüm denetimi simgeleri görüntülenebilir alanını ayarlar.
CListCtrl::SortGroups	Kullanıcı tanımlı bir işlev ile Denetim sıralar grupları listesini görüntüleyin.
CListCtrl::SortItems	Uygulama tanımlı karşılaştırma işlevini kullanarak liste görünümü öğeleri sıralar.
CListCtrl::SortItemsEx	Uygulama tanımlı karşılaştırma işlevini kullanarak liste görünümü öğeleri sıralar.
CListCtrl::SubItemHitTest	Hangi liste görünümü öğesi varsa, belirli bir konumda belirler.
CListCtrl::Update	Belirtilen öğe çizilecek denetim zorlar.

Notlar

Bir simge ve etiket yanı sıra her öğenin simgesi ve etiketi sağındaki sütunlarda görüntülenen bilgiler olabilir.Bu denetim (ve bu nedenle CListCtrl class) sonraki ve yalnızca Windows 95/98 ve Windows NT sürüm 3.51 altında çalışan programlar için kullanılabilir.

Aşağıda kısa bir genel bakış verilmektedir CListCtrl sınıfı.Ayrıntılı, kavramsal tartışma için bkz: Kullanarak CListCtrl ve denetimleri.

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üleme

Simge görünümü

Her öğenin altındaki etiketi içeren bir tam donanımlı simgesi (32 x 32 piksel) olarak görünür.Kullanıcının öğeleri listesi görünümü penceresinde herhangi bir yere sürükleyebilirsiniz.
Küçük simge görünümü

Her öğenin sağındaki etiketi içeren küçük bir simge (16 x 16 piksel) görünür.Kullanıcının öğeleri listesi görünümü penceresinde herhangi bir yere sürükleyebilirsiniz.
Liste görünümü

Her öğenin sağındaki etiketi içeren küçük bir simge olarak görüntülenir.Öğeleri sütunlarda düzenlenmiş ve liste görünümü penceresinde herhangi bir yere sürüklenemez.
Rapor Görünümü

Her öğe, sağdaki sütunlarda düzenlenmiş ek bilgilerle kendi satırında görünür.Küçük simge ve etiket en soldaki sütunu içerir ve sonraki sütunlar uygulama tarafından belirtilen alt öğelerini içerir.Katıştırılmış üstbilgi denetiminin (sınıf CHeaderCtrl) bu sütunları uygular.Üstbilgi denetimi ve rapor görünümünde sütunları hakkında daha fazla bilgi için bkz: CListCtrl kullanma: sütunlar ekleme (rapor görünümü) denetlemek için.

Ayrıca bkz:

Bilgi Bankası makalesi Q250614: nasıl yapılır: CListCtrl rapor görünümünde öğeleri Sırala
Bilgi Bankası makalesi Q200054: prb: OnTimer() ise değil olarak adlandırılan sürekli bir liste denetimi için

Geçerli görünümü denetimin geçerli liste görünüm stili belirler.Bu stilleri ve kullanımları hakkında daha fazla bilgi için bkz: kullanarak CListCtrl: liste denetimi stillerini değiştirme.

Genişletilmiş Stil

Standart liste stillerine ek olarak, sınıf CListCtrl çok sayıda zenginleştirilmiş işlevsellik sağlayan genişletilmiş stillerini destekler.Bu işlevselliği bazı örnekler şunlardır:

Vurgulu seçimi

İmleci belirli bir süre boyunca öğenin üstünde kalır olduğunda etkin olduğunda, bir öğeyi otomatik olarak seçilmesine izin verir.
Sanal liste görünümleri

Etkin olduğunda, en çok desteklemek üzere oyununda DWORD öğeleri.Bu uygulama öğe verilerini yönetme ek yük koyarak mümkündür.Madde seçimi ve odak bilgisi dışında tüm madde bilgilerini uygulama tarafından yönetiliyor olması gerekir.Daha fazla bilgi için bkz: CListCtrl kullanma: sanal liste denetimleri.
One– ve two– etkinleştirme'yi tıklatın

Etkin olduğunda, sıcak (Otomatik madde metni vurgulama) izleme sağlar ve one– veya two– vurgulanan öğenin etkinleştirme'yi tıklatın.
Sürükle ve bırak sütun sırası

Etkin olduğunda, sürükle ve bırak bir liste görünüm denetimi sütunları yeniden sıralama sağlar.Rapor görünümünde kullanılabilir.

Bu yeni bilgi stiller genişletilmiş için bkz: kullanarak CListCtrl: liste denetimi stillerini değiştirme.

Öğeleri ve alt öğeler

Her öğe bir liste görünüm denetimi (görüntü listesinden) bir simge, bir etiket, geçerli durumu ve ("öğe verilerini" adlandırılır) bir uygulama tanımlı değeri oluşur.Bir veya daha fazla alt öğesi, aynı zamanda her öğe ile ilişkili olabilir."Alt", bir öğenin simgesi ve etiketi sağındaki sütunda rapor görünümünde görüntülenen bir dizedir.Bir liste görünüm denetimi tüm öğelerde alt öğeler aynı sayıda olması gerekir.

Sınıf CListCtrl ekleme silme, bulma ve bu öğeleri değiştirme çeitli ilevler salar.Daha fazla bilgi için bkz: CListCtrl::GetItem, CListCtrl::InsertItem, ve CListCtrl::FindItem, kullanarak CListCtrl: denetim öğeleri ekleme, ve kullanarak CListCtrl: kaydırma, düzenleme, sıralama ve liste denetimleri bulma.

Varsayılan olarak, liste görünümü simge ve metin öğenin özniteliklerini depolamak için sorumludur.Ancak, bu öğe türlerine ek olarak, sınıf CListCtrl "geri arama öğeleri" destekler Liste görünümü öğesi kendisi için "Geri çağırma öğesi" olan uygulama — Denetim yerine — metin, simge veya her ikisini de depolar.Geri arama maskesi uygulama tarafından sağlanan hangi öğenin özniteliklerini (metin ve/veya simge) belirtmek için kullanılır.Geri arama öğeleri bir uygulama kullanıyorsa, metin ve/veya simge öznitelikler isteğe bağlı kanıtları olmalıdır.Uygulama zaten bu bilgilerin bazıları korur, geri arama öğeleri yardımcı olur.Daha fazla bilgi için bkz: CListCtrl kullanma: geri arama öğeleri ve geri arama maskesi.

Görüntü listeleri

Simgeler, üstbilgi öğesi görüntüleri ve application– için liste görünümü öğeleri birkaç resim listelerinde yer alan Devletler tanımlı (sınıfı tarafından uygulanan CImageList), oluşturmak ve liste görünümü denetimi atayın.Her liste görünüm denetimi dört farklı tür görüntü listesi olabilir:

Büyük simge

Simge görünümü içinde tam boyutlu simgeler için kullanılır.
Küçük simge

Küçük simge, liste ve rapor görünümlerini daha küçük simge görünümü içinde kullanılan simgeler sürümleri için kullanılır.
Uygulama tanımlı durumu

Uygulama tanımlı bir durumu belirtmek için bir öğe simgesinin görüntülenen durum görüntüleri içerir.
Üstbilgi öğesi

Rapor görünümünde her başlık denetimi öğesinde görüntülenen küçük resimleri için kullanılır.

Varsayılan olarak, bir liste görünüm denetimi yok edilir kendisine atanmış görüntü listeleri bozar; Ancak, geliştirici, artık kullanıldığında, her resim listesi uygulama tarafından belirlendiği şekilde zarar olarak bu davranış özelleştirebilirsiniz.Daha fazla bilgi için bkz: kullanarak CListCtrl: liste öğeleri ve görüntü listeleri.