sgcGrid, ein datenbankfähiger DBGrid-Ersatz für Delphi
sgcGrid ist ein datenbankfähiges Delphi-Grid, das an das TDataSet bindet, das dein DBGrid bereits verwendet, und dieselben Zeilen dann gruppiert, summiert, filtert und exportiert.
sgcGrid ist ein datenbankfähiges Delphi-Grid, das an das TDataSet bindet, das dein DBGrid bereits verwendet, und dieselben Zeilen dann gruppiert, summiert, filtert und exportiert.
Dein Datenbankcode funktioniert weiter. Nur das Grid und die Verbindung zwischen Grid und Dataset ändern sich.
sgcGrid bindet an eine FireDAC-TFDQuery, ein TClientDataSet oder jedes andere Dataset. Zusätzlich zu dem, was TDBGrid zeigt, gruppiert und summiert es Zeilen, filtert mit einer Filterzeile, Spaltenfiltern und einem Suchfeld, exportiert nach Excel und aktualisiert geänderte Zeilen an Ort und Stelle, unter VCL und unter FireMonkey.
Ein TDBGrid liest sein Dataset über eine TDataSource. In sgcGrid übernimmt TsgcGridSource_DataSet die Rolle der TDataSource: Setze Grid und DataSet, aktiviere Active, und die Zeilen erscheinen. Das Dataset kann eine FireDAC-Abfrage, ein TClientDataSet oder jeder andere Nachkomme von TDataSet sein.
KeyField wird das Grid synchronisiert statt neu geladen: Geänderte Zeilen werden an Ort und Stelle aktualisiert und blinken, neue Schlüssel werden angehängt und fehlende Schlüssel gelöscht.LiveUpdates sorgt dafür, dass das Grid jedem Post, Delete und Refresh des Datasets folgt.AutoColumns erzeugt die Spalten aus den Feldern, wenn das Grid keine hat. Entworfene Spalten bleiben erhalten und werden über FieldName zugeordnet.DisableControls durchlaufen, und sein aktueller Datensatz wird wiederhergestellt. Beim Schließen des Datasets bleiben die Zeilen erhalten.BooleanFields zeigt ein als Text oder Zahl gespeichertes Flag, etwa S und N, als Kontrollkästchen.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;
Die Quelle ist eine Komponente, daher kann dieselbe Bindung in der Formulardatei stehen und im Objektinspektor gesetzt werden:
object SourceDB: TsgcGridSource_DataSet
DataSet = cdsProducts
Grid = GridDB
KeyField = 'ID'
end
Dieselbe Quelle bindet ein FireMonkey-TsgcFMXGrid mit demselben Code. Bindung, Gruppierung, Zusammenfassungen und Filterung gehören zu jeder Edition, auch zur kostenlosen Delphi-Community-Edition.
Die Zeilen kommen aus dem Dataset; Gruppierung, Zusammenfassungen, Filter und Export laufen im Grid.
GroupBy oder durch Ziehen eines Spaltenkopfs ins GruppierungsfeldSummaryTypeOnApplySort gibt die Sortierung als Feldnamen weiter, zum Beispiel für die IndexFieldNames einer FireDAC-AbfrageSaveToXLSX schreibt eine Excel-Arbeitsmappe ohne externe Bibliothek, mit Gruppen als einklappbarer Gliederung und Gruppensummen als SUBTOTAL-Formeln (Registered-Edition)
Geänderte Zellen blinken, wenn eine Zeile aktualisiert wird.
Zwei Gruppenebenen, Detailzeilen und eingefärbte Zellen.
Erst filtern, dann nach mehreren Spalten sortieren.
Über TsgcGridSource_DataSet an ein TClientDataSet gebunden.
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;
Das Standard-VCL-TDBGrid zeigt und bearbeitet ein Dataset. Diese Tabelle listet auf, was jedes Grid ohne zusätzlichen Code von Haus aus kann.
| Funktion | TDBGrid | sgcGrid | sgcGrid-Edition |
|---|---|---|---|
| Ein TDataSet binden | Über eine TDataSource | TsgcGridSource_DataSet mit DataSet, Grid und KeyField | Alle |
| Entworfene Spalten | Columns aus TColumn | Columns, über FieldName zugeordnet, oder AutoColumns | Alle |
| Geänderte Zeilen an Ort und Stelle aktualisiert, mit Flash | No | Ja, über KeyField | Alle |
| Sortieren per Klick auf den Spaltenkopf | Code in OnTitleClick | Integriert, mit OnApplySort für das Dataset | Alle |
| Gruppierung und Gruppierungsfeld | No | GroupBy, ShowGroupPanel | Alle |
| Fußzeilen- und Gruppenzusammenfassungen | No | SummaryType gsuSum, gsuCount, gsuAverage, gsuMin, gsuMax | Alle |
| Filterzeile und Spaltenfilter | No | ShowFilterRow, ShowFilterButtons | Alle |
| Suchfeld | No | ShowFindPanel, FindOnlyMatches | Alle |
| Bänder, optimale Spaltenbreite und gespeicherte Layouts | No | Bands, BestFitColumns, SaveLayoutToFile, AutoSaveLayout | Alle |
| Farben pro Zelle ohne Zeichencode | Code in OnDrawColumnCell | FormatRules, OnGetCellStyle und OnCustomDrawCell für eigenes Zeichnen | Alle |
| Auswahl mehrerer Zeilen | dgMultiSelect, SelectedRows | SelectionMode gsmMultiRow, GetSelectedKeys | Alle |
| Bearbeiten und ins Dataset übernehmen | Ja, mit dgEditing | WriteBack übernimmt jede Änderung in ihren Datensatz, SyncCursor hält den aktuellen Datensatz im Gleichschritt | Registered |
| Excel-Export | No | SaveToXLSX, in eine Datei oder einen Stream | Registered |
| Zu große Tabellen zum Laden | No | Servermodus mit TsgcGridServerProvider_DataSet, jeweils eine Seite | Registered |
| FireMonkey | Nein, nur VCL | TsgcFMXGrid unter Windows, macOS, iOS und Android | Alle |
| .NET | No | Grids für WinForms, WPF und Avalonia | Alle |
Sieh dir die vollständige sgcGrid-Funktionsmatrix, die Benchmarks und den sgcGrid-Vergleich an.
Mit aktiviertem WriteBack schreibt die Quelle jede Änderung im Grid in den Datensatz ihrer Zeile. Sie findet den Datensatz über KeyField und übernimmt den Wert. Schlägt das Übernehmen fehl, zum Beispiel bei einer BeforePost-Prüfung, wird der Datensatz verworfen, und die Zelle behält ihren alten Wert.
SyncCursor hält den aktuellen Datensatz und die fokussierte Zeile zusammen, sodass ein TDBNavigator und TDBEdit-Controls am selben Dataset dem Grid folgen und das Grid ihnenAllowInsert: Einfg hängt einen Datensatz an und übernimmt ihn, und OnNewRecord des Datasets füllt die StandardwerteApplyFilter sorgt dafür, dass das Dataset nur die Zeilen behält, die das Grid zeigt, sodass datenbankfähige Controls und Berichte darauf die gefilterten Zeilen sehenWriteBack, SyncCursor, Einfügen, Löschen, Paste und Undo gehören zur Registered-Edition. Die Testversion enthält sie zur Evaluierung.
Das Hilfethema zur DataSet-Bearbeitung lesenDrei Schritte: die Spalten zur Entwurfszeit importieren, die Eigenschaften und Ereignisse ersetzen, das DB-Grid löschen. Die Daten bleiben im selben TDataSet.
TsgcVCLGrid neben dem TDBGrid.TsgcGridSource_DataSet erstellen, die Abmessungen kopieren (Parent, Align, Anchors, TabOrder und mehr), die Ereignishandler kopieren und zuvor die Spalten des Grids leeren.Der Import kopiert FieldName, Title.Caption nach Caption, Width (mit der PixelsPerInch des Formulars in DIPs umgerechnet), Visible, Alignment, ReadOnly nach Editable und PickList. Aus dem Code erledigt sgcGridImportDBGrid in der Unit sgcGrid_Import_VCL dasselbe zur Laufzeit.
| TDBGrid | sgcGrid |
|---|---|
| TDBGrid | TsgcVCLGrid (Unit sgcGrid_VCL) |
| DataSource | TsgcGridSource_DataSet: DataSet, Grid, KeyField, dann Active := True (Unit sgcGrid_Source_DataSet) |
| Columns, TColumn.FieldName | Columns, Columns[i].FieldName |
| ReadOnly, Options dgEditing | ReadOnly des Grids und WriteBack der Quelle (Registered) |
| dgRowSelect | SelectionMode := gsmRow |
| dgMultiSelect, SelectedRows | SelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys |
| dgIndicator | RowHeader := [grhIndicator], außerdem grhNumbers und grhCheckBox |
| dgColLines, dgRowLines | GridLinesV, GridLinesH |
| OnDrawColumnCell | OnCustomDrawCell; nur für Farben OnGetCellStyle oder FormatRules |
| OnTitleClick | OnHeaderClick; das Grid sortiert von selbst |
| OnColEnter, OnColExit | OnSelectionChange, mit SelectedCol |
Das TDBGrid-Migrationskit enthält die vollständige Zuordnung aller Member, Vorher-nachher-Code aus der Demo MigrateFromDBGrid, die sich mit Delphi 7 und Delphi 13 (Win32 und Win64) kompilieren lässt, sowie die bekannten Unterschiede. Weitere Kits findest du auf der Seite sgcUI-Migration.
Ein Grid-Modell treibt das VCL- und das FireMonkey-Grid an, sodass ein VCL-Formular und ein FireMonkey-Formular denselben Bindungscode teilen.
| Ziel | Komponente | Plattformen |
|---|---|---|
| Delphi 7 bis 13, VCL | TsgcVCLGrid | Win32 und Win64 ab XE2 |
| Delphi XE6 bis 13, FireMonkey | TsgcFMXGrid | Windows, macOS, iOS und Android |
| C++ Builder 2007 bis 13 | TsgcVCLGrid, TsgcFMXGrid | Generierte .hpp-Header und statische Bibliotheken |
| .NET Framework 4.7.2, .NET 8, 9 und 10 | TsgcWinFormsGrid, Grids für WPF und Avalonia | WinForms, WPF, Avalonia |
Der Import der TDBGrid-Spalten läuft im VCL-Formulardesigner. FireMonkey-Formulare binden das Dataset mit demselben TsgcGridSource_DataSet.
DataSet-Bindung mit entworfenen Spalten, die über FieldName zugeordnet werden, Lookup-Felder, Zellen-, Zeilen- und Mehrfachzeilenauswahl, Zeilenkopf, eigenes Zeichnen, Strg+C, Gruppierungsfeld, Fußzeilen- und Gruppenzusammenfassungen, Filterzeile, Spaltenfilter im Excel-Stil, Suchfeld, Bänder, optimale Spaltenbreite sowie Speichern und Laden des Layouts als JSON. Die kostenlose Delphi-Community-Edition enthält sgcGrid.
Bearbeitung in beide Richtungen im Dataset (WriteBack), Cursor-Synchronisierung (SyncCursor), Einfügen, Löschen, Paste und Undo, Excel-Export, die Kartenansicht und der Servermodus für sehr große Tabellen. sgcGrid wird einzeln mit Single-, Team- und Site-Lizenzen und vollständigem Quellcode verkauft und ist in sgcUI Standard, Professional, Enterprise und All-Access enthalten.
sgcGrid-Preise ansehen oder die Testversion herunterladen, die zur Evaluierung jede Registered-Funktion enthält.
Platziere ein TsgcVCLGrid neben dem TDBGrid, klicke mit der rechten Maustaste darauf und wähle Import columns from DB grid. Der Import kopiert die Spalten, erstellt ein mit demselben Dataset verknüpftes TsgcGridSource_DataSet, kopiert die Abmessungen und die Ereignishandler und meldet die Ereignisse, die du von Hand portieren musst. Lösche danach das TDBGrid. Das Migrationskit ordnet jede Eigenschaft und jedes Ereignis zu.
TDBGrid ist ein VCL-Control. sgcGrid hat ein FireMonkey-Grid, TsgcFMXGrid, für Delphi XE6 bis 13 unter Windows, macOS, iOS und Android, und dasselbe TsgcGridSource_DataSet bindet es mit demselben Code wie das VCL-Grid an jedes TDataSet.
Ja. Rufe GroupBy mit den Feldnamen auf oder lass Benutzer einen Spaltenkopf ins Gruppierungsfeld ziehen. Setze SummaryType an einer Spalte (Summe, Anzahl, Durchschnitt, Minimum oder Maximum) und aktiviere ShowFooter: Die Summen erscheinen in der Fußzeile und in jeder Gruppenzeile. Gruppierung und Zusammenfassungen gehören zu jeder Edition, auch zur Community-Edition.
Binde das Dataset an sgcGrid und rufe SaveToXLSX mit einem Dateinamen oder einem Stream auf. Die Arbeitsmappe braucht keine externe Bibliothek und behält, was der Benutzer sieht: die sichtbaren Spalten in Anzeigereihenfolge mit ihren Breiten und Zahlenformaten, die fixierte Kopfzeile, Gruppen als einklappbare Gliederung und Gruppensummen als SUBTOTAL-Formeln. Der Excel-Export gehört zur Registered-Edition; die Community-Edition exportiert JSON und CSV.
Ja. Eine TFDQuery oder TFDTable ist ein TDataSet, daher bindet TsgcGridSource_DataSet sie genauso wie ein TClientDataSet. OnApplySort gibt die Sortierung des Grids in Form von FireDAC-IndexFieldNames weiter, zum Beispiel Name;Date:D. Für eine Tabelle, die zu groß zum Laden ist, liest der Servermodus (Registered) mit TsgcGridServerProvider_DataSet jeweils eine Seite und lässt die Datenbank per SQL sortieren, filtern, zählen und gruppieren, ausgeführt von FireDAC oder einer anderen Abfragekomponente.
Ja, in der Registered-Edition. Mit WriteBack übernimmt die Quelle jede Änderung in den Datensatz ihrer Zeile, der über KeyField gefunden wird, und SyncCursor hält den aktuellen Datensatz und die fokussierte Zeile zusammen, sodass ein TDBNavigator und TDBEdit-Controls am selben Dataset im Gleichschritt bleiben. In der Community-Edition zeigt das Grid das Dataset schreibgeschützt an.