TListView/pl

│ English (en) │ français (fr) │ polski (pl) │ русский (ru) │

TListView jest wizualnym komponentem na zakładce Common Controls Palety Komponentów, który zapewnia widok listy powiązanych z nim elementów. Elementy mogą być reprezentowane przez jeden z zestawów ikon powiązanych z TImageList: SmallImages, LargeImages i StateImages.

Uwagi

• GetNextItem() wymaga podania StartItem. Jest to niezgodne z GetNextItem() Delphi, gdzie parametr StartItem może mieć wartość nil, co spowoduje wykonanie wyszukiwania od względnego (sterowanego kierunkiem) startu.

Sortowanie

TODO: dodać opis, w jaki sposób OwnerData wpływa na sortowanie

Sortowanie jest (zazwyczaj) stosowane podczas korzystania z vsReport ViewStyle, ponieważ jest oparte na kolumnach (z wymaganym indeksem Sortcolumn). Sortowanie może być czasochłonne w przypadku większej ilości danych (gdy porównywanie elementów zajmuje dużo czasu).

SortType jest kluczową właściwością w celu wykonania dowolnego sortowania w TListView.

stNone - (wartość domyślna) informująca, że dla danej kontrolki sortowanie nie powinno być wykonywane.

stText - tekst komórek powinien być używany do porównania elementów. Istniejący tekst jest kontrolowany przez właściwość SortColumn. Zauważ, że domyślne porównanie sortowania w rzeczywistości traktuje tekst jako Ansi, a nie UTF8. W związku z tym wynik może być niepożądany w przypadku tekstów nieanglojęzycznych

stData - porównanie właściwości Data domyślne traktowane są jako wartości całkowite (przez rzutowanie wskaźnika na liczbę całkowitą) i sortowane według wartości. (w większości przypadków takie sortowanie jest bezużyteczne, chyba że „Dane” to rzeczywista liczba całkowita rzutowana na wskaźnik)

stBoth - domyślnie traktowane jest jak stText podczas sortowania.

Jeśli nie używasz sortowania tekstu, domyślna metoda porównania nie jest najlepszym podejściem, zamiast tego można użyć porównania niestandardowego. Porównanie niestandardowe jest przypisywane do zdarzenia OnCompare TListView, do którego przekazywane są następujące parametry:

Sender - TListview, który ma być sortowany

Item1 - pierwszy element TListItem użyty do porównania

Item2 - drugi element TListItem użyty do porównania z pierwszym

Data - nie jest używany i jest zawsze podawany jako zero. (zastosowany dla zgodności z Delphi)

Compare - wynik porównania, który musi być ustalony przez zdarzenie. Do argumentu Compare należy przypisać następujące wartości:

-1 - jeśli pozycja Item1 powinna pojawić się „wcześniej”, tj. w kolejności rosnącej, niż Item2. (Item1 jest mniejsza niż Item2)

0 - jeśli dwa elementy Item są równe

1 - jeśli pozycja Item2 powinna pojawić się „wcześniej”, tj. w kolejności rosnącej, niż Item1. (Item2 jest mniejsza niż Item1)

Normalną praktyką jest odwracanie wartości wyniku porównania, jeśli SortDirection jest malejący. tj.:

procedure TForm1.ListView1OnCompare(Sender: TObject; Item1, Item2: TListItem;
  Data: Integer; var Compare: Integer)
begin
  ... zrób porównanie ...

  if TListView(Sender).SortDirection = sdDescending then
    Compare := -Compare;
end;

Zdarzenie OnCompare powinno sprawdzać właściwości TListView SortType, SortColumn i SortDirection oraz odpowiednio dostosowywać wynik porównania w zależności od stanu tych właściwości.

Metoda Sort sortuje elementy, jeśli SortType jest inny niż stNone i SortColumn jest przypisany do prawidłowego indeksu kolumny.

Metoda CustomSort wykonuje jednorazowe sortowanie za pomocą dostarczonej funkcji sortowania.

ASortProc: TLVCompare - funkcja sortowania

AOptionalParam: PtrInt - parametr sortowania

Parametr sortowania jest ignorowany (występuje on tylko dla kompatybilności z Delphi). Jeśli ASortProc ma wartość zero, wówczas używane jest sortowanie OnCompare lub sortowanie domyślne.

Zazwyczaj sortowania może zażądać użytkownik. Za każdym razem, gdy użytkownik kliknie nagłówek kolumny, żąda on jakiegoś sposobu sortowania (początkowo rosnąco) albo przełączenia na odwrotną kolejność sortowania (z rosnącego na malejące lub odwrotnie). To nie reguła, ale powszechne oczekiwanie. W przypadku niektórych zbiorów danych wybór sortowania może nie mieć sensu. Jeśli widok listy powinien być sortowany automatycznie, gdy tylko użytkownik kliknie nagłówek kolumny należy użyć właściwość kontrolki TListview AutoSort (wartość domyślna to true). AutoSort nie przyniesie żadnego efektu, gdy właściwość SortType jest ustawiony na stNone.

AlphaSort to wygodna metoda, która zmienia ustawienia na sortowanie rosnąco (SortDirection=sdAscending) w oparciu o tekst (SortType=stText) pierwszej kolumny (SortColumn=0). Zwróć uwagę, że rzeczywiste właściwości uległy zmianie.

Wskaźnik kierunku sortowania

Pochodzący z: https://bugs.freepascal.org/view.php?id=36281

In trunk since r62567

1) Dodaj nową właściwość SortIndicator do TListViewColumn. Właściwość ta kontroluje systemowy wskaźnik sortowania.

Wskaźnik ten pełni wyłącznie funkcję informacyjną. Reprezentuje graficznie kierunek sortowania (ale nie ma żadnego wpływu na sortowanie). Wskaźnik ma 3 możliwe wartości

siNone - nie powinien być pokazywany żaden wskaźnik sortowania

siAscending - powinien być pokazywany wskaźnik rosnący

siDescending - powinien być pokazywany wskaźnik malejący

Właściwość może działać niezależnie od innych właściwości sortowania TListview.

2) Dodaj nową właściwość AutoSortIndicator do TListView. Właściwość używa się jako uzupełnienie właściwości AutoSort. Jeśli oba są włączone, kod LCL kontroluje bieżący wybór wskaźnika sortowania kolumn zgodnie z regułami AutoSort.

Na początku 2021 r. zauważono, że jeśli używasz Qt5 i masz TListView.SortDirection ustawioną na sdAscending (domyślnie), to ustawienie wskaźnika sortowania kolumny na siDescending wyświetla wskaźnik rosnący. Nie dzieje się tak z GTK2 lub GTK3. Ustawienie SortDirection na sdDescending sprawia, że ​​wszystkie inne kombinacje działają dobrze, więc wydaje się łatwym rozwiązaniem. Zobacz: https://bugs.freepascal.org/view.php?id=38393

Implementacja widżetów

ListView is implemented via TWSCustomListViewClassinterface. ListView jest implementowany za pośrednictwem interfejsu TWSCustomListViewClassinterface.

Metoda	Opis
SelectAll	Metoda udostępnia parametr AIsSet. Jeśli parametr jest ustawiony na true, wszystkie elementy powinny być wybrane w widoku. Jeśli jest to false, wszystkie parametry powinny zostać odznaczone. Ważne jest, aby to zdarzenie nie wyzwalało żadnych innych zdarzeń, ponieważ LCL sam wywoła zdarzenie SelectChange.

Zobacz także

• Dokumentacja TListView
• TTreeView
• TShellListView