Delphi & C++ Builder VCL e FireMonkey

sgcGrid, un sostituto data-aware di DBGrid per Delphi

sgcGrid è una griglia Delphi data-aware che si collega al TDataSet già usato dal tuo DBGrid, poi raggruppa, somma, filtra ed esporta le stesse righe.

Raggruppamento con totali
Riga di filtro e pannello di ricerca
Le righe modificate si aggiornano sul posto
Esportazione in Excel
Qualsiasi TDataSetDa Delphi 7 a 13FireMonkey da XE6Edizione Delphi Community gratuita

Migra da TDBGrid → · Vedi i prezzi →

Data grid Delphi che raggruppa i clienti per regione con riepiloghi in ogni riga di gruppo e totali nel piè di pagina, accanto a una scheda contatto e a una mappa della posizione, sgcGrid nella demo Altamira ERP

Collega sgcGrid a un TDataSet, TFDQuery o TClientDataSet

Il tuo codice per il database continua a funzionare. Cambiano solo la griglia e il collegamento tra la griglia e il dataset.

sgcGrid si collega a una TFDQuery di FireDAC, a un TClientDataSet o a qualsiasi altro dataset. Oltre a ciò che mostra TDBGrid, raggruppa e somma le righe, filtra con una riga di filtro, filtri di colonna e un pannello di ricerca, esporta in Excel e aggiorna sul posto le righe modificate, su VCL e su FireMonkey.

Un TDBGrid legge il suo dataset tramite un TDataSource. In sgcGrid, un TsgcGridSource_DataSet prende il posto del TDataSource: imposta Grid e DataSet, rendilo Active, e le righe compaiono. Il dataset può essere una query FireDAC, un TClientDataSet o qualsiasi altro discendente di TDataSet.

  • Con un KeyField la griglia viene sincronizzata invece di essere ricaricata: le righe modificate vengono aggiornate sul posto e lampeggiano, le nuove chiavi vengono aggiunte e quelle mancanti eliminate.
  • LiveUpdates fa sì che la griglia segua ogni Post, Delete e Refresh del dataset.
  • AutoColumns crea le colonne dai campi quando la griglia non ne ha. Le colonne progettate vengono mantenute e abbinate tramite FieldName.
  • Il dataset viene scorso con DisableControls e il suo record corrente viene ripristinato. Chiudere il dataset mantiene le righe.
  • I campi lookup riempiono l'elenco a discesa della loro colonna, e BooleanFields mostra come casella di controllo un flag memorizzato come testo o numero, per esempio S e N.
Delphi, una query FireDAC 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;

L'origine è un componente, quindi lo stesso binding può stare nel file del form ed essere impostato nell'Object Inspector:

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

La stessa origine collega un TsgcFMXGrid FireMonkey con lo stesso codice. Binding, raggruppamento, riepiloghi e filtri sono parte di ogni edizione, compresa l'edizione Delphi Community gratuita.

Leggi l'argomento della guida sul binding del DataSet

Raggruppa, somma, filtra ed esporta le stesse righe

Le righe arrivano dal dataset; raggruppamento, riepiloghi, filtri ed esportazione vengono eseguiti nella griglia.

sgcGrid con 100.000 ordini raggruppati per Region e poi Category, chip nel pannello dei gruppi e totali nel piè di pagina

Cosa guadagna chi usa DBGrid

  • Raggruppamento per una o più colonne, da codice con GroupBy o trascinando un'intestazione nel pannello dei gruppi
  • Somma, conteggio, media, minimo e massimo nel piè di pagina e in ogni riga di gruppo, con SummaryType
  • Una riga di filtro, un filtro in stile Excel su ogni colonna e un pannello di ricerca che evidenzia le corrispondenze
  • Un clic sull'intestazione ordina da solo, e OnApplySort passa l'ordinamento come nomi di campo, per esempio per IndexFieldNames di una query FireDAC
  • SaveToXLSX scrive una cartella di lavoro Excel senza librerie esterne, con i gruppi come struttura comprimibile e i totali di gruppo come formule SUBTOTAL (edizione Registered)
  • Bande, adattamento automatico, selettore delle colonne, e layout delle colonne salvato e caricato come JSON
Delphi, raggruppamento, totali, filtri ed 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 e sgcGrid a confronto

Il TDBGrid VCL standard mostra e modifica un dataset. Questa tabella elenca cosa fa ciascuna griglia di serie, senza codice aggiuntivo.

FunzionalitàTDBGridsgcGridEdizione di sgcGrid
Collegare un TDataSetTramite un TDataSourceTsgcGridSource_DataSet con DataSet, Grid e KeyFieldTutte
Colonne progettateColumns di TColumnColumns abbinate tramite FieldName, oppure AutoColumnsTutte
Righe modificate aggiornate sul posto, con flashNoSì, tramite KeyFieldTutte
Ordinamento con un clic sull'intestazioneCodice in OnTitleClickIntegrato, con OnApplySort per il datasetTutte
Raggruppamento e pannello dei gruppiNoGroupBy, ShowGroupPanelTutte
Riepiloghi del piè di pagina e dei gruppiNoSummaryType gsuSum, gsuCount, gsuAverage, gsuMin, gsuMaxTutte
Riga di filtro e filtri di colonnaNoShowFilterRow, ShowFilterButtonsTutte
Pannello di ricercaNoShowFindPanel, FindOnlyMatchesTutte
Bande, adattamento automatico e layout salvatiNoBands, BestFitColumns, SaveLayoutToFile, AutoSaveLayoutTutte
Colori per cella senza codice di disegnoCodice in OnDrawColumnCellFormatRules, OnGetCellStyle e OnCustomDrawCell per il disegno personalizzatoTutte
Selezione di più righedgMultiSelect, SelectedRowsSelectionMode gsmMultiRow, GetSelectedKeysTutte
Modifica e registrazione nel datasetSì, con dgEditingWriteBack registra ogni modifica nel suo record, SyncCursor mantiene allineato il record correnteRegistered
Esportazione in ExcelNoSaveToXLSX, su file o su streamRegistered
Tabelle troppo grandi da caricareNoModalità server con TsgcGridServerProvider_DataSet, una pagina alla voltaRegistered
FireMonkeyNo, solo VCLTsgcFMXGrid su Windows, macOS, iOS e AndroidTutte
.NETNoGriglie WinForms, WPF e AvaloniaTutte

Consulta la matrice completa delle funzionalità di sgcGrid, i benchmark e il confronto di sgcGrid.

Demo DataSetEditing: un TDBNavigator e due TDBEdit sugli stessi record della griglia, con una colonna lookup per la categoria

Modifica il dataset attraverso la griglia

Con WriteBack attivo, l'origine scrive ogni modifica della griglia nel record della sua riga. Individua il record tramite KeyField e registra il valore. Quando la registrazione fallisce, per esempio in un controllo BeforePost, il record viene annullato e la cella mantiene il vecchio valore.

  • SyncCursor tiene insieme il record corrente e la riga con il focus, così un TDBNavigator e i controlli TDBEdit sullo stesso dataset seguono la griglia, e la griglia segue loro
  • AllowInsert: Ins aggiunge e registra un record, e OnNewRecord del dataset imposta i valori predefiniti
  • ApplyFilter fa sì che il dataset mantenga solo le righe mostrate dalla griglia, così i controlli data-aware e i report che lo usano vedono le righe filtrate

WriteBack, SyncCursor, inserimento, eliminazione, incolla e annulla fanno parte dell'edizione Registered. La versione di prova li include per la valutazione.

Leggi l'argomento della guida sulla modifica del DataSet

Come sostituire TDBGrid in Delphi

Tre passaggi: importa le colonne in fase di progettazione, sostituisci proprietà ed eventi, elimina la griglia DB. I dati restano nello stesso TDataSet.

  1. Salva il form, poi inserisci un TsgcVCLGrid accanto al TDBGrid.
  2. Fai clic con il pulsante destro sulla griglia, scegli Import columns from DB grid... e seleziona il TDBGrid nell'elenco.
  3. Lascia selezionate le quattro opzioni: creare un TsgcGridSource_DataSet collegato al dataset del DataSource, copiare i limiti (Parent, Align, Anchors, TabOrder e altro), copiare i gestori di eventi e svuotare prima le colonne della griglia.
  4. Leggi il rapporto. Elenca ogni colonna importata e ogni evento da portare a mano.
  5. Controlla il risultato, poi elimina il TDBGrid, e il suo TDataSource se nient'altro lo usa.

L'importazione copia FieldName, Title.Caption in Caption, Width (convertita in DIP con il PixelsPerInch del form), Visible, Alignment, ReadOnly in Editable e PickList. Da codice, sgcGridImportDBGrid nell'unit sgcGrid_Import_VCL fa lo stesso a runtime.

TDBGridsgcGrid
TDBGridTsgcVCLGrid (unit sgcGrid_VCL)
DataSourceTsgcGridSource_DataSet: DataSet, Grid, KeyField, poi Active := True (unit sgcGrid_Source_DataSet)
Columns, TColumn.FieldNameColumns, Columns[i].FieldName
ReadOnly, Options dgEditingReadOnly della griglia e WriteBack dell'origine (Registered)
dgRowSelectSelectionMode := gsmRow
dgMultiSelect, SelectedRowsSelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys
dgIndicatorRowHeader := [grhIndicator], anche grhNumbers e grhCheckBox
dgColLines, dgRowLinesGridLinesV, GridLinesH
OnDrawColumnCellOnCustomDrawCell; solo per i colori, OnGetCellStyle o FormatRules
OnTitleClickOnHeaderClick; la griglia ordina da sola
OnColEnter, OnColExitOnSelectionChange, con SelectedCol

Il kit di migrazione da TDBGrid contiene la mappa completa dei membri, il codice prima e dopo dalla demo MigrateFromDBGrid, che si compila con Delphi 7 e Delphi 13 (Win32 e Win64), e le differenze note. Gli altri kit sono nella pagina migrazione di sgcUI.

VCL, FireMonkey e versioni di Delphi

Un solo modello di griglia pilota la griglia VCL e quella FireMonkey, quindi un form VCL e un form FireMonkey condividono il codice di binding.

TargetComponentePiattaforme
Da Delphi 7 a 13, VCLTsgcVCLGridWin32 e Win64 da XE2
Da Delphi XE6 a 13, FireMonkeyTsgcFMXGridWindows, macOS, iOS e Android
Da C++ Builder 2007 a 13TsgcVCLGrid, TsgcFMXGridHeader .hpp e librerie statiche generati
.NET Framework 4.7.2, .NET 8, 9 e 10TsgcWinFormsGrid, griglie WPF e AvaloniaWinForms, WPF, Avalonia

L'importazione delle colonne di TDBGrid funziona nel designer dei form VCL. I form FireMonkey collegano il dataset con lo stesso TsgcGridSource_DataSet.

Community e Registered

In ogni edizione

Binding del DataSet con colonne progettate abbinate tramite FieldName, campi lookup, selezione di cella, riga e più righe, intestazione di riga, disegno personalizzato, Ctrl+C, pannello dei gruppi, riepiloghi di piè di pagina e di gruppo, riga di filtro, filtro di colonna in stile Excel, pannello di ricerca, bande, adattamento automatico, e salvataggio e caricamento del layout JSON. L'edizione Delphi Community gratuita include sgcGrid.

Edizione Registered

Modifica bidirezionale nel dataset (WriteBack), sincronizzazione del cursore (SyncCursor), inserimento, eliminazione, incolla e annulla, esportazione in Excel, vista a schede e modalità server per tabelle molto grandi. sgcGrid si vende da solo con licenze Single, Team e Site e codice sorgente completo, ed è incluso in sgcUI Standard, Professional, Enterprise e All-Access.

Vedi i prezzi di sgcGrid oppure scarica la versione di prova, che include per la valutazione tutte le funzionalità Registered.

Domande frequenti

Inserisci un TsgcVCLGrid accanto al TDBGrid, fai clic con il pulsante destro e scegli Import columns from DB grid. L'importazione copia le colonne, crea un TsgcGridSource_DataSet collegato allo stesso dataset, copia i limiti e i gestori di eventi, e segnala gli eventi da portare a mano. Poi elimina il TDBGrid. Il kit di migrazione mappa ogni proprietà ed evento.

TDBGrid è un controllo VCL. sgcGrid ha una griglia FireMonkey, TsgcFMXGrid, per Delphi da XE6 a 13 su Windows, macOS, iOS e Android, e lo stesso TsgcGridSource_DataSet la collega a qualsiasi TDataSet con lo stesso codice della griglia VCL.

Sì. Chiama GroupBy con i nomi dei campi, oppure lascia che gli utenti trascinino l'intestazione di una colonna nel pannello dei gruppi. Imposta SummaryType su una colonna (somma, conteggio, media, minimo o massimo) e attiva ShowFooter: i totali compaiono nel piè di pagina e in ogni riga di gruppo. Raggruppamento e riepiloghi fanno parte di ogni edizione, Community inclusa.

Collega il dataset a sgcGrid e chiama SaveToXLSX con un nome di file o uno stream. La cartella di lavoro non richiede librerie esterne e mantiene ciò che l'utente vede: le colonne visibili nell'ordine di visualizzazione con larghezze e formati numerici, l'intestazione bloccata, i gruppi come struttura comprimibile e i totali di gruppo come formule SUBTOTAL. L'esportazione in Excel fa parte dell'edizione Registered; l'edizione Community esporta JSON e CSV.

Sì. Una TFDQuery o una TFDTable è un TDataSet, quindi TsgcGridSource_DataSet la collega come un TClientDataSet. OnApplySort passa l'ordinamento della griglia nella forma degli IndexFieldNames di FireDAC, per esempio Name;Date:D. Per una tabella troppo grande da caricare, la modalità server (Registered) con TsgcGridServerProvider_DataSet legge una pagina alla volta e lascia che sia il database a ordinare, filtrare, contare e raggruppare con SQL, eseguito da FireDAC o da un altro componente di query.

Sì, nell'edizione Registered. Con WriteBack l'origine registra ogni modifica nel record della sua riga, individuato tramite KeyField, e SyncCursor tiene insieme il record corrente e la riga con il focus, così un TDBNavigator e i controlli TDBEdit sullo stesso dataset restano allineati. Nell'edizione Community la griglia mostra il dataset in sola lettura.

La scelta più conveniente: All-AccessTutti i prodotti eSeGeCe, con Supporto Premium incluso, a partire da €1,059/anno.
Vedi i prezzi All-Access

Porta i tuoi form DBGrid su sgcGrid

Scarica la versione di prova e collega sgcGrid ai dataset che la tua applicazione Delphi ha già.