CListCtrl

Opis

Obiekt CListCtrl wyświetla kolekcję elementów, z których każdy składa się z ikony (lista obrazków) i etykiety. W dodatku do ikony i etykiety można dołączyć dodatkową informację, która wyświetlana jest w kolejnych kolumnach. kontrolki tej mogą używać tylko piszący pod Windows 95 i Windows NT wersji 3.51 i późniejsze.

Kontrolka posiada kilka możliwych sposobów wyświetlania informacji:

Widok ikon.
Każdy element pojawia się jako ikona (32 X 32 piksele) z etykietą poniżej ikony. Użytkownik może przeciągać ikony w obrębie listy.
Widok małych ikon.
Każdy element pokazywany jest jako mała ikona (16 X 16 piksele) z etykietą na prawo od ikony. Użytkownik może przeciągać elementy w obrębie listy.
Widok listy.
Każdy element pojawia się jako mała ikona z etykietą z prawej strony. Elementy poukładane są w kolumy i nie mogą być przeciągane.
Widok raportu.
Każdy element pojawia się w oddzielnej lini z dodatkowymi informacjami dołączonymi jako kolumny. Kolumna najbardziej na lewo zawiera małą ikonę i etykietę. Nagłówki kolumn pamiętane są w obiekcie CHeaderCtrl.

Rodzaj widoku ustala się poprzez nadanie kontrolce odpowiedniego stylu.

Domyślnie lista elementów jest usuwana automatycznie kiedy usuwana jest kontrolka. Jednakże projektant może usuwać tę listę gdy uzna, że nie jest już potrzebna.

Metody

Metody	Opis
CListCtrl	Konstruktor obiektu CListCtrl
Create	Tworzy standardową kontrolkę Windows i kojarzy ją z obiektem CListCtrl
GetBkColor	Zwraca color tła listy.
SetBkColor	Ustawia kolor tła listy.
GetImageList	Zwraca uchwyt do listy obrazków.
SetImageList	Kojarzy listę obrazków z obiektem CListCtrl.
GetItemCount	Zwraca ilość elementów na liście.
GetItem	Zwarca atrybuty elementu listy.
SetItem	Ustawia atrybuty elementu listy.
GetNextItem	Wyszukuje następnego z odpowiednimi flagami elementu na liście.
GetFirstSelectedItemPosition	Zwraca indeks pierwszego zaznaczonego elementu.
GetNextSelectedItem	Zwraca następny indeks zaznaczonego elementu.
GetItemRect	Zwraca rozmiar elementu.
SetItemPosition	Przesuwa element na wskazaną pozycję.
GetItemPosition	Pobiera pozycje dla wskazanego elementu.
GetStringWidth	Wyznacza minimalną szerokość kolumny konieczną do wyświetlenia napisów.
GetEditControl	Zwraca uchwyt do obiektu CEdit.
GetColumn	Pobiera atrybuty kolumny.
SetColumn	Ustawia atrybuty kolumny.
GetColumnWidth	Zwraca szerokość kolumny dla widoku raport.
SetColumnWidth	Ustawia szerokość kolumny dla widoku raport.
GetViewRect	Zwraca rozmiar wszystkich widocznych elementów.
GetTextColor	Pobiera kolor tekstu.
SetTextColor	Ustawia kolor tekstu.
GetTextBkColor	Pobiera kolor tła tekstu.
SetTextBkColor	Ustawia kolor tła tekstu.
GetTopIndex	Zwraca indeks pierwszego widocznego elementu.
SetItemState	Zmienia stan elementu listy.
GetItemState	Odczytuje stan elementu listy.
GetItemText	Zwraca tekst elementu w okreslonej kolumnie i wierszu.
SetItemText	Zmienia tekst w określonej kolumnie i wierszu.
SetItemCount	Przygotowuje miejsce na dużą porcję nowych elementów.
GetSelectedCount	Zwraca liczbę zaznaczonych elementów.
SetIconSpacing	Ustawia odległość pomiędzy ikonami.
GetHeaderCtrl	Zwraca obiekt CHeaderCtrl związany z obietkem CListCtrl.
GetBkImage	Zwraca bieżący obrazek zastosowany do tła kontrolki.
SetBkImage	Ustawia obrazek jako tło kontrolki.
InsertItem	Wstawia element na listę.
DeleteItem	Usuwa element z listy.
DeleteAllItems	Usuwa wszystkie elementy z listy.
FindItem	Wyszukuje elementy na liście o określonych właściwościach.
SortItems	Funkcj sortująca elementy na liście.
Scroll	Przewijanie widoku kontrolki.
EditLabel	Edycja etykiet elementów listy.
InsertColumn	Wstawienie nowej kolumny.
DeleteColumn	Usunięcie kolumny z listy.

Przykłady:

Inicjowanie kolumn w raporcie, Dopisanie wiersza w raporcie, Pobranie wszystkich zaznaczonych pozycji

Zobacz także:

CImageList

Hierarchia