sgcGrid Macierz funkcji
Wszystko, co potrafi sgcGrid, pogrupowane według zadań, z linkiem do tematu pomocy każdej funkcji. Ten sam model napędza siatki VCL, FireMonkey, WinForms, WPF i Avalonia.
Wszystko, co potrafi sgcGrid, pogrupowane według zadań, z linkiem do tematu pomocy każdej funkcji. Ten sam model napędza siatki VCL, FireMonkey, WinForms, WPF i Avalonia.
Funkcje: 6
Funkcje: 27
Funkcje: 4
Funkcje: 26
Funkcje: 14
Funkcje: 4
Pakiety NuGet: 8
Pomoc online i podręczniki PDF
Zarejestrowana oznacza funkcje, które są w edycji zarejestrowanej i wersji próbnej, a nie ma ich w bezpłatnej edycji Community. ~ oznacza funkcję, którą Community ma tylko częściowo, z różnicą poniżej.
Każdy wiersz prowadzi do swojego tematu pomocy. Kolumna Community pokazuje, co zawierają bezpłatne edycje Community dla Delphi i .NET; wszystko jest w edycji zarejestrowanej i wersji próbnej.
Filtry kolumn, wiersz filtra, panel wyszukiwania, wybór kolumn, zmiana kolejności kolumn, optymalna szerokość, układy, zaznaczanie wielu wierszy, pasma kolumn, typy komórek, edycja DataSet, wklejanie, cofnij i edytory komórek z sgcEditors są w siatkach VCL i FireMonkey dla Delphi i C++ Buildera oraz w siatkach WinForms, WPF i Avalonia dla .NET, z tym samym podziałem między Community i Zarejestrowaną, opisanym w temacie Edycje. W .NET edycja DataSet zapisuje zmiany do DataTable, AddLookup dodaje kolumny lookup, a SyncCursor jest tylko w Delphi.
| Funkcja | Szczegóły | Community | Pomoc |
|---|---|---|---|
| Aktualizacje na żywo z dowolnego wątku | Data.AppendRow i Data.UpdateRow są bezpieczne wątkowo. Aktualizuj jedno lub wiele pól według klucza, a BeginUpdate i EndUpdate łączą serię zmian w jedno odświeżenie, taktowane przez MaxFPS. | Pomoc | |
| Miganie przy zmianie | Zmienione komórki migają na zielono, gdy wartość rośnie, i na czerwono, gdy maleje, a potem zanikają. Tryb tail utrzymuje w widoku najnowsze wiersze dziennika lub strumienia. | Pomoc | |
| Tryb wirtualny | Nie przechowuje wierszy: VirtualRowCount ustawia liczbę, a OnGetValue zwraca każdą rysowaną wartość, więc milion wierszy kosztuje tyle samo co pięćdziesiąt. | Pomoc | |
| Lista alarmów ISA-18.2 | TsgcGridAlarmModel przechowuje alarmy HMI ze stanami ISA-18.2 (aktywny niepotwierdzony, aktywny potwierdzony, powrót do normy niepotwierdzony, normalny, odłożony i wyciszony) oraz priorytetami od 1 do 4. Aplikacja wywołuje RaiseAlarm i ClearAlarm, operator używa Acknowledge, AcknowledgeAll, Shelve i Unshelve, a FilterPriorities, FilterStates i FilterText filtrują listę, którą można wyeksportować jako JSON lub CSV. TsgcGridAlarmLink pokazuje ją w siatce, jeden wiersz na tag, z kolorami priorytetów i migającymi wierszami niepotwierdzonymi, a TsgcVCLGridAlarmMenu dodaje menu kontekstowe (TsgcFMXGridAlarmMenu w FireMonkey oraz menu WinForms, WPF i Avalonia w .NET). | Pomoc | |
| Dziennik potwierdzeń alarmów | Każde potwierdzenie, odłożenie, przywrócenie, wyciszenie i wyłączenie wyciszenia oraz każde odłożenie, które wygasa, dodaje do Log wpis z czasem i użytkownikiem oraz wywołuje OnLog, na przykład w celu zapisu do bazy danych. SaveToJSON i SaveToCSV zapisują dziennik. | Zarejestrowana | Pomoc |
| Przeglądarka dzienników | TsgcGridLogModel przechowuje w buforze cyklicznym wiersze dziennika z czasem, poziomem od trace do fatal, źródłem i komunikatem, a wątki robocze dołączają wiersze bezpośrednio. TsgcGridLogLink pokazuje je w siatce w trybie wirtualnym, pokolorowane według poziomu, filtrowane według poziomu, źródła i tekstu, z regułami wyróżniania, śledzeniem końca, które zatrzymuje się, gdy użytkownik przewija w górę, wstrzymywaniem i wznawianiem oraz eksportem do tekstu, JSON i CSV. | Pomoc |
| Funkcja | Szczegóły | Community | Pomoc |
|---|---|---|---|
| Sortowanie | Sortuj według kilku kolumn za pomocą SortOrder i SortIndex; Ctrl i kliknięcie dodaje kolumnę. Sortowanie jest stabilne. | Pomoc | |
| Filtrowanie | FilterText zachowuje wiersze zawierające tekst w dowolnej widocznej kolumnie, a OnFilterRow dodaje własne reguły. | Pomoc | |
| Zaznaczanie i klawiatura | Zaznaczanie wierszy lub komórek przez SelectionMode, nawigacja klawiaturą, a Ctrl+C kopiuje jako tekst rozdzielany tabulatorami. Zaznaczenie podąża za swoim kluczem. | Pomoc | |
| Zmiana szerokości kolumn | Użytkownicy przeciągają krawędź nagłówka, aby zmienić szerokość kolumny, nigdy poniżej jej MinWidth; OnColumnResized to zgłasza. | Pomoc | |
| Kolumny wypełniające szerokość | AutoFitColumns dzieli szerokość siatki między kolumny proporcjonalnie do ich szerokości, Column.AutoFit ustawione na False zachowuje stałą szerokość, a MaxWidth ogranicza kolumnę przy zmianie rozmiaru lub dopasowaniu. | Pomoc | |
| Zamrożone kolumny | FrozenColumns utrzymuje pierwsze widoczne kolumny na miejscu, gdy reszta się przewija; nagłówek, stopka i podsumowania grup podążają za nimi. | Pomoc | |
| Przypięte wiersze | PinRow utrzymuje wiersze na górze, pod nagłówkiem, lub na dole, nad stopką, gdy pozostałe się przewijają. Przypięte wiersze zachowują kolejność przypięcia, podążają za filtrem, opuszczają swoje grupy i są zapisywane z układem. W VCL, FireMonkey, WinForms, WPF i Avalonia. | Pomoc | |
| Formatowanie warunkowe | Reguły formatowania kolorują komórkę lub cały wiersz, gdy wartość spełnia warunek, z półprzezroczystymi kolorami, które barwią komórkę na tle. | Pomoc | |
| Style czcionek i zestawy ikon | Reguły formatowania ustawiają kursywę, podkreślenie i przekreślenie oprócz pogrubienia, a OnGetCellFont ustawia styl i rozmiar czcionki dowolnej komórki. AddIconSet dodaje strzałki, kółka, flagi lub znaczniki wyboru na podstawie dwóch progów, a reguła może pokazać ikonę lub własny obraz. | Pomoc | |
| Paski danych i skale kolorów | AddDataBar rysuje pasek za każdą liczbą kolumny, z własnym kolorem dla wartości ujemnych, a AddColorScale miesza tło komórki między dwoma lub trzema kolorami. Zakres to najniższa i najwyższa wartość, stała liczba lub percentyl i podąża za danymi. | Pomoc | |
| Od prawej do lewej (arabski i hebrajski) | Kolumny układają się od prawej, a zablokowane kolumny leżą przy prawej krawędzi; pasek przewijania, wcięcie drzewa i grup, szewrony, ikony nagłówków, stopka i edytor w komórce są odbite lustrzanie. Liczby i daty pozostają fragmentami od lewej do prawej. SaveToXLSX (Registered) zapisuje arkusz od prawej do lewej, także przez TsgcGridXLSXWriter.RightToLeft. | Pomoc | |
| Filtr kolumny | Lejek w każdym nagłówku (ShowFilterButtons) otwiera okienko z unikalnymi wartościami kolumny i ich liczbą, polem wyszukiwania i maksymalnie dwoma typowanymi warunkami połączonymi przez I albo LUB. | Pomoc | |
| Wiersz filtra | ShowFilterRow dodaje pod nagłówkiem wiersz, który filtruje każdą kolumnę podczas pisania, z operatorem dla każdej kolumny w FilterRowOperator. | Pomoc | |
| Okresy dat | Kolumny dat filtrują według: dziś, wczoraj, ten lub poprzedni tydzień, miesiąc albo rok oraz ostatnie N dni, w filtrze kolumny i w wierszu filtra. FirstDayOfWeek ustawia początek tygodnia, który domyślnie zależy od ustawień regionalnych. | Pomoc | |
| Panel wyszukiwania | Ctrl+F lub ShowFindPanel podświetla tekst w każdej komórce, F3 i Shift+F3 przechodzą między trafieniami, a FindOnlyMatches ukrywa pozostałe wiersze. | Pomoc | |
| Wybór kolumn i menu nagłówka | Kliknięcie prawym przyciskiem nagłówka sortuje, grupuje, dopasowuje szerokości, filtruje i otwiera wybór kolumn, okienko z polem wyboru dla każdej kolumny. ShowColumnChooser otwiera go z kodu. | Pomoc | |
| Obrazy i przyciski w nagłówkach | HeaderImageIndex pokazuje obraz przed nagłówkiem, HeaderButton dodaje przycisk wywołujący OnHeaderButtonClick, a OnHeaderClick może pominąć sortowanie po kliknięciu nagłówka. | Pomoc | |
| Zmiana kolejności kolumn | Użytkownicy przeciągają nagłówek, aby przenieść jego kolumnę, po swojej stronie kolumn zamrożonych i w obrębie swoich pasm; OnColumnMoved zgłasza przeniesienie. | Pomoc | |
| Dopasowanie szerokości | Dwukrotne kliknięcie krawędzi nagłówka albo BestFitColumn i BestFitColumns dopasowuje szerokość do nagłówka i do 1000 próbkowanych wierszy. | Pomoc | |
| Zapis układu | SaveLayoutToString, SaveLayoutToStream i SaveLayoutToFile zapisują kolejność kolumn, szerokości, widoczność, sortowanie, grupowanie, filtry kolumn i pasma jako wersjonowany JSON, a metody Load je przywracają. | Pomoc | |
| Układy automatyczne | Dzięki AutoSaveLayout siatka zapisuje swój układ przy zamykaniu i przywraca go przy następnym uruchomieniu, w pliku dla każdej siatki lub przez OnSaveLayout i OnLoadLayout. Reset layout w menu nagłówka przywraca kolumny z czasu projektowania. | Pomoc | |
| Zaznaczanie wielokrotne | gsmMultiRow zaznacza dowolny zestaw wierszy, a gsmCellRange jeden zakres komórek, z Ctrl, Shift i Ctrl+A. Zaznaczenie jest trzymane według klucza wiersza, a Ctrl+C kopiuje je jako tekst rozdzielony tabulatorami. | Pomoc | |
| Nagłówek wierszy | RowHeader dodaje pasek po lewej stronie wierszy ze wskaźnikiem rekordu, numerami wierszy i polem wyboru przy każdym wierszu, a pole wyboru w rogu zaznacza lub czyści wszystkie wiersze. SelectionColor i SelectionTextColor ustawiają kolory zaznaczenia. | Pomoc | |
| Przeciąganie wierszy | RowDragMode przeciąga zaznaczone wiersze do innej kontrolki, a w VCL grdOLE upuszcza je w innych aplikacjach, takich jak Excel, jako tekst, CSV i tabelę HTML. OnStartRowDrag może anulować przeciąganie. | Pomoc | |
| Zmiana kolejności wierszy | Z AllowRowMove użytkownik przeciąga zaznaczone wiersze na nowe miejsce, z linią upuszczenia i automatycznym przewijaniem, lub przesuwa je za pomocą Ctrl+Shift+Up i Ctrl+Shift+Down. Każde przesunięcie to jeden krok cofania, OnRowMoving może je zmienić lub odrzucić, a OnRowMoved je zgłasza. W widoku, który nie jest posortowany ani pogrupowany, w siatkach VCL, FireMonkey, WinForms, WPF i Avalonia. | Zarejestrowana | Pomoc |
| Widok kart | Przy ViewStyle ustawionym na gvsCard każdy wiersz jest kartą z opcjonalnym paskiem tytułu, opcjonalnym obrazem i jedną linią na każdą widoczną kolumnę. Karty pokazują te same wiersze co tabela, więc sortowanie, filtry, panel wyszukiwania, zaznaczanie, edycja i tryb serwera działają w obu widokach. CardOptions ustawia CaptionField, ImageField, CardWidth, CardColumns i odstępy. Widok kart nie grupuje. | Zarejestrowana | Pomoc |
| Klawisze i mysz w widoku kart | Klawisze strzałek przechodzą między kartami, Home i End przechodzą do pierwszej i ostatniej karty pasma, Tab przechodzi między polami karty, F2 edytuje pole, a prawy przycisk myszy na tytule pola otwiera menu kolumny, by sortować i filtrować bez nagłówka. | Zarejestrowana | Pomoc |
| Funkcja | Szczegóły | Community | Pomoc |
|---|---|---|---|
| Grupowanie | Grupuj według jednej lub kilku kolumn przez GroupBy albo przeciągając nagłówki na panel grup, z zagnieżdżonymi, zwijanymi wierszami grup. | Pomoc | |
| Podsumowania | Sum, Count, Average, Min i Max przez SummaryType, w każdym wierszu grupy i w stopce, formatowane za pomocą SummaryFormat. | Pomoc | |
| Wiersze drzewa | Hierarchie z kolumny klucza i kolumny rodzica (Tree.KeyField, Tree.ParentField), ze stanem rozwinięcia zapamiętanym dla każdego klucza. | Zarejestrowana | Pomoc |
| Master detail | Pasmo szczegółów z powiązanymi wierszami pod każdym rozwiniętym wierszem nadrzędnym, wypełniane z TsgcGridDataStore, siatki lub OnGetDetailData. | Zarejestrowana | Pomoc |
| Funkcja | Szczegóły | Community | Pomoc |
|---|---|---|---|
| Edycja w miejscu | Edytuj komórki edytorem tekstu albo polem kombi z listą wyboru, z OnValidate, OnEditError i OnEdited. | Zarejestrowana | Pomoc |
| Reguły walidacji | Validation kolumny ustawia Required, MinValue i MaxValue dla liczb, dat i długości tekstu, EditMask oraz Pattern. Reguły działają przy każdym zatwierdzeniu i wklejeniu, przed OnValidate, nieudana komórka jest oznaczona i pokazuje komunikat jako podpowiedź, a ShowValidationErrors oznacza też zapisane wartości łamiące regułę. | Zarejestrowana | Pomoc |
| Powiązanie z DataSet | TsgcGridSource_DataSet wypełnia siatkę z dowolnego TDataSet, tworzy kolumny przez AutoColumns i, z LiveUpdates, śledzi każdy Append, Edit i Delete. W .NET to samo źródło czyta DataTable. | Pomoc | |
| Filtr i sortowanie zestawu danych | Dzięki ApplyFilter zestaw danych zachowuje tylko wiersze pokazywane przez siatkę, więc inne kontrolki na nim widzą te same wiersze, a OnApplySort przekazuje sortowanie siatki jako nazwy pól dla Twojego zapytania. W .NET widok DataTable podąża za filtrem siatki. | Pomoc | |
| Tryb serwera | Komponent dostawcy czyta jedną stronę wierszy naraz, a źródło danych oblicza sortowanie, filtry kolumn, wiersz filtra, tekst wyszukiwania, podsumowania stopki i liczbę wierszy, więc odczytywane są tylko strony widoczne na ekranie: tabela SQLite ze 10 000 000 wierszy otwiera się do pierwszej narysowanej strony w 117 ms (testy wydajności). Wiersze jeszcze niezaładowane pokazują paski zastępcze, a edycje są zapisywane z powrotem przez dostawcę. Wiersze drzewa i pasma szczegółów nie są dostępne w trybie serwera, a okno filtra nie pokazuje liczby wierszy. | Zarejestrowana | Pomoc |
| Dostawcy trybu serwera | TsgcGridServerProvider_DataSet buduje SQL dla SQLite, SQL Server, PostgreSQL, MySQL, Oracle, Firebird, InterBase lub dialektu ogólnego i uruchamia go przez dowolny komponent zapytania, taki jak FireDAC, dbExpress, ADO, IBX, UniDAC lub Zeos. W .NET TsgcGridServerProvider_Queryable czyta dowolny IQueryable, a TsgcGridServerProvider_AdoNet dowolne połączenie ADO.NET. TsgcGridServerProvider_Callback obsługuje każde inne źródło przez zdarzenia, na które odpowiada się z dowolnego wątku. | Zarejestrowana | Pomoc |
| Grupowanie na serwerze | Grupowanie w trybie serwera uruchamia jedną instrukcję GROUP BY na poziom: grupy przychodzą z liczbami wierszy i podsumowaniami, a elementy podrzędne grupy ładują się przy pierwszym jej rozwinięciu. MaxGroups ogranicza liczbę grup wymienionych pod jednym elementem nadrzędnym. | Zarejestrowana | Pomoc |
| Import z TDBGrid (VCL) | W czasie projektowania polecenie Import columns from DB grid w menu kontekstowym siatki kopiuje kolumny, powiązanie z zestawem danych, położenie i zdarzenia kontrolki TDBGrid oraz wymienia to, czego nie udało się skopiować. | Pomoc | |
| Import z cxGrid, DBGridEh i TDBGrid | W czasie projektowania polecenia Import from a grid on this form i Import from a DFM file w siatce VCL oraz Import from a DFM file w siatce FireMonkey odczytują kolumny, pasma, sortowanie, grupowanie i podsumowania widoku cxGrid, DBGridEh lub TDBGrid i wypisują to, czego nie udało się przyporządkować. Narzędzie wiersza poleceń sgcGridMigrate zapisuje układ i raport dla każdej siatki z pliku DFM lub folderu. Delphi. | Pomoc | |
| Powiązanie ItemsSource i MVVM (.NET) | TsgcWpfGrid i TsgcAvaloniaGrid pokazują elementy z ItemsSource, dowolnego IEnumerable, z AutoGenerateColumns, KeyMember i dwukierunkowym SelectedItem. W WPF obowiązuje sortowanie, filtr i grupowanie z ICollectionView, a IsSynchronizedWithCurrentItem śledzi jego bieżący element. TsgcWinFormsGrid wiąże DataSource i DataMember tak jak DataGridView. Z ItemsWriteBack edycje, wstawienia i usunięcia wracają do elementów. | ~Community pokazuje powiązane elementy i śledzi ich zmiany. ItemsWriteBack jest w edycji zarejestrowanej. | Pomoc |
| Kolumny w XAML i w projektancie (.NET) | Elementy TsgcWpfGridColumn i TsgcAvaloniaGridColumn wewnątrz siatki deklarują kolumny z FieldName (ścieżki z kropkami, np. Customer.Country), Caption, DataType i DisplayFormat. W WinForms projektant Visual Studio, na .NET Framework i na .NET 8 lub nowszym, edytuje Columns za pomocą inteligentnego znacznika i edytora kolekcji, a pusta siatka pokazuje przykładowe wiersze w projektancie oraz w podglądach WPF i Avalonia. | Pomoc | |
| JSON i CSV | sgcGrid_IO wczytuje i zapisuje wiersze jako JSON lub CSV (RFC 4180) z ciągów, strumieni i plików, także w Linux64. | Pomoc | |
| JSON i CSV w takiej postaci, jak wyświetlane | SaveToCSV i SaveToJSON siatki zapisują wiersze grup, podsumowania grup i podsumowania stopki, więc plik odpowiada pogrupowanej siatce na ekranie. W VCL, FireMonkey, WinForms, WPF i Avalonia. | Pomoc | |
| Eksport do Excela | SaveToXLSX zapisuje skoroszyt Excela z szerokościami kolumn, formatami liczb, formatami komórek, zamrożonymi panelami, konspektem grup lub drzewa i formułami SUBTOTAL. W trybie Excel zapisuje każdy arkusz z jego formułami i ich obliczonymi wartościami. | Zarejestrowana | Pomoc |
| Eksport do HTML i Worda | SaveToHTML i SaveToDOCX zapisują widok w takiej postaci, w jakiej jest wyświetlany: widoczne kolumny z ich szerokościami, nagłówki pasm, wiersze grup i podsumowania, stopkę oraz kolory motywu i reguł formatowania. Strona Word obraca się do poziomu lub zmniejsza tabelę, gdy kolumny są za szerokie. W VCL, FireMonkey, WinForms, WPF i Avalonia, a TsgcGridHTMLWriter i TsgcGridDOCXWriter zapisują te same pliki z dowolnych danych siatki. | ~Community zapisuje HTML. Word jest w edycji Zarejestrowanej. | Pomoc |
| Tryb Excel | Gdy ExcelMode jest włączony, siatka działa jak lekki arkusz kalkulacyjny: zaznaczanie zakresu z Ctrl+C, uchwyt wypełniania, który kontynuuje serie i przesuwa odwołania w formułach, oraz formuły z odwołaniami A1, odwołaniami do innych arkuszy i funkcjami SUM, AVERAGE, MIN, MAX, COUNT, IF, ROUND i ABS. LoadFromXLSX otwiera skoroszyt Excela, każdy arkusz z jego formułami i formatami komórek, bez zewnętrznej biblioteki. | Zarejestrowana | Pomoc |
| Formatowanie komórek | Pogrubienie, kursywa, podkreślenie, przekreślenie, rozmiar i kolor czcionki, kolor wypełnienia, wyrównanie poziome i pionowe, zawijanie tekstu, format liczb i obramowania dla każdej komórki, ustawiane przez FormatSelection, ToggleSelectionFontStyle lub Ctrl+B, Ctrl+I, Ctrl+U i Ctrl+5 w trybie Excel. Formaty są przechowywane razem z danymi, każda zmiana to jeden krok cofania, a SaveToXLSX i LoadFromXLSX je zachowują. | Zarejestrowana | Pomoc |
| Arkusze | Kilka arkuszy w jednej siatce dzięki AddSheet, RenameSheet, DeleteSheet, MoveSheet i ActiveSheet, a z ShowSheetTabs pasek kart, który przełącza je, dodaje, zmienia ich nazwy i kolejność. Formuły odczytują inne arkusze za pomocą odwołań takich jak Orders!E1:E20 lub 'Q4 Notes'!B1, a zmiana nazwy je przepisuje. | Zarejestrowana | Pomoc |
| Formuły kolumn | Formuła kolumny Formula, na przykład =C1*D1, zapisana dla wiersza 1, oblicza każdy wiersz kolumny tylko do odczytu, na danych w pamięci, w trybie wirtualnym i ze źródłem TsgcGridSource_DataSet. W trybie wirtualnym obliczane są także teksty formuł zwracane przez OnGetValue. | Zarejestrowana | Pomoc |
| Edycja DataSet | Przy WriteBack komponent TsgcGridSource_DataSet zatwierdza zmiany z siatki w ich rekordach, SyncCursor łączy bieżący rekord z zaznaczonym wierszem, a AllowInsert i AllowDelete dodają i usuwają rekordy. Pola lookup są edytowane jako listy wyboru. | Zarejestrowana | Pomoc |
| Wklejanie ze schowka | Ctrl+V wkleja do zakresu komórek tekst rozdzielony tabulatorami z Excela. Każda wartość jest konwertowana i sprawdzana, zanim cokolwiek zostanie zapisane, a wklejenie jest jednym krokiem cofania. | Zarejestrowana | Pomoc |
| Cofnij i ponów | Ctrl+Z i Ctrl+Y cofają i ponawiają zmiany komórek oraz wklejenia według klucza wiersza, do UndoLimit kroków. | Zarejestrowana | Pomoc |
| Edytory komórek | EditorKind wybiera selektor daty, czasu lub daty i czasu, pokrętło, selektor koloru albo edytor tokenów z sgcEditors, a OnCreateEditor umieszcza w komórce dowolną własną kontrolkę. | Zarejestrowana | Pomoc |
| Edytory memo i lookup | gedMemo edytuje długi tekst w wielu wierszach, a gedLookup wybiera wartość z listy o wielu kolumnach, wypełnianej z LookupItems lub z pola lookup zestawu danych. | Zarejestrowana | Pomoc |
| Drukowanie i podgląd wydruku | Print i ShowPrintPreview drukują każdy wiersz tak, jak pokazuje go siatka, przefiltrowany, posortowany i pogrupowany, z nagłówkami pasm i kolumn na każdej stronie i tylko z całymi wierszami na stronie. PrintSettings ustawia raz papier, orientację, marginesy, skalowanie, nagłówek i stopkę dla drukarki, podglądu i PDF. We wszystkich wydaniach, w VCL, FireMonkey, WinForms, WPF i Avalonia (FireMonkey drukuje w systemach Windows i macOS). | Pomoc | |
| Dostępny eksport do PDF, PDF/UA i PDF/A (z sgcPDF) | ExportToPDF zapisuje strony wektorowe z osadzonymi czcionkami i przeszukiwalnym tekstem, a każda strona jest prawdziwą tabelą z komórkami nagłówka dla czytników ekranu. Plik jest domyślnie oznakowanym dokumentem PDF/UA, a PDFALevel dodaje PDF/A-2a lub PDF/A-3a. Wymaga mostka sgcUIPDF i licencjonowanego sgcPDF (esegece.sgcUICore.sgcPDF w .NET). | Zarejestrowana | Pomoc |
| Funkcja | Szczegóły | Community | Pomoc |
|---|---|---|---|
| Motywy | Jasny i ciemny motyw wspólny dla każdego produktu sgcUI: Theme, AccentColor, wysokość wierszy i ustawienia gęstości. Pod ustawieniem wstępnym Fluent siatka przyjmuje kolory Windows 11 i kolor akcentu Windows, a chipy tagów biorą narożniki z RadiusChip ustawienia wstępnego (6 pikseli w Classic, 4 w Fluent). | Pomoc | |
| Renderowanie bez interfejsu | SaveToPNG i SaveToSVG zapisują bieżący widok, a TsgcGridRenderer rysuje samodzielny TsgcGridData do PNG lub SVG, także w systemie Linux64. | Pomoc | |
| Wykresy z siatki | TsgcChartDataSource_Table z sgcCharts rysuje wiersze siatki i podąża za jej sortowaniem i filtrem, bez kodu pośredniczącego. | Pomoc | |
| Pasma kolumn | Nagłówki nad grupami kolumn na wielu poziomach: Bands je przechowuje, a Column.Band przypisuje do jednego z nich kolumnę. | Pomoc | |
| Typy komórek | CellKind rysuje komórkę jako obraz z listy obrazów, pasek postępu albo sparkline liniowy, obszarowy lub słupkowy, a komórka zachowuje swoją zwykłą wartość. gcdTags rysuje kilka kolorowych tagów w jednej komórce z rozdzielonej wartości tekstowej, z automatycznymi kolorami dopasowanymi do motywu lub własnym kolorem dla każdego tagu, znacznikiem +N z pełną listą jako podpowiedzią oraz filtrem według tagu. | Pomoc | |
| Komórki pól wyboru i łączy | TrueValue i FalseValue pokazują pole wyboru w kolumnie przechowującej wartości takie jak S i N, a BooleanFields ustawia je w źródle zestawu danych. Przełączanie pola wymaga edycji Registered. gcdLink pokazuje tekst jako łącze wywołujące OnLinkClick. | Pomoc | |
| Obrazy z pól BLOB | Kolumna gcdImage na polu BLOB rysuje zapisany w nim obraz, OnGetCellImage dostarcza dowolny inny obraz, a ImagePreview pokazuje większą kopię, gdy mysz zatrzyma się nad komórką. | Pomoc | |
| Wielowierszowe nagłówki i wiersze | HeaderLines i RowLines ustawiają wysokość nagłówka i wierszy na kilka linii, a WordWrap zawija tekst kolumny. | Pomoc | |
| Scalanie komórek | Gdy kolumna ma włączone CellMerging, kolejne wiersze z tym samym wyświetlanym tekstem dzielą jedną komórkę. Serie przerywają się na wierszach grup, poziomach drzewa i zamrożonych wierszach, podążają za sortowaniem i filtrowaniem, przerywają się na końcu wydrukowanej strony, a SaveToXLSX (Zarejestrowana) zapisuje je jako scalone komórki. | Pomoc | |
| Wiersz podglądu | ShowPreview i PreviewColumn rysują tekst kolumny, którą można ukryć, pod komórkami każdego wiersza danych na całej jego szerokości, w najwyżej PreviewLines liniach z wielokropkiem. Kliknięcie go zaznacza wiersz, drukowanie go rysuje, a eksporty do HTML, Excela i Worda go zapisują (Excel i Word są w edycji Zarejestrowanej). | Pomoc | |
| Podpowiedzi komórek i nagłówków | ShowTruncatedHints pokazuje jako podpowiedź pełny tekst komórki lub nagłówka, który się nie mieści, a OnGetCellHint ustawia własną podpowiedź dla dowolnej komórki. | Pomoc | |
| Własne rysowanie komórek | Zdarzenie OnCustomDrawCell udostępnia kanwę i prostokąt komórki oraz pozwala zachować lub pominąć domyślną zawartość. Działa także podczas drukowania i eksportu do PDF. OnRenderError zgłasza wyjątek, który wystąpił podczas rysowania siatki. | Pomoc | |
| Dostępność | Udostępniana UI Automation jako tabela z nagłówkami kolumn, wierszami i komórkami, wraz z aktywną komórką, zaznaczeniem, sortowaniem, filtrowaniem, grupowaniem i wierszami drzewa, czyli interfejsem API używanym przez czytniki ekranu, takie jak Narrator i NVDA. Filtrowanie, grupowanie i przesuwanie kolumn mają odpowiedniki w klawiaturze (zmiana szerokości kolumn wymaga myszy), wskaźnik fokusu jest zawsze widoczny, a wysoki kontrast systemu Windows jest uwzględniany. Domyślnie włączona w VCL (Delphi 7 do 13), FireMonkey w systemie Windows, WinForms, WPF i Avalonia. W FireMonkey siatka obsługuje też natywne interfejsy API dostępności systemów macOS, iOS i Android (w Androidzie z biblioteką sgcUIAccess.jar dodaną do projektu). | Pomoc | |
| Dotyk w siatce VCL | Palec przewija TsgcVCLGrid, a z KineticScrolling szybkie machnięcie sprawia, że wiersze suną dalej z bezwładnością Windows. W widoku kart poziome przesunięcie odsłania SwipeActions karty, z OnCardSwipe i OnSwipeAction. Delphi 2010 i nowsze, tylko Delphi. | ~Community ma przewijanie palcem. Akcje przesunięcia wymagają widoku kart, który jest w edycji Zarejestrowanej. | Pomoc |
| Funkcja | Szczegóły | Community | Pomoc |
|---|---|---|---|
| Zapytaj swoją siatkę | TsgcGridAI zamienia pytanie w zwykłym języku na filtry, sortowanie i wyróżnienia wierszy. Bez dostawcy odpowiada lokalny parser oparty na regułach, bez sieci i bez klucza API. Z dostawcą odpowiada dowolny LLM, a parser oparty na regułach przejmuje zadanie, gdy wywołanie się nie powiedzie lub odpowiedź nie przejdzie walidacji. | Pomoc | |
| Pasek zapytań AI (VCL i FireMonkey) | TsgcVCLAIQueryBar i TsgcFMXAIQueryBar, FireMonkey w systemach Windows, macOS, iOS i Android: wpisz pytanie, naciśnij Enter, przeczytaj, co zastosowano, anuluj trwające pytanie i cofnij ostatnią odpowiedź, z ostatnimi pytaniami i podpowiedziami. Działa z klawiaturą, czytnikami ekranu, wysokim kontrastem i układami od prawej do lewej. | Pomoc | |
| Pasek zapytań AI (WinForms, WPF i Avalonia) | TsgcWinFormsAIQueryBar, TsgcWpfAIQueryBar i TsgcAvaloniaAIQueryBar robią to samo w .NET, z jasnym lub ciemnym motywem hosta. | Pomoc | |
| Dowolny LLM | TsgcUIAIEventProvider przekazuje każde żądanie do Twojego kodu w zdarzeniu OnRequest, więc odpowiedzieć może dowolna usługa AI, model lub serwer lokalny. W .NET RequestAsync przyjmuje asynchroniczną procedurę obsługi. | Pomoc | |
| Dostawca AI sgcWebSockets | TsgcUIAIChatProvider z mostu sgcUICoreWS używa komponentu TsgcAIChat z sgcWebSockets na każdej platformie. W .NET pakiet esegece.sgcUICore.sgcWebSockets. Wymaga zarejestrowanego sgcWebSockets. | Zarejestrowana | Pomoc |
| Prywatność | Wysyłane jest tylko pytanie i katalog pól: nazwy, podpisy, typy i domyślnie do 3 przykładowych wartości na kolumnę (MaxSampleValues, SendSampleValues), nigdy wiersze. OnBeforeAsk może edytować lub anulować każde żądanie. | Pomoc |
| Funkcja | Szczegóły | Community | Pomoc |
|---|---|---|---|
| Źródła na żywo | Most sgcGridWS dodaje źródła WebSocket, MQTT i SSE, które zapisują przychodzące komunikaty w siatce. Wymaga sgcWebSockets. | Zarejestrowana | Pomoc |
| Dzienniki na żywo | Źródła WebSocket, MQTT i SSE na żywo z mostu sgcUICoreWS dołączają wiersze dziennika do TsgcGridLogModel z komunikatów JSON (append, batch, clear), a seria z wątku gniazda kosztuje jedną wizytę w głównym wątku. ApplyMessage przyjmuje te same komunikaty z własnego kodu. Wymaga sgcWebSockets. | Zarejestrowana | Pomoc |
| Zapytaj swoją siatkę z asystentem | TsgcGridAIQuery, wcześniejszy komponent mostu, odpowiada przez TsgcHTMLAIAssistant. Nowe projekty mogą używać TsgcGridAI z TsgcUIAIChatProvider. | Zarejestrowana | Pomoc |
| Siatka w przeglądarce | TsgcGridHTML pokazuje siatkę, lub dane siatki bez widocznej siatki, w siatce HTML z sgcHTML, po jednej stronie naraz, ze stronicowaniem i sortowaniem na serwerze, wyświetlanym tekstem siatki, zamrożonymi kolumnami, podsumowaniami stopki i kolorami reguł formatowania. Z Live wysyłane są tylko zmienione wiersze. Wymaga sgcWebSockets; w Delphi i .NET. | Zarejestrowana | Pomoc |
| Możliwość | sgcGrid | Standardowe kontrolki Delphi |
|---|---|---|
| Aktualizuj wiersze według klucza z wątku roboczego, bez Synchronize | — | |
| Zmienione komórki błyskają i zanikają | — | |
| Reguły formatowania dla komórek lub całych wierszy | — | |
| Grupowanie z panelem grup, podsumowaniami grup i stopki | — | |
| Wiersze drzewa i pasma master detail | — | |
| Tabele bazy danych z milionami wierszy stronicowane, sortowane, filtrowane i grupowane przez SQL na serwerze | — | |
| Widok kart tych samych wierszy, z tym samym sortowaniem, filtrami i edycją | — | |
| Eksport skoroszytu Excela z konspektem, formułami, formatami komórek i kilkoma arkuszami | — | |
| Renderowanie PNG i SVG headless, także w Linux64 | — | |
| Okienko filtra kolumny w stylu Excela, wiersz filtra i panel wyszukiwania | — | |
| Wybór kolumn, menu nagłówka i układy zapisane jako JSON | — | |
| Nagłówki pasm nad grupami kolumn | — | |
| Komórki z paskiem postępu, sparkline, obrazem i tagami bez kodu Owner-Draw | — | |
| Kolumny pól wyboru dla dowolnych zapisanych wartości, komórki łączy i obrazy z pól BLOB | — | |
| Wielowierszowe nagłówki i wiersze, obrazy i przyciski w nagłówkach, podpowiedzi dla uciętego tekstu | — | |
| Nagłówek wierszy z polami wyboru i numerami wierszy, przeciąganie wierszy do innych aplikacji | — | |
| Układy zapisywane automatycznie i kolumny wypełniające szerokość siatki | — | |
| Wklejanie zakresu komórek z Excela, z cofnij i ponów | — | |
| Paski danych i skale kolorów | — | |
| Równe wartości scalone w dół kolumny | — | |
| Eksport siatki do HTML i Worda w takiej postaci, jak jest wyświetlana | — | |
| Ta sama siatka w przeglądarce przez sgcHTML | — | |
| Wiersze przypięte na górze lub na dole, gdy pozostałe się przewijają | — | |
| Wiersz podglądu z długim tekstem pod komórkami każdego wiersza | — | |
| Wiersze zmieniane przeciąganiem lub z klawiatury, jako jeden krok cofania | — |
Tylko możliwości, zgodnie z opisem w pomocy. Zmierzone wyniki znajdują się na stronie testów wydajności, a sgcGrid obok komercyjnych siatek Delphi i .NET jest na stronie sgcGrid w porównaniu.
Siatka .NET to port w C# z tymi samymi nazwami klas, dla WinForms, WPF i Avalonia. Zacznij od bezpłatnego pakietu Community, a po wszystkie funkcje sięgnij po pakiety zarejestrowane.
| Pakiet | Edycja | Zawartość |
|---|---|---|
esegece.sgcGrid.Community | Community (bezpłatna) | Biblioteka podstawowa |
esegece.sgcGrid.WinForms.Community | Community (bezpłatna) | Kontrolki Windows Forms |
esegece.sgcGrid.Wpf.Community | Community (bezpłatna) | Kontrolki WPF |
esegece.sgcGrid.Avalonia.Community | Community (bezpłatna) | Kontrolki Avalonia |
esegece.sgcGrid.Rendering.Community | Community (bezpłatna) | Renderowanie bez interfejsu |
esegece.sgcGrid | Zarejestrowana | Biblioteka podstawowa |
esegece.sgcGrid.WinForms | Zarejestrowana | Kontrolki Windows Forms |
esegece.sgcGrid.Wpf | Zarejestrowana | Kontrolki WPF |
esegece.sgcGrid.Avalonia | Zarejestrowana | Kontrolki Avalonia |
esegece.sgcGrid.Rendering | Zarejestrowana | Renderowanie bez interfejsu |
esegece.sgcGrid.sgcWebSockets | Tylko zarejestrowana | Most sgcWebSockets |
esegece.sgcUICore.sgcWebSockets | Tylko zarejestrowana | Dostawca AI sgcWebSockets (TsgcUIAIChatProvider) |
esegece.sgcGrid.sgcHTML | Tylko zarejestrowana | Most sgcHTML |
Każda funkcja sgcGrid jest opisana w pomocy sgcUI, z osobną wersją dla każdego środowiska programistycznego.
Zacznij od wprowadzenia do sgcGrid, a potem przejdź do szybkiego startu i tematów o funkcjach.
Delphi →Cała pomoc sgcUI jako plik PDF, do czytania offline lub wydruku.
Delphi (PDF) →