Delphi & C++ Builder VCL en FireMonkey

sgcGrid, een data-aware DBGrid-vervanger voor Delphi

sgcGrid is een data-aware Delphi-grid dat bindt aan de TDataSet die je DBGrid al gebruikt, en dezelfde rijen vervolgens groepeert, optelt, filtert en exporteert.

Groepering met totalen
Filterrij en zoekvenster
Gewijzigde rijen worden ter plekke bijgewerkt
Excel-export
Elke TDataSetDelphi 7 tot 13FireMonkey vanaf XE6Gratis Delphi Community-editie

Migreren van TDBGrid → · Bekijk de prijzen →

Delphi-datagrid dat klanten groepeert per regio met samenvattingen in elke groepsrij en totalen in de voettekst, naast een contactkaart en een locatiekaart, sgcGrid in de Altamira ERP-demo

Bind sgcGrid aan een TDataSet, TFDQuery of TClientDataSet

Je databasecode blijft werken. Alleen het grid en de koppeling tussen het grid en de dataset veranderen.

sgcGrid bindt aan een FireDAC TFDQuery, een TClientDataSet of elke andere dataset. Bovenop wat TDBGrid toont, groepeert en telt het rijen op, filtert het met een filterrij, kolomfilters en een zoekpaneel, exporteert het naar Excel en werkt het gewijzigde rijen ter plekke bij, op VCL en op FireMonkey.

Een TDBGrid leest zijn dataset via een TDataSource. In sgcGrid neemt een TsgcGridSource_DataSet de plaats van de TDataSource in: stel Grid en DataSet in, maak hem Active, en de rijen verschijnen. De dataset kan een FireDAC-query zijn, een TClientDataSet of elke andere afstammeling van TDataSet.

  • Met een KeyField wordt het grid gesynchroniseerd in plaats van opnieuw geladen: gewijzigde rijen worden ter plekke bijgewerkt en lichten op, nieuwe sleutels worden toegevoegd en ontbrekende sleutels verwijderd.
  • LiveUpdates laat het grid elke Post, Delete en Refresh van de dataset volgen.
  • AutoColumns maakt de kolommen aan op basis van de velden wanneer het grid er geen heeft. Ontworpen kolommen blijven behouden en worden gekoppeld op FieldName.
  • De dataset wordt doorlopen met DisableControls en het huidige record wordt hersteld. Het sluiten van de dataset behoudt de rijen.
  • Lookupvelden vullen de keuzelijst van hun kolom, en BooleanFields toont een vlag die als tekst of getal is opgeslagen, zoals S en N, als selectievakje.
Delphi, een FireDAC-query 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;

De bron is een component, dus dezelfde binding kan in het formulierbestand staan en worden ingesteld in de Object Inspector:

frmMain.dfm
object SourceDB: TsgcGridSource_DataSet
  DataSet = cdsProducts
  Grid = GridDB
  KeyField = 'ID'
end

Dezelfde bron bindt een FireMonkey TsgcFMXGrid met dezelfde code. Binding, groepering, samenvattingen en filteren maken deel uit van elke editie, ook van de gratis Delphi Community-editie.

Lees het Help-onderwerp DataSet Binding

Groepeer, tel op, filter en exporteer dezelfde rijen

De rijen komen uit de dataset; groepering, samenvattingen, filters en export draaien in het grid.

sgcGrid met 100.000 bestellingen gegroepeerd op Region en daarna Category, chips in het groepeerpaneel en totalen in de voettekst

Wat een DBGrid-gebruiker erbij krijgt

  • Groepering op een of meer kolommen, vanuit code met GroupBy of door een kop naar het groepeerpaneel te slepen
  • Som, aantal, gemiddelde, minimum en maximum in de voettekst en in elke groepsrij, met SummaryType
  • Een filterrij, een filter in Excel-stijl op elke kolom en een zoekpaneel dat de treffers markeert
  • Een klik op de kop sorteert vanzelf, en OnApplySort geeft de sortering door als veldnamen, bijvoorbeeld voor de IndexFieldNames van een FireDAC-query
  • SaveToXLSX schrijft een Excel-werkmap zonder externe bibliotheek, met groepen als inklapbare structuur en groepstotalen als SUBTOTAL-formules (Registered-editie)
  • Banden, best fit, kolomkiezer, en de kolomindeling opgeslagen en geladen als JSON
Delphi, groepering, totalen, filters en 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 en sgcGrid vergeleken

De standaard VCL TDBGrid toont en bewerkt een dataset. Deze tabel toont wat elk grid standaard doet, zonder extra code.

FunctieTDBGridsgcGridsgcGrid-editie
Een TDataSet bindenVia een TDataSourceTsgcGridSource_DataSet met DataSet, Grid en KeyFieldAlle
Ontworpen kolommenColumns van TColumnColumns gekoppeld op FieldName, of AutoColumnsAlle
Gewijzigde rijen ter plekke bijgewerkt, met een flashNoJa, via KeyFieldAlle
Sorteren met een klik op de kopCode in OnTitleClickIngebouwd, met OnApplySort voor de datasetAlle
Groepering en groepeerpaneelNoGroupBy, ShowGroupPanelAlle
Samenvattingen in voettekst en groepenNoSummaryType gsuSum, gsuCount, gsuAverage, gsuMin, gsuMaxAlle
Filterrij en kolomfiltersNoShowFilterRow, ShowFilterButtonsAlle
ZoekpaneelNoShowFindPanel, FindOnlyMatchesAlle
Banden, best fit en opgeslagen indelingenNoBands, BestFitColumns, SaveLayoutToFile, AutoSaveLayoutAlle
Kleuren per cel zonder tekencodeCode in OnDrawColumnCellFormatRules, OnGetCellStyle en OnCustomDrawCell voor eigen tekenwerkAlle
Selectie van meerdere rijendgMultiSelect, SelectedRowsSelectionMode gsmMultiRow, GetSelectedKeysAlle
Bewerken en posten naar de datasetJa, met dgEditingWriteBack post elke wijziging naar zijn record, SyncCursor houdt het huidige record gelijkRegistered
Excel-exportNoSaveToXLSX, naar een bestand of een streamRegistered
Tabellen die te groot zijn om te ladenNoServermodus met TsgcGridServerProvider_DataSet, een pagina tegelijkRegistered
FireMonkeyNee, alleen VCLTsgcFMXGrid op Windows, macOS, iOS en AndroidAlle
.NETNoWinForms-, WPF- en Avalonia-gridsAlle

Bekijk de volledige functiematrix van sgcGrid, de benchmarks en de sgcGrid-vergelijking.

DataSetEditing-demo: een TDBNavigator en twee TDBEdits op dezelfde records als het grid, met een opzoekkolom voor categorie

Bewerk de dataset via het grid

Met WriteBack aan schrijft de bron elke wijziging in het grid naar het record van zijn rij. Hij zoekt het record op met KeyField en post de waarde. Wanneer het posten mislukt, bijvoorbeeld bij een BeforePost-controle, wordt het record geannuleerd en behoudt de cel zijn oude waarde.

  • SyncCursor houdt het huidige record en de rij met focus bij elkaar, zodat een TDBNavigator en TDBEdit-besturingselementen op dezelfde dataset het grid volgen, en het grid hen
  • AllowInsert: Ins voegt een record toe en post het, en OnNewRecord van de dataset vult de standaardwaarden in
  • ApplyFilter zorgt ervoor dat de dataset alleen de rijen behoudt die het grid toont, zodat DB-aware besturingselementen en rapporten erop de gefilterde rijen zien

WriteBack, SyncCursor, invoegen, verwijderen, plakken en ongedaan maken maken deel uit van de Registered-editie. De proefversie bevat ze om te evalueren.

Lees het Help-onderwerp DataSet Editing

TDBGrid in Delphi vervangen

Drie stappen: importeer de kolommen tijdens het ontwerpen, vervang de eigenschappen en gebeurtenissen, verwijder het DB-grid. De gegevens blijven in dezelfde TDataSet.

  1. Sla het formulier op en plaats daarna een TsgcVCLGrid naast de TDBGrid.
  2. Klik met de rechtermuisknop op het grid, kies Import columns from DB grid... en selecteer de TDBGrid in de lijst.
  3. Laat de vier opties aangevinkt: maak een TsgcGridSource_DataSet aan die aan de dataset van de DataSource is gekoppeld, kopieer de afmetingen (Parent, Align, Anchors, TabOrder en meer), kopieer de event handlers en wis eerst de kolommen van het grid.
  4. Lees het rapport. Het toont elke geïmporteerde kolom en elke gebeurtenis die handmatig moet worden overgezet.
  5. Controleer het resultaat en verwijder daarna de TDBGrid, en zijn TDataSource wanneer niets anders die gebruikt.

De import kopieert FieldName, Title.Caption naar Caption, Width (omgerekend naar DIP's met de PixelsPerInch van het formulier), Visible, Alignment, ReadOnly naar Editable en PickList. Vanuit code doet sgcGridImportDBGrid in de unit sgcGrid_Import_VCL hetzelfde tijdens runtime.

TDBGridsgcGrid
TDBGridTsgcVCLGrid (unit sgcGrid_VCL)
DataSourceTsgcGridSource_DataSet: DataSet, Grid, KeyField, daarna Active := True (unit sgcGrid_Source_DataSet)
Columns, TColumn.FieldNameColumns, Columns[i].FieldName
ReadOnly, Options dgEditingReadOnly van het grid en WriteBack van de bron (Registered)
dgRowSelectSelectionMode := gsmRow
dgMultiSelect, SelectedRowsSelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys
dgIndicatorRowHeader := [grhIndicator], ook grhNumbers en grhCheckBox
dgColLines, dgRowLinesGridLinesV, GridLinesH
OnDrawColumnCellOnCustomDrawCell; alleen voor kleuren, OnGetCellStyle of FormatRules
OnTitleClickOnHeaderClick; het grid sorteert vanzelf
OnColEnter, OnColExitOnSelectionChange, met SelectedCol

De TDBGrid-migratiekit bevat de volledige ledenmap, code voor en na uit de MigrateFromDBGrid-demo, die compileert met Delphi 7 en Delphi 13 (Win32 en Win64), en de bekende verschillen. Andere kits staan op de pagina sgcUI-migratie.

VCL, FireMonkey en Delphi-versies

Eén gridmodel stuurt het VCL- en het FireMonkey-grid aan, zodat een VCL-formulier en een FireMonkey-formulier dezelfde bindingscode delen.

DoelComponentPlatforms
Delphi 7 tot 13, VCLTsgcVCLGridWin32, en Win64 vanaf XE2
Delphi XE6 tot 13, FireMonkeyTsgcFMXGridWindows, macOS, iOS en Android
C++ Builder 2007 tot 13TsgcVCLGrid, TsgcFMXGridGegenereerde .hpp-headers en statische bibliotheken
.NET Framework 4.7.2, .NET 8, 9 en 10TsgcWinFormsGrid, WPF- en Avalonia-gridsWinForms, WPF, Avalonia

De import van TDBGrid-kolommen draait in de VCL-formulierontwerper. FireMonkey-formulieren binden de dataset met dezelfde TsgcGridSource_DataSet.

Community en Registered

In elke editie

DataSet-binding met ontworpen kolommen gekoppeld op FieldName, lookupvelden, selectie van cellen, rijen en meerdere rijen, rijkop, eigen tekenwerk, Ctrl+C, groepeerpaneel, samenvattingen in voettekst en groepen, filterrij, kolomfilter in Excel-stijl, zoekpaneel, banden, best fit, en JSON-indeling opslaan en laden. De gratis Delphi Community-editie bevat sgcGrid.

Registered-editie

Bewerken in twee richtingen naar de dataset (WriteBack), cursorsynchronisatie (SyncCursor), invoegen, verwijderen, plakken en ongedaan maken, Excel-export, de kaartweergave en servermodus voor zeer grote tabellen. sgcGrid wordt los verkocht met Single-, Team- en Site-licenties en volledige broncode, en zit in sgcUI Standard, Professional, Enterprise en All-Access.

Bekijk de prijzen van sgcGrid of download de proefversie, die alle Registered-functies bevat om te evalueren.

Veelgestelde vragen

Plaats een TsgcVCLGrid naast de TDBGrid, klik met de rechtermuisknop en kies Import columns from DB grid. De import kopieert de kolommen, maakt een TsgcGridSource_DataSet aan die aan dezelfde dataset is gekoppeld, kopieert de afmetingen en de event handlers, en meldt de gebeurtenissen die handmatig moeten worden overgezet. Verwijder daarna de TDBGrid. De migratiekit koppelt elke eigenschap en gebeurtenis.

TDBGrid is een VCL-besturingselement. sgcGrid heeft een FireMonkey-grid, TsgcFMXGrid, voor Delphi XE6 tot 13 op Windows, macOS, iOS en Android, en dezelfde TsgcGridSource_DataSet bindt het aan elke TDataSet met dezelfde code als het VCL-grid.

Ja. Roep GroupBy aan met de veldnamen, of laat gebruikers een kolomkop naar het groepeerpaneel slepen. Stel SummaryType in op een kolom (som, aantal, gemiddelde, minimum of maximum) en schakel ShowFooter in: de totalen verschijnen in de voettekst en in elke groepsrij. Groepering en samenvattingen maken deel uit van elke editie, Community inbegrepen.

Bind de dataset aan sgcGrid en roep SaveToXLSX aan met een bestandsnaam of een stream. De werkmap heeft geen externe bibliotheek nodig en behoudt wat de gebruiker ziet: de zichtbare kolommen in weergavevolgorde met hun breedtes en getalnotaties, de vaste kop, groepen als inklapbare structuur en groepstotalen als SUBTOTAL-formules. Excel-export maakt deel uit van de Registered-editie; de Community-editie exporteert JSON en CSV.

Ja. Een TFDQuery of TFDTable is een TDataSet, dus TsgcGridSource_DataSet bindt hem net als een TClientDataSet. OnApplySort geeft de sortering van het grid door in de vorm van FireDAC IndexFieldNames, bijvoorbeeld Name;Date:D. Voor een tabel die te groot is om te laden leest servermodus (Registered) met TsgcGridServerProvider_DataSet een pagina tegelijk en laat de database sorteren, filteren, tellen en groeperen met SQL, uitgevoerd door FireDAC of een andere querycomponent.

Ja, in de Registered-editie. Met WriteBack post de bron elke wijziging naar het record van zijn rij, opgezocht met KeyField, en SyncCursor houdt het huidige record en de rij met focus bij elkaar, zodat een TDBNavigator en TDBEdit-besturingselementen op dezelfde dataset gelijk blijven lopen. In de Community-editie toont het grid de dataset alleen-lezen.

De beste deal: All-AccessElk eSeGeCe-product, inclusief Premium-ondersteuning, vanaf €1,059 per jaar.
Bekijk de All-Access-prijzen

Verhuis je DBGrid-formulieren naar sgcGrid

Download de proefversie en bind sgcGrid aan de datasets die je Delphi-toepassing al heeft.