Třída CListCtrl

Článek
06/10/2015

Zapouzdřuje funkce "ovládací prvek seznam zobrazení," která zobrazí kolekce položek, každý se skládá z ikony (seznam obrázků) a popisek.

class CListCtrl : public CWnd

Členy

Veřejné konstruktory

Název	Description
CListCtrl::CListCtrl	Konstrukce CListCtrl objektu.

Veřejné metody

Název	Description
CListCtrl::ApproximateViewRect	Určuje šířku a výšku potřebné k zobrazení položek ovládacího prvku seznamu zobrazení.
CListCtrl::Arrange	Zarovná položky k mřížce.
CListCtrl::CancelEditLabel	Zruší operaci úpravy textu položky.
CListCtrl::Create	Vytvoří ovládací prvek seznam a připojí jej CListCtrl objektu.
CListCtrl::CreateDragImage	Vytvoří seznam obrázku táhnout pro zadanou položku.
CListCtrl::CreateEx	Zadaný styly rozšířeného systému Windows vytvoří ovládací prvek seznam a připojí jej CListCtrl objektu.
CListCtrl::DeleteAllItems	Odstraní všechny položky v ovládacím prvku.
CListCtrl::DeleteColumn	Odstraní sloupec z ovládacího prvku seznamu zobrazení.
CListCtrl::DeleteItem	Odstraní položku z ovládacího prvku.
CListCtrl::DrawItem	Volána při vizuální aspekty řízení změn vykreslování vlastníka.
CListCtrl::EditLabel	Začíná v místě úpravy textu položky.
CListCtrl::EnableGroupView	Povolí nebo zakáže, zda položky v ovládacím prvku seznamu zobrazení se zobrazí jako skupina.
CListCtrl::EnsureVisible	Zajišťuje viditelné položky.
CListCtrl::FindItem	Hledá s zadané vlastnosti zobrazení položky seznamu.
CListCtrl::GetBkColor	Použije barvu pozadí ovládacího prvku seznamu zobrazení.
CListCtrl::GetBkImage	Načte aktuální obrázek pozadí pro ovládací prvek seznamu zobrazení.
CListCtrl::GetCallbackMask	Načte zpětné volání masku pro ovládací prvek seznamu zobrazení.
CListCtrl::GetCheck	Načte aktuální stav zobrazení obrázku stavu přidruženého k položce.
CListCtrl::GetColumn	Načítá atributy sloupce ovládacího prvku.
CListCtrl::GetColumnOrderArray	Načte pořadí sloupců ovládací prvek seznamu zobrazení (zleva doprava).
CListCtrl::GetColumnWidth	Zjišťuje šířku sloupců v zobrazení seznamu nebo zobrazení sestavy.
CListCtrl::GetCountPerPage	Vypočítá počet položek, které lze umístit svisle v ovládacím prvku seznamu zobrazení.
CListCtrl::GetEditControl	Načte úchyt pro úpravy textu položky ovládacího prvku pro úpravy.
CListCtrl::GetEmptyText	Načte řetězec zobrazí, pokud aktuální zobrazení seznamu ovládacího prvku je prázdný.
CListCtrl::GetExtendedStyle	Načte aktuální styly rozšířený ovládací prvek seznamu zobrazení.
CListCtrl::GetFirstSelectedItemPosition	Načte pozici první položku vybraného seznamu zobrazit v ovládacím prvku seznamu zobrazení.
CListCtrl::GetFocusedGroup	Vyhledá skupiny, která má fokusu klávesnice v aktuální ovládací prvek seznamu zobrazení.
CListCtrl::GetGroupCount	Vyhledá číslo skupiny v aktuální ovládací prvek seznamu zobrazení.
CListCtrl::GetGroupInfo	Získá informace pro zadanou skupinu ovládací prvek seznamu zobrazení.
CListCtrl::GetGroupInfoByIndex	Načte informace o určené skupiny v aktuální ovládací prvek seznamu zobrazení.
CListCtrl::GetGroupMetrics	Načte metriky skupiny.
CListCtrl::GetGroupRect	Načte ohraničovací obdélník pro zadanou skupinu v ovládacím prvku aktuální zobrazení seznamu.
CListCtrl::GetGroupState	Načte stav pro zadanou skupinu v ovládacím prvku aktuální zobrazení seznamu.
CListCtrl::GetHeaderCtrl	Načte ovládací prvek seznamu zobrazení prvku záhlaví.
CListCtrl::GetHotCursor	Obnoví kurzor při povolené sledování aktivní ovládací prvek seznamu zobrazení.
CListCtrl::GetHotItem	Načte položku zobrazení seznamu aktuálně pod kurzorem.
CListCtrl::GetHoverTime	Načte aktuální čas přechodu ovládací prvek seznamu zobrazení.
CListCtrl::GetImageList	Získá popisovač pro kreslení zobrazení položek seznamu seznam obrázků.
CListCtrl::GetInsertMark	Načte aktuální pozice kurzoru značky.
CListCtrl::GetInsertMarkColor	Načte aktuální barva značky vložení.
CListCtrl::GetInsertMarkRect	Načte obdélník, který bounds kurzor.
CListCtrl::GetItem	Načte položku zobrazení seznamu atributů.
CListCtrl::GetItemCount	Vyhledá číslo položky v ovládacím prvku seznamu zobrazení.
CListCtrl::GetItemData	Načítá hodnoty specifické pro aplikaci přidružené položky.
CListCtrl::GetItemIndexRect	Načte ohraničovací obdélník pro všechny nebo část podřízenou aktuální zobrazení seznamu ovládacího prvku.
CListCtrl::GetItemPosition	Načte pozici zobrazit položku seznamu.
CListCtrl::GetItemRect	Načte položky ohraničovacího rámečku.
CListCtrl::GetItemSpacing	Vypočítá mezery mezi položkami v aktuální ovládací prvek seznamu zobrazení.
CListCtrl::GetItemState	Načte stav zobrazit položku seznamu.
CListCtrl::GetItemText	Načte text seznamu zobrazit položku nebo podpoložku.
CListCtrl::GetNextItem	Vyhledá položku seznamu zobrazení zadaných vlastností a s Zadaný vztah k dané položce.
CListCtrl::GetNextItemIndex	Načte index položky v aktuálním zobrazení seznamu, která obsahuje zadanou sadu vlastností.
CListCtrl::GetNextSelectedItem	Načte index pozici položky seznamu zobrazení a další položku v zobrazení vybraného seznamu umožňující umístění.
CListCtrl::GetNumberOfWorkAreas	Načte aktuální počet pracovních prostorech pro ovládací prvek seznamu zobrazení.
CListCtrl::GetOrigin	Načte aktuální zobrazení původu pro ovládací prvek seznamu zobrazení.
CListCtrl::GetOutlineColor	Zjišťuje barvu ohraničení ovládacího prvku seznamu zobrazení.
CListCtrl::GetSelectedColumn	Načte index aktuálně vybraný sloupec v ovládacím prvku seznamu.
CListCtrl::GetSelectedCount	Vyhledá číslo vybrané položky v seznamu ovládacího prvku zobrazení.
CListCtrl::GetSelectionMark	Načte na značku ovládací prvek seznamu zobrazení.
CListCtrl::GetStringWidth	Určuje minimální šířku nezbytná pro zobrazení všech zadaného řetězce.
CListCtrl::GetSubItemRect	Načte položky v ovládacím prvku zobrazit seznam ohraničovacího rámečku.
CListCtrl::GetTextBkColor	Načte text barvu pozadí ovládacího prvku seznamu zobrazení.
CListCtrl::GetTextColor	Načte ovládací prvek seznamu zobrazení barvy textu.
CListCtrl::GetTileInfo	Načte informace o dlaždice v ovládacím prvku seznamu zobrazení.
CListCtrl::GetTileViewInfo	Načte informace o ovládacím prvku seznamu zobrazení v zobrazení vedle sebe.
CListCtrl::GetToolTips	Načte popis ovládacího prvku, který používá ovládací prvek seznamu zobrazení zobrazit popisy tlačítek.
CListCtrl::GetTopIndex	Načte index zobrazeno navrchu.
CListCtrl::GetView	Získá-li zobrazit ovládací prvek seznamu zobrazení.
CListCtrl::GetViewRect	Načte ohraničovacího rámečku všechny položky v seznamu ovládacího prvku zobrazení.
CListCtrl::GetWorkAreas	Načte aktuální pracovní prostory ovládací prvek seznamu zobrazení.
CListCtrl::HasGroup	Určuje, zda ovládací prvek seznamu zobrazení má určené skupiny.
CListCtrl::HitTest	Určuje, který seznam je zobrazení položky na určené pozici.
CListCtrl::InsertColumn	Vloží ovládací prvek zobrazení seznamu nový sloupec.
CListCtrl::InsertGroup	Vloží ovládací prvek seznamu zobrazení skupiny.
CListCtrl::InsertGroupSorted	Vloží seznam skupin pořadí určené skupiny.
CListCtrl::InsertItem	Vloží ovládací prvek seznamu zobrazení nové položky.
CListCtrl::InsertMarkHitTest	Načte zadaný bod nejblíže kurzoru.
CListCtrl::IsGroupViewEnabled	Určuje, zda zobrazit skupiny pro ovládací prvek seznamu zobrazení.
CListCtrl::IsItemVisible	Označuje, zda je zadaná položka v aktuálním zobrazení seznamu řízení viditelné.
CListCtrl::MapIDToIndex	Mapuje jedinečné ID položky v ovládacím prvku seznamu zobrazení aktuálního indexu.
CListCtrl::MapIndexToID	Mapuje index položky v aktuální ovládací prvek zobrazení seznamu jedinečný identifikátor.
CListCtrl::MoveGroup	Přesune určené skupiny.
CListCtrl::MoveItemToGroup	Přesune že zadané skupiny na zadaný nula podle indexu ovládacího prvku seznamu zobrazení.
CListCtrl::RedrawItems	Vynutí ovládací prvek seznamu zobrazení chcete překreslit oblast položek.
CListCtrl::RemoveAllGroups	Odebere ze zobrazení ovládacího prvku seznam všech skupin.
CListCtrl::RemoveGroup	Odstraní určené skupiny z ovládacího prvku seznamu zobrazení.
CListCtrl::Scroll	Posune obsah ovládacího prvku seznamu zobrazení.
CListCtrl::SetBkColor	Nastaví barvu pozadí ovládacího prvku seznamu zobrazení.
CListCtrl::SetBkImage	Nastaví aktuální obrázek pozadí pro ovládací prvek seznamu zobrazení.
CListCtrl::SetCallbackMask	Nastaví zpětné volání masku pro ovládací prvek seznamu zobrazení.
CListCtrl::SetCheck	Nastaví aktuální zobrazí stav obrázku stavu přidruženého k položce.
CListCtrl::SetColumn	Nastaví atributy sloupce seznamu zobrazení.
CListCtrl::SetColumnOrderArray	Nastaví pořadí sloupců ovládací prvek seznamu zobrazení (zleva doprava).
CListCtrl::SetColumnWidth	Změní šířku sloupce v zobrazení seznamu nebo zobrazení sestavy.
CListCtrl::SetExtendedStyle	Nastaví aktuální styly rozšířený ovládací prvek seznamu zobrazení.
CListCtrl::SetGroupInfo	Nastaví informace o určené skupiny ovládací prvek seznamu zobrazení.
CListCtrl::SetGroupMetrics	Nastaví metriky skupiny ovládací prvek seznamu zobrazení.
CListCtrl::SetHotCursor	Nastaví kurzor při povolené sledování aktivní ovládací prvek seznamu zobrazení.
CListCtrl::SetHotItem	Nastaví aktuální aktivní položky ovládací prvek seznamu zobrazení.
CListCtrl::SetHoverTime	Nastaví aktuální čas přechodu ovládací prvek seznamu zobrazení.
CListCtrl::SetIconSpacing	Nastaví rozestupy mezi ikonami v ovládacím prvku seznamu zobrazení.
CListCtrl::SetImageList	Přiřadí seznam obrázků ovládací prvek seznamu zobrazení.
CListCtrl::SetInfoTip	Nastaví text popisku.
CListCtrl::SetInsertMark	Nastaví kurzor na definované pozice.
CListCtrl::SetInsertMarkColor	Nastaví barvu kurzoru.
CListCtrl::SetItem	Nastaví zobrazení seznamu všechny nebo některé položky atributy.
CListCtrl::SetItemCount	Ovládací prvek zobrazení seznamu připraví pro přidání velkého počtu položek.
CListCtrl::SetItemCountEx	Nastaví u ovládacího prvku zobrazení virtuálního seznamu počet položek.
CListCtrl::SetItemData	Nastaví hodnotu položky specifické pro aplikaci.
CListCtrl::SetItemIndexState	Nastaví stav položky v ovládacím prvku aktuální zobrazení seznamu.
CListCtrl::SetItemPosition	Přesune položky na určené pozici v ovládacím prvku seznamu zobrazení.
CListCtrl::SetItemState	Změní stav položky v ovládacím prvku seznamu zobrazení.
CListCtrl::SetItemText	Změní text seznamu zobrazit položku nebo podpoložku.
CListCtrl::SetOutlineColor	Nastaví barvu ohraničení ovládacího prvku seznamu zobrazení.
CListCtrl::SetSelectedColumn	Nastaví vybraný sloupec ovládacího prvku seznamu zobrazení.
CListCtrl::SetSelectionMark	Nastaví na značku ovládací prvek seznamu zobrazení.
CListCtrl::SetTextBkColor	Nastaví barvu pozadí textu v ovládacím prvku seznamu zobrazení.
CListCtrl::SetTextColor	Nastaví barvu textu ovládacího prvku seznamu zobrazení.
CListCtrl::SetTileInfo	Nastaví informace o kámen pro ovládací prvek seznamu zobrazení.
CListCtrl::SetTileViewInfo	Nastaví informace, který používá ovládací prvek seznamu zobrazení v zobrazení vedle sebe.
CListCtrl::SetToolTips	Nastaví ovládací prvek tooltip, bude ovládací prvek seznamu zobrazení lze zobrazit popisy tlačítek.
CListCtrl::SetView	Nastaví zobrazení ovládacího prvku seznamu zobrazení.
CListCtrl::SetWorkAreas	Nastaví oblast, kde můžete ikony zobrazí ovládací prvek seznamu zobrazení.
CListCtrl::SortGroups	Seřadí seznam skupin zobrazit ovládací prvek s uživatelem definované funkce.
CListCtrl::SortItems	Seřadí položky seznamu zobrazení pomocí funkce porovnání definované aplikací.
CListCtrl::SortItemsEx	Seřadí položky seznamu zobrazení pomocí funkce porovnání definované aplikací.
CListCtrl::SubItemHitTest	Zobrazit položku seznamu, která určuje, zda existuje, je na dané pozici.
CListCtrl::Update	Vynutí ovládací prvek, který chcete překreslit zadanou položku.

Poznámky

Ikona a popisek může mít každá položka informace zobrazené v sloupce napravo od ikona a popisek.Tento ovládací prvek (a proto CListCtrl třídy) je k dispozici pouze pro programy pracující v systému Windows 95 a Windows 98 a Windows NT verze 3.51 a vyšší.

Následuje stručný přehled CListCtrl třídy.Podrobné rámcové diskuse, viz Pomocí CListCtrl a prvky.

Zobrazení

Ovládací prvky pro zobrazení seznamu můžete zobrazit jejich obsah čtyřmi různými způsoby nazývá "zobrazení"

Zobrazení Ikona

Každá položka je zobrazena jako ikona plné velikosti (32 x 32 pixelů) s popiskem pod ním.Uživateli přetáhnout na libovolné místo v okně zobrazení seznamu položky.
Malé ikony

Každá položka se zobrazí jako malé ikony (16 x 16 pixelů) s popiskem vpravo od něj.Uživateli přetáhnout na libovolné místo v okně zobrazení seznamu položky.
Zobrazení seznamu

Každá položka se zobrazí jako malé ikony s popiskem vpravo od něj.Položky jsou uspořádány do sloupců a nelze přetáhnout na libovolné místo v okně zobrazení seznamu.
Zobrazení sestavy

Každá položka je zobrazena na samostatném řádku s dalšími informacemi, které jsou uspořádány ve sloupcích vpravo.První sloupec obsahuje malou ikonu a popisek a následné sloupce obsahují podřízené položky uvedené v žádosti.Ovládací prvek vložené záhlaví (třída CHeaderCtrl) implementuje tyto sloupce.Další informace o řízení záhlaví a sloupce v zobrazení sestavy viz pomocí CListCtrl: přidání sloupců do ovládacího prvku (v zobrazení sestavy).

Viz také:

Článek Q250614 znalostní báze: postupy: řazení položek v CListCtrl v zobrazení sestavy
Článek Q200054 znalostní báze: PRB: OnTimer() je není volána opakovaně pro ovládací prvek seznamu

Určuje styl ovládacího prvku zobrazení aktuálního seznamu aktuální zobrazení.Další informace o těchto stylů a jejich použití naleznete v CListCtrl použití: Změna stylů seznamů řízení.

Rozšířené styly

Kromě standardního seznamu stylů třídy CListCtrl podporuje rozsáhlé sady rozšířených styly, obohaceného funkcí.Některé příklady funkce:

Výběr přechodu

Pokud je povolena, umožňuje automatický výběr položky při kurzor zůstane nad položku pro určité časové období.
Zobrazení virtuálního seznamu

Po povolení umožňuje ovládání podporovat až DWORD položek.To je možné umístěním režie na správu dat položky v aplikaci.Kromě výběru zboží a informace o zaměření musí spravovat všechny informace o položce aplikace.Další informace naleznete v CListCtrl použití: virtuální ovládací prvky seznamu.
One– a two–, klepněte na tlačítko aktivace

Po povolení umožňuje aktivní sledování (automatické zvýraznění textu položky) a one– nebo two– na aktivaci zvýrazněné položky.
Přetáhnout sloupec řazení

Pokud je povolena, umožňuje pořadí sloupců v zobrazení ovládacího prvku seznam a přetažení.Dostupné pouze v zobrazení sestavy.

Rozšířené informace o používání těchto nových stylů, naleznete v CListCtrl použití: Změna seznamu řízení styly.

Položek a podpoložek

Jednotlivé položky v zobrazení Seznam se skládá z ikony (seznam obrázků), popisek, aktuální stav a hodnotou definované aplikací (dále jako "data položky").Jeden nebo více podřízených složek může být také spojeno s každou položkou."Podpoložku" je řetězec, který v zobrazení sestavy lze zobrazit ve sloupci vpravo od položky ikona a popisek.Všechny položky v ovládacím prvku seznamu zobrazení musí mít stejný počet podřízených složek.

Třída CListCtrl pro vložení, odstranění, hledání a úprava těchto položek obsahuje několik funkcí.Další informace naleznete v CListCtrl::GetItem, CListCtrl::InsertItem, a CListCtrl::FindItem, CListCtrl pomocí: přidávání položek ovládacího prvku, a CListCtrl pomocí: posouvání, uspořádání, řazení a vyhledávání v seznamu ovládacích.

Standardně je zodpovědný za ukládání atributů text a ikona položky ovládací prvek seznamu zobrazení.Však kromě těchto typů položek třídy CListCtrl podporuje zpětné volání položky." "Položka zpětného volání" je seznam zobrazit položku, pro které aplikace – místo ovládacího prvku – uloží text nebo ikonu.Zpětné volání maska se používá k určení aplikace dodávají zboží atributy (text a ikona).Pokud aplikace používá zpětné volání položky, musí být schopen na požádání atributy textu nebo ikonu.Zpětné volání položky jsou užitečné, pokud je již aplikace udržuje některé informace.Další informace naleznete v CListCtrl použití: zpětné volání položky a maska zpětné volání.

Seznam obrázků

Ikony, záhlaví položky obrazy a application– definované státy seznam zobrazit položky obsažené v několika seznamů obrazu (třídou implementována CImageList), které vytvoříte a přiřadíte ovládací prvek seznamu zobrazení.Každý ovládací prvek seznamu zobrazení může mít až čtyři různé typy seznamů obrazu:

Velké ikony

Použít v zobrazení ikony pro plné velikosti ikon.
Malé ikony

Používá se v malé ikony, seznam a zobrazení sestav pro menší verze ikony používané v zobrazení ikony.
Stát definované aplikací

Obsahuje obrázky státu, které se zobrazí vedle položky ikony k označení stavu definované aplikací.
Položky záhlaví

Malé obrázky, které se zobrazí v každé položce řízení záhlaví jsou použity v zobrazení sestavy.

Ve výchozím zobrazení ovládacího prvku seznam ničí seznamy obrazu přiřazena při zničeno; Vývojář můžete upravit toto chování však zničení každý obraz seznam již používá, dle aplikace.Další informace naleznete v CListCtrl použití: položky seznamu a zobrazí obraz.