ListVIEW

ListView informacje podstawowe.

    Obiekt ListView jest jednym spośród najmniej opisanych i najrzadziej używanych obiektów, wynika to pewnie stąd, że nie bardzo wiadomo jak go używać, a pomoc środowiska BCB na temat tego obiektu jest bardzo uboga i mało przejrzysta. W tej poradzie przedstawię możliwości tego obiektu tylko ogólnie, kolejne porady będą prezentowały w sposób szczegółowy zastosowanie tego obiektu.
    ListView może być stosowany podobnie jak ListBox, jednak może dodatkowo zawierać oprócz elementów Items, również elementy SubItems, dodatkowo komponent posiada możliwość tworzenia kolumn. Przed utworzeniem listy w obiekcie należy najpierw utworzyć minimum jedną kolumnę poprzez wybranie w Inspektorze Obiektów właściwości Columns. Utworzenie jednej kolumny umożliwia utworzenie tylko listy przypominającej ListBox, jednak w odróżnieniu od tego obiektu możliwe jest włączenie nagłówka poprzez ustawienie właściwości ShowColumnHeader na true. ListView posiada dwa zasadnicze elementy umieszczające wartości na liście, pierwszy element to właściwość Items, kliknięcie na tej właściwości w Inspektorze Obiektów wywoła okno ListView Items Editor, w oknie tym można klikając na przycisku New Item utworzyć nowy element listy (Items), jest ona zawsze umieszczany w pierwszej kolumnie, przy czym kolumny numerowane są od 0, więc element ten jest umieszczany w kolumnie 0. Nazwę temu elementowi nadaje się poprzez wypełnienie jego właściwości Caption. Do każdej właściwości Items można przypisać właściwość SubItems klikając na przycisku New SubItem. Właściwość SubItems jest zawsze przypisywana do zaznaczonej właściwości Items i można tworzyć wiele tych właściwości przypisanych do różnych właściwości Items. Właściwości SubItems są umieszczane w kolejnych kolumnach obiektu ListView, więc jeżeli np. utworzymy 4 kolumny to możemy utworzyć tylko dla każdej właściwości Items tylko 3 właściwości SubItems, jeśli utworzymy ich więcej, to wszystkie ponad 3 nie będą widoczne. Można tworzyć dowolną liczbę Items i jak napisałem wyżej ta właściwość zawsze jest umieszczana w kolumnie 1 (kolumna 0), natomiast właściwości SubItems są umieszczane w kolejnych kolumnach, w kolejności w jakiej są dodawane do listy.

Właściwości Items w połączeniu z SubItems są dostępne dla ListView tylko wtedy gdy jego właściwość ViewStyle jest ustawiona na vsReport, w pozostałych przypadkach widoczna jest tylko właściwość Items, a SubItems jest ignorowana. Istnieje możliwość przypisywania właściwościom Items i SubItems ikon poprzez dodanie do projektu obiektu ImageList i umieszczenia w nim ikon i bitmap. Żeby móc dodawać do właściwości Items ikony, należy we właściwości StateImages włączyć obiekt ImageList. Ikony do właściwości Items przypisuje się poprzez zmianę wartości parametru State Index, wartośc -1 oznacza brak ikony, wszystkie wartości powyżej przypisują kolejne ikony do tej właściwości z obiektu ImageList. Przypisanie obiektu ImageList do właściwości SmallImages i LargeImages umożliwi przypisywanie ikon do właściwości SubItems poprzez właściwość Image Index. Jak widać właściwość Items posiada dwie właściwości umożliwiające przypisanie ikon, pierwsza to Image Index przypisująca ikony do tej właściwości przy ustawionym ViewStyle na vsIcon, pod uwagę brane są ikony umieszczone w obiekcie ImageList przypisanym do LargeImage w trybie vsIcon, natomiast we wszystkich pozostałych trybach ViewStyle przy ustawionym parametrze Image Index brane są pod uwagę ikony umieszczone w ImageList przypisanym do właściwości SmallImages. Druga właściwość State Index bierze pod uwagę ikony umieszczone w ImageList przypisanym do właściwości StateImages obiektu ListView. Parametr State Index jest brany pod uwagę we wszystkich trybach właściwości ViewStyle. Do właściwości Items można przypisać dwie ikony, pierwsza pochodzi z ImageList przypisanego do StateImages, a druga z ImageList przypisanego do SmallImages, a w trybie ViewStyle = vsIcon z ImageList przypisanego do LargeImages. Właściwość SubItems pobiera ikony tylko z ImageList przypisanego do SmallImages i tylko w trybie ViewStyle = vsReport. Kolumnom również można przypisywać ikony, ale tylko w trybie ViewStyle = vsReport i tylko z ImageList przypisanego do właściwości SmallIcon.
W trybie ViewStyle ustawionym na vsIcon wyświetlanę są duże ikony na ListView (o ile zostały przypisane), a pod ikonami przypisywany jest tekst. o tym czy tekst ma być zawijany decyduje właściwość IconOptions -> WrapText. Przy ViewStyle ustawionym na vsSmallIcon wyświetlane są ikony z tekstem po prawej stronie, o tym czy w tych trybach ikony są rozmieszczane w poziomie czy w pionie, decyduje właściwość IconOptions -> Arangement.

Tworzenie listy raportu w trakcie działania programu.

    Lista raportu, zawiera elementy typu Items z przypisanymi do nich elementami SubItems znajdujące się w jednym wierszu, sposób tworzenia takiej listy na etapie programowania opisałem w poradzie ListView informacje podstawowe, dlatego w tej poradzie pokażę jak tworzyć taką listę w trakcie działania programu. Dodawanie nowych elementów Items do listy odbywa się za pomocą funkcji Add(), funkcja nie pobiera żadnych elementów, a tworzy jedynie pusty element typu Items nie zawierający nazwy, nazwę temu elementowi przypisuje się za pomocą właściwości Caption. Właściwość ViewStyle obiektu ListView1 należy ustawić na vsReport:

Na żółto zaznaczyłem wartość liczbową określającą, któremu elementowi listy przypisujemy właściwość Caption. W tak skonstruowanym kodzie, klikanie w przycisk będzie powodowało tworzenie nowych elementów listy (Items) , ale wartość Caption zawsze będzie zmieniana tylko dla pierwszego elementu listy, numerowanie odbywa się od 0. Jeżeli chcemy, żeby przy każdym kliknięciu przycisku przypisywać Caption nowo utworzonemu elementowi, należy dodać zmienną static int:

Należy zwrócić uwagę na dwukrotne użycie funkcji Add() przed dodaniem elementu listy i po jego dodaniu, w poprzednim przykładzie byłoby to niedopuszczalne, a przy tej metodzie jest niezbędne.
Przedstawione przykłady dodawały jak dotychczas do listy tylko elementy Items, ale można oczywiście dodawać również elementy SubItems, przy czym należy można je dodawać razem z elementami Items, lub później podają numer elementu Item do którego ma być przypisany SubItem, oto przykład dodawania elementów SubItems razem z Items - pierwszy z wykorzystaniem operatora static, drugi z wykorzystaniem klasy TListItem:

Zapisywanie i odczytywanie zawartości obiektu ListView do/z pliku.

ListView posiada bardzo ubogą funkcję zapisywania i odczytywania własnej zawartości:

Edytowanie właściwości Item bezpośrednio w obiekcie ListView.

Edytowanie właściwości Item, czyli zmiana wartości może być dokonana za pomocą kodu poprzez zmianę właściwości Caption, o czym było w poradzie tworzenie listy raportu w trakcie działania programu. Ta porada dotyczy jednak innego sposobu, takiego w którym klikając np. dwukrotnie na wybranej właściwości Item poddajemy ją do edycji tak jak to ma np. miejsce w Edit1:

Sortowanie zawartości obiektu ListView

Zawartość kolumn obiektu ListView można posortować klikając na te kolumny z wykorzystaniem funkcji AlphaSort() wywoływanej w zdarzeniu OnColumnClick tegoż obiektu. Właściwość SortType obiektu ListView należy ustawić na stNone.

W celu posortowania kolumn zgodnie z ich zawartości, czyli tekst jest sortowany jako tekst, a liczby jako liczby, można posłużyć się dwiema metodami, które różnią się od siebie tym, że pierwsza metoda zawiera cały mechanizm sortujący w zdarzeniu OnCompare, druga zaś korzysta z funkcji pomocniczej. W obydwu przypadkach trzeba jednak stworzyć funkcję porównującą liczby, taką jak CompareText porównującą tekst, funkcji tej nadam nazwę foo. Zawartość zdarzenia OnCompare również bardzo się zmienia. Do sprawdzania czy mamy do czynienia z tekstem czy z liczbą posłużyłem się prostą metodą try catch, co podczas testowania aplikacji w środowisku BCB może zaowocować zgłaszaniem ostrzeżenia przez kompilator, ale w trakcie normalnej pracy programu tego komunikatu nie będzie, ale to tak na marginesie, żebyś się nie przestraszył, że coś tutaj nie działa.

...powrót do menu.