TListView/pl: what changed

Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.

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