TListView/pl: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | **TListView**  jest wizualnym komponentem na [[Common Controls tab|zakładce Common Controls]] [[Component Palette|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. | |
| 2 | 2 | ||
| 3 | 3 | ## Uwagi | |
| 4 | 4 | ||
| 5 | 5 | - **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. | |
| 6 | 6 | ||
| 7 | 7 | ## Sortowanie | |
| 8 | 8 | ||
| 9 | 9 | `TODO: dodać opis, w jaki sposób OwnerData wpływa na sortowanie` | |
| 10 | 10 | ||
| 11 | 11 | 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). | |
| 12 | 12 | ||
| 13 | 13 | **SortType** jest kluczową właściwością w celu wykonania dowolnego sortowania w TListView. | |
| 14 | 14 | ||
| 15 | 15 | ||
| 16 | 16 | **stNone** - (wartość domyślna) informująca, że dla danej kontrolki sortowanie nie powinno być wykonywane. | |
| 17 | 17 | ||
| 18 | 18 | **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 | |
| 19 | 19 | ||
| 20 | 20 | **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) | |
| 21 | 21 | ||
| 22 | 22 | **stBoth** - domyślnie traktowane jest jak **stText** podczas sortowania. | |
| 23 | 23 | ||
| 24 | 24 | 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: | |
| 25 | 25 | ||
| 26 | 26 | ||
| 27 | 27 | **Sender** - TListview, który ma być sortowany | |
| 28 | 28 | ||
| 29 | 29 | **Item1** - pierwszy element TListItem użyty do porównania | |
| 30 | 30 | ||
| 31 | 31 | **Item2** - drugi element TListItem użyty do porównania z pierwszym | |
| 32 | 32 | ||
| 33 | 33 | **Data** - nie jest używany i jest zawsze podawany jako zero. (zastosowany dla zgodności z Delphi) | |
| 34 | 34 | ||
| 35 | 35 | **Compare** - wynik porównania, który musi być ustalony przez zdarzenie. Do argumentu **Compare** należy przypisać następujące wartości: | |
| 36 | 36 | ||
| 37 | 37 | ||
| 38 | 38 | -1 - jeśli pozycja Item1 powinna pojawić się „wcześniej”, tj. w kolejności rosnącej, niż Item2. (Item1 jest mniejsza niż Item2) | |
| 39 | 39 | ||
| 40 | 40 | 0 - jeśli dwa elementy Item są równe | |
| 41 | 41 | ||
| 42 | 42 | 1 - jeśli pozycja Item2 powinna pojawić się „wcześniej”, tj. w kolejności rosnącej, niż Item1. (Item2 jest mniejsza niż Item1) | |
| 43 | 43 | ||
| 44 | 44 | Normalną praktyką jest odwracanie wartości wyniku porównania, jeśli SortDirection jest malejący. tj.: | |
| 45 | 45 | ||
| 46 | 46 | ```delphi | |
| 47 | 47 | procedure TForm1.ListView1OnCompare(Sender: TObject; Item1, Item2: TListItem; | |
| 48 | 48 | Data: Integer; var Compare: Integer) | |
| 49 | 49 | begin | |
| 50 | 50 | ... zrób porównanie ... | |
| 51 | 51 | ||
| 52 | 52 | if TListView(Sender).SortDirection = sdDescending then | |
| 53 | 53 | Compare := -Compare; | |
| 54 | 54 | end; | |
| 55 | 55 | ``` | |
| 56 | 56 | ||
| 57 | 57 | 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. | |
| 58 | 58 | ||
| 59 | 59 | Metoda **Sort** sortuje elementy, jeśli **SortType** jest inny niż **stNone** i SortColumn jest przypisany do prawidłowego indeksu kolumny. | |
| 60 | 60 | ||
| 61 | 61 | Metoda **CustomSort** wykonuje jednorazowe sortowanie za pomocą dostarczonej funkcji sortowania. | |
| 62 | 62 | ||
| 63 | 63 | ||
| 64 | 64 | ASortProc: TLVCompare - funkcja sortowania | |
| 65 | 65 | ||
| 66 | 66 | AOptionalParam: PtrInt - parametr sortowania | |
| 67 | 67 | ||
| 68 | 68 | 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. | |
| 69 | 69 | ||
| 70 | 70 | 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**. | |
| 71 | 71 | ||
| 72 | 72 | **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. | |
| 73 | 73 | ||
| 74 | 74 | ### Wskaźnik kierunku sortowania | |
| 75 | 75 | ||
| 76 | 76 | Pochodzący z: <https://bugs.freepascal.org/view.php?id=36281> | |
| 77 | 77 | ||
| 78 | 78 | In trunk since r62567 | |
| 79 | 79 | ||
| 80 | 80 | 1\) Dodaj nową właściwość **SortIndicator** do TListViewColumn. Właściwość ta kontroluje systemowy wskaźnik sortowania. | |
| 81 | 81 | ||
| 82 | 82 | 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 | |
| 83 | 83 | ||
| 84 | 84 | ||
| 85 | 85 | **siNone** - nie powinien być pokazywany żaden wskaźnik sortowania | |
| 86 | 86 | ||
| 87 | 87 | **siAscending** - powinien być pokazywany wskaźnik rosnący | |
| 88 | 88 | ||
| 89 | 89 | **siDescending** - powinien być pokazywany wskaźnik malejący | |
| 90 | 90 | ||
| 91 | 91 | Właściwość może działać niezależnie od innych właściwości sortowania TListview. | |
| 92 | 92 | ||
| 93 | - | ||
| 94 | - | ||
| 95 | - | ||
| 96 | - | ||
| 93 | + |  | |
| 97 | 94 | ||
| 98 | 95 | 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**. | |
| 99 | 96 | ||
| 100 | - | ||
| 101 | - | ||
| 102 | - | ||
| 103 | - | ||
| 97 | + |  | |
| 104 | 98 | ||
| 105 | 99 | 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> | |
| 106 | 100 | ||
| 107 | 101 | ## Implementacja widżetów | |
| 108 | 102 | ||
| 109 | 103 | ListView is implemented via TWSCustomListViewClassinterface. ListView jest implementowany za pośrednictwem interfejsu TWSCustomListViewClassinterface. | |
| 110 | 104 | ||
| 111 | - | ||
| 112 | - | ||
| 113 | - | ||
| 114 | - | ||
| 115 | - | ||
| 116 | - | ||
| 117 | - | ||
| 118 | - | ||
| 119 | - | ||
| 120 | - | ||
| 121 | - | ||
| 122 | - | ||
| 123 | - | ||
| 124 | - | ||
| 125 | - | ||
| 126 | - | ||
| 105 | + | **Metoda** | |
| 106 | + | ||
| 107 | + | **Opis** | |
| 108 | + | ||
| 109 | + | SelectAll | |
| 110 | + | ||
| 111 | + | Metoda udostępnia parametr **AIsSet**. | |
| 112 | + | ||
| 113 | + | Jeśli parametr jest ustawiony na **true**, wszystkie elementy powinny być wybrane w widoku. Jeśli jest to **false**, wszystkie parametry powinny zostać odznaczone. | |
| 114 | + | ||
| 115 | + | Ważne jest, aby to zdarzenie nie wyzwalało żadnych innych zdarzeń, ponieważ LCL sam wywoła zdarzenie SelectChange. | |
| 127 | 116 | ||
| 128 | 117 | ## Zobacz także | |
| 129 | 118 | ||
| 130 | 119 | - [[doc:lcl/comctrls/tlistview.html|Dokumentacja TListView]] | |
| 131 | 120 | - [[TTreeView]] | |
| 132 | 121 | - [[TShellListView]] | |
| 133 | 122 | ||
| 134 | 123 | --- | |
| 135 | 124 | *From the Free Pascal wiki, page "TListView/pl", as it stood on 2021-10-31 after a change by Slawek, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |