Delphi & C++ Builder VCL und FireMonkey

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.

Gruppierung mit Summen
Filterzeile und Suchfeld
Geänderte Zeilen werden an Ort und Stelle aktualisiert
Excel-Export
Jedes TDataSetDelphi 7 bis 13FireMonkey ab XE6Kostenlose Delphi-Community-Edition

Von TDBGrid migrieren → · Preise ansehen →

Delphi-Datengrid, das Kunden nach Region gruppiert, mit Zusammenfassungen in jeder Gruppenzeile und Summen in der Fußzeile, neben einer Kontaktkarte und einer Standortkarte, sgcGrid in der Altamira-ERP-Demo

sgcGrid an ein TDataSet, TFDQuery oder TClientDataSet binden

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.

  • Mit einem 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.
  • Das Dataset wird mit DisableControls durchlaufen, und sein aktueller Datensatz wird wiederhergestellt. Beim Schließen des Datasets bleiben die Zeilen erhalten.
  • Lookup-Felder füllen die Dropdown-Liste ihrer Spalte, und BooleanFields zeigt ein als Text oder Zahl gespeichertes Flag, etwa S und N, als Kontrollkästchen.
Delphi, eine FireDAC-Abfrage in sgcGrid
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:

frmMain.dfm
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.

Das Hilfethema zur DataSet-Bindung lesen

Dieselben Zeilen gruppieren, summieren, filtern und exportieren

Die Zeilen kommen aus dem Dataset; Gruppierung, Zusammenfassungen, Filter und Export laufen im Grid.

sgcGrid mit 100.000 Bestellungen, gruppiert nach Region und dann Kategorie, mit Chips im Gruppierungsfeld und Summen in der Fußzeile

Was ein DBGrid-Anwender gewinnt

  • Gruppierung nach einer oder mehreren Spalten, per Code mit GroupBy oder durch Ziehen eines Spaltenkopfs ins Gruppierungsfeld
  • Summe, Anzahl, Durchschnitt, Minimum und Maximum in der Fußzeile und in jeder Gruppenzeile, mit SummaryType
  • Eine Filterzeile, ein Filter im Excel-Stil an jeder Spalte und ein Suchfeld, das die Treffer hervorhebt
  • Ein Klick auf den Spaltenkopf sortiert von selbst, und OnApplySort gibt die Sortierung als Feldnamen weiter, zum Beispiel für die IndexFieldNames einer FireDAC-Abfrage
  • SaveToXLSX schreibt eine Excel-Arbeitsmappe ohne externe Bibliothek, mit Gruppen als einklappbarer Gliederung und Gruppensummen als SUBTOTAL-Formeln (Registered-Edition)
  • Bänder, optimale Spaltenbreite, Spaltenauswahl sowie das Spaltenlayout, als JSON gespeichert und geladen
Delphi, Gruppierung, Summen, Filter und Excel
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;

TDBGrid und sgcGrid im Vergleich

Das Standard-VCL-TDBGrid zeigt und bearbeitet ein Dataset. Diese Tabelle listet auf, was jedes Grid ohne zusätzlichen Code von Haus aus kann.

FunktionTDBGridsgcGridsgcGrid-Edition
Ein TDataSet bindenÜber eine TDataSourceTsgcGridSource_DataSet mit DataSet, Grid und KeyFieldAlle
Entworfene SpaltenColumns aus TColumnColumns, über FieldName zugeordnet, oder AutoColumnsAlle
Geänderte Zeilen an Ort und Stelle aktualisiert, mit FlashNoJa, über KeyFieldAlle
Sortieren per Klick auf den SpaltenkopfCode in OnTitleClickIntegriert, mit OnApplySort für das DatasetAlle
Gruppierung und GruppierungsfeldNoGroupBy, ShowGroupPanelAlle
Fußzeilen- und GruppenzusammenfassungenNoSummaryType gsuSum, gsuCount, gsuAverage, gsuMin, gsuMaxAlle
Filterzeile und SpaltenfilterNoShowFilterRow, ShowFilterButtonsAlle
SuchfeldNoShowFindPanel, FindOnlyMatchesAlle
Bänder, optimale Spaltenbreite und gespeicherte LayoutsNoBands, BestFitColumns, SaveLayoutToFile, AutoSaveLayoutAlle
Farben pro Zelle ohne ZeichencodeCode in OnDrawColumnCellFormatRules, OnGetCellStyle und OnCustomDrawCell für eigenes ZeichnenAlle
Auswahl mehrerer ZeilendgMultiSelect, SelectedRowsSelectionMode gsmMultiRow, GetSelectedKeysAlle
Bearbeiten und ins Dataset übernehmenJa, mit dgEditingWriteBack übernimmt jede Änderung in ihren Datensatz, SyncCursor hält den aktuellen Datensatz im GleichschrittRegistered
Excel-ExportNoSaveToXLSX, in eine Datei oder einen StreamRegistered
Zu große Tabellen zum LadenNoServermodus mit TsgcGridServerProvider_DataSet, jeweils eine SeiteRegistered
FireMonkeyNein, nur VCLTsgcFMXGrid unter Windows, macOS, iOS und AndroidAlle
.NETNoGrids für WinForms, WPF und AvaloniaAlle

Sieh dir die vollständige sgcGrid-Funktionsmatrix, die Benchmarks und den sgcGrid-Vergleich an.

DataSetEditing-Demo: ein TDBNavigator und zwei TDBEdits auf denselben Datensätzen wie das Grid, mit einer Lookup-Spalte für die Kategorie

Das Dataset über das Grid bearbeiten

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 ihnen
  • AllowInsert: Einfg hängt einen Datensatz an und übernimmt ihn, und OnNewRecord des Datasets füllt die Standardwerte
  • ApplyFilter 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 sehen

WriteBack, 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 lesen

So ersetzt du TDBGrid in Delphi

Drei Schritte: die Spalten zur Entwurfszeit importieren, die Eigenschaften und Ereignisse ersetzen, das DB-Grid löschen. Die Daten bleiben im selben TDataSet.

  1. Speichere das Formular und platziere dann ein TsgcVCLGrid neben dem TDBGrid.
  2. Klicke mit der rechten Maustaste auf das Grid, wähle Import columns from DB grid... und wähle das TDBGrid in der Liste aus.
  3. Lass die vier Optionen aktiviert: ein mit dem Dataset der DataSource verknüpftes TsgcGridSource_DataSet erstellen, die Abmessungen kopieren (Parent, Align, Anchors, TabOrder und mehr), die Ereignishandler kopieren und zuvor die Spalten des Grids leeren.
  4. Lies den Bericht. Er listet jede importierte Spalte und jedes Ereignis auf, das von Hand portiert werden muss.
  5. Prüfe das Ergebnis und lösche dann das TDBGrid und seine TDataSource, wenn sie sonst niemand nutzt.

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.

TDBGridsgcGrid
TDBGridTsgcVCLGrid (Unit sgcGrid_VCL)
DataSourceTsgcGridSource_DataSet: DataSet, Grid, KeyField, dann Active := True (Unit sgcGrid_Source_DataSet)
Columns, TColumn.FieldNameColumns, Columns[i].FieldName
ReadOnly, Options dgEditingReadOnly des Grids und WriteBack der Quelle (Registered)
dgRowSelectSelectionMode := gsmRow
dgMultiSelect, SelectedRowsSelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys
dgIndicatorRowHeader := [grhIndicator], außerdem grhNumbers und grhCheckBox
dgColLines, dgRowLinesGridLinesV, GridLinesH
OnDrawColumnCellOnCustomDrawCell; nur für Farben OnGetCellStyle oder FormatRules
OnTitleClickOnHeaderClick; das Grid sortiert von selbst
OnColEnter, OnColExitOnSelectionChange, 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.

VCL, FireMonkey und Delphi-Versionen

Ein Grid-Modell treibt das VCL- und das FireMonkey-Grid an, sodass ein VCL-Formular und ein FireMonkey-Formular denselben Bindungscode teilen.

ZielKomponentePlattformen
Delphi 7 bis 13, VCLTsgcVCLGridWin32 und Win64 ab XE2
Delphi XE6 bis 13, FireMonkeyTsgcFMXGridWindows, macOS, iOS und Android
C++ Builder 2007 bis 13TsgcVCLGrid, TsgcFMXGridGenerierte .hpp-Header und statische Bibliotheken
.NET Framework 4.7.2, .NET 8, 9 und 10TsgcWinFormsGrid, Grids für WPF und AvaloniaWinForms, WPF, Avalonia

Der Import der TDBGrid-Spalten läuft im VCL-Formulardesigner. FireMonkey-Formulare binden das Dataset mit demselben TsgcGridSource_DataSet.

Community und Registered

In jeder Edition

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.

Registered-Edition

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.

Häufig gestellte Fragen

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.

Bestes Preis-Leistungs-Verhältnis: All-AccessAlle eSeGeCe-Produkte, inklusive Premium-Support, ab €1,059 pro Jahr.
All-Access-Preise ansehen

Bring deine DBGrid-Formulare zu sgcGrid

Lade die Testversion herunter und binde sgcGrid an die Datasets, die deine Delphi-Anwendung bereits hat.