TListView/pl: what changed

Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.

Title: TListView/pl

New		Line
1	+	TListView ![](/wiki-images/d/d7/Tlistview.png) 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	+
3	+	## Uwagi
4	+
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	+
7	+	## Sortowanie
8	+
9	+	`TODO: dodać opis, w jaki sposób OwnerData wpływa na sortowanie`
10	+
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	+
13	+	SortType jest kluczową właściwością w celu wykonania dowolnego sortowania w TListView.
14	+
15	+
16	+	stNone - (wartość domyślna) informująca, że dla danej kontrolki sortowanie nie powinno być wykonywane.
17	+
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	+
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	+
22	+	stBoth - domyślnie traktowane jest jak stText podczas sortowania.
23	+
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	+
26	+
27	+	Sender - TListview, który ma być sortowany
28	+
29	+	Item1 - pierwszy element TListItem użyty do porównania
30	+
31	+	Item2 - drugi element TListItem użyty do porównania z pierwszym
32	+
33	+	Data - nie jest używany i jest zawsze podawany jako zero. (zastosowany dla zgodności z Delphi)
34	+
35	+	Compare - wynik porównania, który musi być ustalony przez zdarzenie. Do argumentu Compare należy przypisać następujące wartości:
36	+
37	+
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	+
40	+	0 - jeśli dwa elementy Item są równe
41	+
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	+
44	+	Normalną praktyką jest odwracanie wartości wyniku porównania, jeśli SortDirection jest malejący. tj.:
45	+
46	+	```delphi
47	+	procedure TForm1.ListView1OnCompare(Sender: TObject; Item1, Item2: TListItem;
48	+	Data: Integer; var Compare: Integer)
49	+	begin
50	+	... zrób porównanie ...
51	+
52	+	if TListView(Sender).SortDirection = sdDescending then
53	+	Compare := -Compare;
54	+	end;
55	+	```
56	+
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	+
59	+	Metoda Sort sortuje elementy, jeśli SortType jest inny niż stNone i SortColumn jest przypisany do prawidłowego indeksu kolumny.
60	+
61	+	Metoda CustomSort wykonuje jednorazowe sortowanie za pomocą dostarczonej funkcji sortowania.
62	+
63	+
64	+	ASortProc: TLVCompare - funkcja sortowania
65	+
66	+	AOptionalParam: PtrInt - parametr sortowania
67	+
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	+
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	+
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	+
74	+	### Wskaźnik kierunku sortowania
75	+
76	+	Pochodzący z: <https://bugs.freepascal.org/view.php?id=36281>
77	+
78	+	In trunk since r62567
79	+
80	+	1\) Dodaj nową właściwość SortIndicator do TListViewColumn. Właściwość ta kontroluje systemowy wskaźnik sortowania.
81	+
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	+
84	+
85	+	siNone - nie powinien być pokazywany żaden wskaźnik sortowania
86	+
87	+	siAscending - powinien być pokazywany wskaźnik rosnący
88	+
89	+	siDescending - powinien być pokazywany wskaźnik malejący
90	+
91	+	Właściwość może działać niezależnie od innych właściwości sortowania TListview.
92	+
93	+	<figure>
94	+	<img src="autosort0.gif" title="autosort0.gif" />
95	+	<figcaption>autosort0.gif</figcaption>
96	+	</figure>
97	+
98	+	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	+
100	+	<figure>
101	+	<img src="autosort2.gif" title="autosort2.gif" />
102	+	<figcaption>autosort2.gif</figcaption>
103	+	</figure>
104	+
105	+	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	+
107	+	## Implementacja widżetów
108	+
109	+	ListView is implemented via TWSCustomListViewClassinterface. ListView jest implementowany za pośrednictwem interfejsu TWSCustomListViewClassinterface.
110	+
111	+	<table>
112	+	<thead>
113	+	<tr>
114	+	<th><p>Metoda</p></th>
115	+	<th><p>Opis</p></th>
116	+	</tr>
117	+	</thead>
118	+	<tbody>
119	+	<tr>
120	+	<td><p>SelectAll</p></td>
121	+	<td><p>Metoda udostępnia parametr <strong>AIsSet</strong>.</p>
122	+	<p>Jeśli parametr jest ustawiony na <strong>true</strong>, wszystkie elementy powinny być wybrane w widoku. Jeśli jest to <strong>false</strong>, wszystkie parametry powinny zostać odznaczone.</p>
123	+	<p>Ważne jest, aby to zdarzenie nie wyzwalało żadnych innych zdarzeń, ponieważ LCL sam wywoła zdarzenie SelectChange.</p></td>
124	+	</tr>
125	+	</tbody>
126	+	</table>
127	+
128	+	## Zobacz także
129	+
130	+	- [[doc:lcl/comctrls/tlistview.html\|Dokumentacja TListView]]
131	+	- [[TTreeView]]
132	+	- [[TShellListView]]
133	+
134	+	---
135	+	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).

Back to history