sgcGrid, zamiennik DBGrid dla Delphi powiązany z danymi
sgcGrid to siatka Delphi powiązana z danymi, która łączy się z TDataSet, którego używa już Twój DBGrid, a następnie grupuje, sumuje, filtruje i eksportuje te same wiersze.
sgcGrid to siatka Delphi powiązana z danymi, która łączy się z TDataSet, którego używa już Twój DBGrid, a następnie grupuje, sumuje, filtruje i eksportuje te same wiersze.
Twój kod bazodanowy nadal działa. Zmienia się tylko siatka i połączenie między siatką a zbiorem danych.
sgcGrid łączy się z FireDAC TFDQuery, TClientDataSet lub dowolnym innym zbiorem danych. Poza tym, co pokazuje TDBGrid, grupuje i sumuje wiersze, filtruje za pomocą wiersza filtrów, filtrów kolumn i panelu wyszukiwania, eksportuje do Excela i aktualizuje zmienione wiersze w miejscu, w VCL i FireMonkey.
TDBGrid czyta swój zbiór danych przez TDataSource. W sgcGrid miejsce TDataSource zajmuje TsgcGridSource_DataSet: ustaw jego Grid i DataSet, zrób go Active, a wiersze się pojawią. Zbiorem danych może być zapytanie FireDAC, TClientDataSet lub dowolny inny potomek TDataSet.
KeyField siatka jest synchronizowana, a nie ładowana od nowa: zmienione wiersze są aktualizowane w miejscu i błyskają, nowe klucze są dołączane, a brakujące klucze usuwane.LiveUpdates sprawia, że siatka podąża za każdym Post, Delete i Refresh zbioru danych.AutoColumns tworzy kolumny z pól, gdy siatka ich nie ma. Zaprojektowane kolumny są zachowywane i dopasowywane przez FieldName.DisableControls, a jego bieżący rekord zostaje przywrócony. Zamknięcie zbioru danych zachowuje wiersze.BooleanFields pokazuje flagę zapisaną jako tekst lub liczba, na przykład S i N, jako pole wyboru.uses
SysUtils, Classes, DB, FireDAC.Comp.Client,
sgcUICore_Canvas, sgcUICore_Theme, sgcUICore_Table, sgcGrid_Columns,
sgcGrid_Data, sgcGrid_Format, sgcGrid_Render, sgcGrid_IO,
sgcGrid_Source_DataSet, sgcGrid_XLSX, sgcGrid_VCL;
procedure TOrdersForm.FormCreate(Sender: TObject);
begin
// the query that fed the TDBGrid stays as it is
qryOrders.Open;
// TsgcGridSource_DataSet takes the place of the TDataSource
FSource := TsgcGridSource_DataSet.Create(Self);
FSource.Grid := sgcVCLGrid1;
FSource.DataSet := qryOrders;
FSource.KeyField := 'ID'; // changed rows update in place
FSource.AutoColumns := True; // columns from the fields
FSource.LiveUpdates := True; // follow Post, Delete and Refresh
FSource.Active := True;
end;
Źródło jest komponentem, więc to samo powiązanie może znaleźć się w pliku formularza i być ustawione w Inspektorze obiektów:
object SourceDB: TsgcGridSource_DataSet
DataSet = cdsProducts
Grid = GridDB
KeyField = 'ID'
end
To samo źródło wiąże siatkę FireMonkey TsgcFMXGrid tym samym kodem. Powiązanie, grupowanie, podsumowania i filtrowanie są częścią każdej edycji, także bezpłatnej edycji Delphi Community.
Wiersze pochodzą ze zbioru danych; grupowanie, podsumowania, filtry i eksport działają w siatce.
GroupBy lub przez przeciągnięcie nagłówka do panelu grupowaniaSummaryTypeOnApplySort przekazuje sortowanie jako nazwy pól, na przykład dla IndexFieldNames zapytania FireDACSaveToXLSX zapisuje skoroszyt Excela bez zewnętrznej biblioteki, grupy jako zwijany konspekt, a sumy grup jako formuły SUBTOTAL (edycja Registered)
Zmienione komórki błyskają, gdy wiersz się aktualizuje.
Dwa poziomy grup, wiersze szczegółów i zabarwione komórki.
Filtruj, a potem sortuj według kilku kolumn.
Powiązany z TClientDataSet przez TsgcGridSource_DataSet.
procedure TOrdersForm.SetupGrid;
begin
// group by region; users drag more columns to the group panel
sgcVCLGrid1.ShowGroupPanel := True;
sgcVCLGrid1.GroupBy(['Region']);
// totals in the footer and in every group row
sgcVCLGrid1.Columns.FindByField('Amount').SummaryType := gsuSum;
sgcVCLGrid1.Columns.FindByField('ID').SummaryType := gsuCount;
sgcVCLGrid1.ShowFooter := True;
// a filter row under the header and the find panel
sgcVCLGrid1.ShowFilterRow := True;
sgcVCLGrid1.ShowFindPanel := True;
end;
procedure TOrdersForm.btnExcelClick(Sender: TObject);
begin
// Registered edition: the sheet keeps the groups and the totals
sgcVCLGrid1.SaveToXLSX('orders.xlsx', 'Orders');
end;
Standardowy TDBGrid z VCL pokazuje i edytuje zbiór danych. Ta tabela wylicza, co każda siatka robi od razu, bez dodatkowego kodu.
| Funkcja | TDBGrid | sgcGrid | Edycja sgcGrid |
|---|---|---|---|
| Powiązanie TDataSet | Przez TDataSource | TsgcGridSource_DataSet z DataSet, Grid i KeyField | Wszystkie |
| Zaprojektowane kolumny | Columns typu TColumn | Columns dopasowane przez FieldName lub AutoColumns | Wszystkie |
| Zmienione wiersze aktualizowane w miejscu, z podświetleniem | No | Tak, przez KeyField | Wszystkie |
| Sortowanie kliknięciem nagłówka | Kod w OnTitleClick | Wbudowane, z OnApplySort dla zbioru danych | Wszystkie |
| Grupowanie i panel grupowania | No | GroupBy, ShowGroupPanel | Wszystkie |
| Podsumowania w stopce i grupach | No | SummaryType gsuSum, gsuCount, gsuAverage, gsuMin, gsuMax | Wszystkie |
| Wiersz filtrów i filtry kolumn | No | ShowFilterRow, ShowFilterButtons | Wszystkie |
| Panel wyszukiwania | No | ShowFindPanel, FindOnlyMatches | Wszystkie |
| Pasma, dopasowanie do zawartości i zapisane układy | No | Bands, BestFitColumns, SaveLayoutToFile, AutoSaveLayout | Wszystkie |
| Kolory komórek bez kodu rysującego | Kod w OnDrawColumnCell | FormatRules, OnGetCellStyle i OnCustomDrawCell do własnego rysowania | Wszystkie |
| Zaznaczanie wielu wierszy | dgMultiSelect, SelectedRows | SelectionMode gsmMultiRow, GetSelectedKeys | Wszystkie |
| Edycja i zapis do zbioru danych | Tak, z dgEditing | WriteBack zapisuje każdą edycję w jej rekordzie, SyncCursor utrzymuje bieżący rekord w zgodzie | Registered |
| Eksport do Excela | No | SaveToXLSX, do pliku lub strumienia | Registered |
| Tabele zbyt duże do załadowania | No | Tryb serwerowy z TsgcGridServerProvider_DataSet, po jednej stronie naraz | Registered |
| FireMonkey | Nie, tylko VCL | TsgcFMXGrid w systemach Windows, macOS, iOS i Android | Wszystkie |
| .NET | No | Siatki WinForms, WPF i Avalonia | Wszystkie |
Zobacz pełną macierz funkcji sgcGrid, testy wydajności i porównanie sgcGrid.
Gdy WriteBack jest włączony, źródło zapisuje każdą edycję siatki w rekordzie jej wiersza. Znajduje rekord przez KeyField i zapisuje wartość. Gdy zapis się nie powiedzie, na przykład w kontroli BeforePost, rekord zostaje anulowany, a komórka zachowuje starą wartość.
SyncCursor utrzymuje bieżący rekord i zaznaczony wiersz razem, więc TDBNavigator i kontrolki TDBEdit na tym samym zbiorze danych podążają za siatką, a siatka za nimiAllowInsert: Ins dołącza i zapisuje rekord, a OnNewRecord zbioru danych wypełnia wartości domyślneApplyFilter sprawia, że zbiór danych zachowuje tylko wiersze, które pokazuje siatka, więc kontrolki DB-aware i raporty na nim widzą przefiltrowane wierszeWriteBack, SyncCursor, wstawianie, usuwanie, wklejanie i cofanie są częścią edycji Registered. Wersja próbna zawiera je do oceny.
Przeczytaj temat pomocy o edycji DataSetTrzy kroki: zaimportuj kolumny w czasie projektowania, zastąp właściwości i zdarzenia, usuń siatkę DB. Dane zostają w tym samym TDataSet.
TsgcVCLGrid obok TDBGrid.TsgcGridSource_DataSet połączony ze zbiorem danych z DataSource, skopiuj granice (Parent, Align, Anchors, TabOrder i inne), skopiuj procedury obsługi zdarzeń i najpierw wyczyść kolumny siatki.Import kopiuje FieldName, Title.Caption do Caption, Width (przeliczone na DIP przy użyciu PixelsPerInch formularza), Visible, Alignment, ReadOnly do Editable oraz PickList. Z kodu to samo robi w czasie działania sgcGridImportDBGrid w jednostce sgcGrid_Import_VCL.
| TDBGrid | sgcGrid |
|---|---|
| TDBGrid | TsgcVCLGrid (jednostka sgcGrid_VCL) |
| DataSource | TsgcGridSource_DataSet: DataSet, Grid, KeyField, potem Active := True (jednostka sgcGrid_Source_DataSet) |
| Columns, TColumn.FieldName | Columns, Columns[i].FieldName |
| ReadOnly, Options dgEditing | ReadOnly siatki i WriteBack źródła (Registered) |
| dgRowSelect | SelectionMode := gsmRow |
| dgMultiSelect, SelectedRows | SelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys |
| dgIndicator | RowHeader := [grhIndicator], także grhNumbers i grhCheckBox |
| dgColLines, dgRowLines | GridLinesV, GridLinesH |
| OnDrawColumnCell | OnCustomDrawCell; tylko dla kolorów OnGetCellStyle lub FormatRules |
| OnTitleClick | OnHeaderClick; siatka sortuje sama |
| OnColEnter, OnColExit | OnSelectionChange, z SelectedCol |
Zestaw migracyjny TDBGrid zawiera pełną mapę składowych, kod przed i po z dema MigrateFromDBGrid, które kompiluje się w Delphi 7 i Delphi 13 (Win32 i Win64), oraz znane różnice. Inne zestawy są na stronie migracji sgcUI.
Jeden model siatki napędza siatkę VCL i FireMonkey, więc formularz VCL i formularz FireMonkey współdzielą kod powiązania.
| Cel | Komponent | Platformy |
|---|---|---|
| Delphi 7 do 13, VCL | TsgcVCLGrid | Win32, a Win64 od XE2 |
| Delphi XE6 do 13, FireMonkey | TsgcFMXGrid | Windows, macOS, iOS i Android |
| C++ Builder 2007 do 13 | TsgcVCLGrid, TsgcFMXGrid | Wygenerowane nagłówki .hpp i biblioteki statyczne |
| .NET Framework 4.7.2, .NET 8, 9 i 10 | TsgcWinFormsGrid, siatki WPF i Avalonia | WinForms, WPF, Avalonia |
Import kolumn TDBGrid działa w projektancie formularzy VCL. Formularze FireMonkey wiążą zbiór danych tym samym TsgcGridSource_DataSet.
Powiązanie DataSet z zaprojektowanymi kolumnami dopasowanymi przez FieldName, pola lookup, zaznaczanie komórek, wierszy i wielu wierszy, nagłówek wiersza, własne rysowanie, Ctrl+C, panel grupowania, podsumowania w stopce i grupach, wiersz filtrów, filtr kolumn w stylu Excela, panel wyszukiwania, pasma, dopasowanie do zawartości oraz zapis i odczyt układu JSON. Bezpłatna edycja Delphi Community zawiera sgcGrid.
Edycja dwukierunkowa w zbiorze danych (WriteBack), synchronizacja kursora (SyncCursor), wstawianie, usuwanie, wklejanie i cofanie, eksport do Excela, widok kart i tryb serwerowy dla bardzo dużych tabel. sgcGrid jest sprzedawany osobno z licencjami Single, Team i Site oraz pełnym kodem źródłowym i jest zawarty w sgcUI Standard, Professional, Enterprise i All-Access.
Zobacz cennik sgcGrid lub pobierz wersję próbną, która zawiera wszystkie funkcje Registered do oceny.
Upuść TsgcVCLGrid obok TDBGrid, kliknij go prawym przyciskiem myszy i wybierz Import columns from DB grid. Import kopiuje kolumny, tworzy TsgcGridSource_DataSet połączony z tym samym zbiorem danych, kopiuje granice i procedury obsługi zdarzeń oraz zgłasza zdarzenia do przeniesienia ręcznie. Potem usuń TDBGrid. Zestaw migracyjny mapuje każdą właściwość i zdarzenie.
TDBGrid to kontrolka VCL. sgcGrid ma siatkę FireMonkey, TsgcFMXGrid, dla Delphi XE6 do 13 w systemach Windows, macOS, iOS i Android, a ten sam TsgcGridSource_DataSet wiąże ją z dowolnym TDataSet tym samym kodem co siatkę VCL.
Tak. Wywołaj GroupBy z nazwami pól albo pozwól użytkownikom przeciągnąć nagłówek kolumny do panelu grupowania. Ustaw SummaryType w kolumnie (suma, liczba, średnia, minimum lub maksimum) i włącz ShowFooter: sumy pojawią się w stopce i w każdym wierszu grupy. Grupowanie i podsumowania są częścią każdej edycji, Community również.
Powiąż zbiór danych z sgcGrid i wywołaj SaveToXLSX z nazwą pliku lub strumieniem. Skoroszyt nie wymaga zewnętrznej biblioteki i zachowuje to, co widzi użytkownik: widoczne kolumny w kolejności wyświetlania z ich szerokościami i formatami liczb, zablokowany nagłówek, grupy jako zwijany konspekt i sumy grup jako formuły SUBTOTAL. Eksport do Excela jest częścią edycji Registered; edycja Community eksportuje JSON i CSV.
Tak. TFDQuery lub TFDTable to TDataSet, więc TsgcGridSource_DataSet wiąże je tak samo jak TClientDataSet. OnApplySort przekazuje sortowanie siatki w formie IndexFieldNames FireDAC, na przykład Name;Date:D. Dla tabeli zbyt dużej do załadowania tryb serwerowy (Registered) z TsgcGridServerProvider_DataSet czyta po jednej stronie naraz i pozwala bazie danych sortować, filtrować, liczyć i grupować za pomocą SQL, uruchamianego przez FireDAC lub inny komponent zapytań.
Tak, w edycji Registered. Z WriteBack źródło zapisuje każdą edycję w rekordzie jej wiersza, znalezionym przez KeyField, a SyncCursor utrzymuje bieżący rekord i zaznaczony wiersz razem, więc TDBNavigator i kontrolki TDBEdit na tym samym zbiorze danych pozostają zsynchronizowane. W edycji Community siatka pokazuje zbiór danych tylko do odczytu.