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.
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.
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.
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.DisableControls en het huidige record wordt hersteld. Het sluiten van de dataset behoudt de rijen.BooleanFields toont een vlag die als tekst of getal is opgeslagen, zoals S en N, als selectievakje.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:
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.
De rijen komen uit de dataset; groepering, samenvattingen, filters en export draaien in het grid.
GroupBy of door een kop naar het groepeerpaneel te slepenSummaryTypeOnApplySort geeft de sortering door als veldnamen, bijvoorbeeld voor de IndexFieldNames van een FireDAC-querySaveToXLSX schrijft een Excel-werkmap zonder externe bibliotheek, met groepen als inklapbare structuur en groepstotalen als SUBTOTAL-formules (Registered-editie)
Gewijzigde cellen lichten op wanneer een rij wordt bijgewerkt.
Twee groepsniveaus, detailrijen en gekleurde cellen.
Filter, en sorteer daarna op meerdere kolommen.
Gebonden aan een TClientDataSet via 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;
De standaard VCL TDBGrid toont en bewerkt een dataset. Deze tabel toont wat elk grid standaard doet, zonder extra code.
| Functie | TDBGrid | sgcGrid | sgcGrid-editie |
|---|---|---|---|
| Een TDataSet binden | Via een TDataSource | TsgcGridSource_DataSet met DataSet, Grid en KeyField | Alle |
| Ontworpen kolommen | Columns van TColumn | Columns gekoppeld op FieldName, of AutoColumns | Alle |
| Gewijzigde rijen ter plekke bijgewerkt, met een flash | No | Ja, via KeyField | Alle |
| Sorteren met een klik op de kop | Code in OnTitleClick | Ingebouwd, met OnApplySort voor de dataset | Alle |
| Groepering en groepeerpaneel | No | GroupBy, ShowGroupPanel | Alle |
| Samenvattingen in voettekst en groepen | No | SummaryType gsuSum, gsuCount, gsuAverage, gsuMin, gsuMax | Alle |
| Filterrij en kolomfilters | No | ShowFilterRow, ShowFilterButtons | Alle |
| Zoekpaneel | No | ShowFindPanel, FindOnlyMatches | Alle |
| Banden, best fit en opgeslagen indelingen | No | Bands, BestFitColumns, SaveLayoutToFile, AutoSaveLayout | Alle |
| Kleuren per cel zonder tekencode | Code in OnDrawColumnCell | FormatRules, OnGetCellStyle en OnCustomDrawCell voor eigen tekenwerk | Alle |
| Selectie van meerdere rijen | dgMultiSelect, SelectedRows | SelectionMode gsmMultiRow, GetSelectedKeys | Alle |
| Bewerken en posten naar de dataset | Ja, met dgEditing | WriteBack post elke wijziging naar zijn record, SyncCursor houdt het huidige record gelijk | Registered |
| Excel-export | No | SaveToXLSX, naar een bestand of een stream | Registered |
| Tabellen die te groot zijn om te laden | No | Servermodus met TsgcGridServerProvider_DataSet, een pagina tegelijk | Registered |
| FireMonkey | Nee, alleen VCL | TsgcFMXGrid op Windows, macOS, iOS en Android | Alle |
| .NET | No | WinForms-, WPF- en Avalonia-grids | Alle |
Bekijk de volledige functiematrix van sgcGrid, de benchmarks en de sgcGrid-vergelijking.
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 henAllowInsert: Ins voegt een record toe en post het, en OnNewRecord van de dataset vult de standaardwaarden inApplyFilter zorgt ervoor dat de dataset alleen de rijen behoudt die het grid toont, zodat DB-aware besturingselementen en rapporten erop de gefilterde rijen zienWriteBack, 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 EditingDrie stappen: importeer de kolommen tijdens het ontwerpen, vervang de eigenschappen en gebeurtenissen, verwijder het DB-grid. De gegevens blijven in dezelfde TDataSet.
TsgcVCLGrid naast de TDBGrid.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.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.
| TDBGrid | sgcGrid |
|---|---|
| TDBGrid | TsgcVCLGrid (unit sgcGrid_VCL) |
| DataSource | TsgcGridSource_DataSet: DataSet, Grid, KeyField, daarna Active := True (unit sgcGrid_Source_DataSet) |
| Columns, TColumn.FieldName | Columns, Columns[i].FieldName |
| ReadOnly, Options dgEditing | ReadOnly van het grid en WriteBack van de bron (Registered) |
| dgRowSelect | SelectionMode := gsmRow |
| dgMultiSelect, SelectedRows | SelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys |
| dgIndicator | RowHeader := [grhIndicator], ook grhNumbers en grhCheckBox |
| dgColLines, dgRowLines | GridLinesV, GridLinesH |
| OnDrawColumnCell | OnCustomDrawCell; alleen voor kleuren, OnGetCellStyle of FormatRules |
| OnTitleClick | OnHeaderClick; het grid sorteert vanzelf |
| OnColEnter, OnColExit | OnSelectionChange, 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.
Eén gridmodel stuurt het VCL- en het FireMonkey-grid aan, zodat een VCL-formulier en een FireMonkey-formulier dezelfde bindingscode delen.
| Doel | Component | Platforms |
|---|---|---|
| Delphi 7 tot 13, VCL | TsgcVCLGrid | Win32, en Win64 vanaf XE2 |
| Delphi XE6 tot 13, FireMonkey | TsgcFMXGrid | Windows, macOS, iOS en Android |
| C++ Builder 2007 tot 13 | TsgcVCLGrid, TsgcFMXGrid | Gegenereerde .hpp-headers en statische bibliotheken |
| .NET Framework 4.7.2, .NET 8, 9 en 10 | TsgcWinFormsGrid, WPF- en Avalonia-grids | WinForms, WPF, Avalonia |
De import van TDBGrid-kolommen draait in de VCL-formulierontwerper. FireMonkey-formulieren binden de dataset met dezelfde TsgcGridSource_DataSet.
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.
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.
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.