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.
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.
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.
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.DisableControls e il suo record corrente viene ripristinato. Chiudere il dataset mantiene le righe.BooleanFields mostra come casella di controllo un flag memorizzato come testo o numero, per esempio S e N.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:
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.
Le righe arrivano dal dataset; raggruppamento, riepiloghi, filtri ed esportazione vengono eseguiti nella griglia.
GroupBy o trascinando un'intestazione nel pannello dei gruppiSummaryTypeOnApplySort passa l'ordinamento come nomi di campo, per esempio per IndexFieldNames di una query FireDACSaveToXLSX 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)
Le celle modificate lampeggiano quando una riga si aggiorna.
Due livelli di gruppo, righe di dettaglio e celle colorate.
Filtra, poi ordina su più colonne.
Collegata a un TClientDataSet tramite 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;
Il TDBGrid VCL standard mostra e modifica un dataset. Questa tabella elenca cosa fa ciascuna griglia di serie, senza codice aggiuntivo.
| Funzionalità | TDBGrid | sgcGrid | Edizione di sgcGrid |
|---|---|---|---|
| Collegare un TDataSet | Tramite un TDataSource | TsgcGridSource_DataSet con DataSet, Grid e KeyField | Tutte |
| Colonne progettate | Columns di TColumn | Columns abbinate tramite FieldName, oppure AutoColumns | Tutte |
| Righe modificate aggiornate sul posto, con flash | No | Sì, tramite KeyField | Tutte |
| Ordinamento con un clic sull'intestazione | Codice in OnTitleClick | Integrato, con OnApplySort per il dataset | Tutte |
| Raggruppamento e pannello dei gruppi | No | GroupBy, ShowGroupPanel | Tutte |
| Riepiloghi del piè di pagina e dei gruppi | No | SummaryType gsuSum, gsuCount, gsuAverage, gsuMin, gsuMax | Tutte |
| Riga di filtro e filtri di colonna | No | ShowFilterRow, ShowFilterButtons | Tutte |
| Pannello di ricerca | No | ShowFindPanel, FindOnlyMatches | Tutte |
| Bande, adattamento automatico e layout salvati | No | Bands, BestFitColumns, SaveLayoutToFile, AutoSaveLayout | Tutte |
| Colori per cella senza codice di disegno | Codice in OnDrawColumnCell | FormatRules, OnGetCellStyle e OnCustomDrawCell per il disegno personalizzato | Tutte |
| Selezione di più righe | dgMultiSelect, SelectedRows | SelectionMode gsmMultiRow, GetSelectedKeys | Tutte |
| Modifica e registrazione nel dataset | Sì, con dgEditing | WriteBack registra ogni modifica nel suo record, SyncCursor mantiene allineato il record corrente | Registered |
| Esportazione in Excel | No | SaveToXLSX, su file o su stream | Registered |
| Tabelle troppo grandi da caricare | No | Modalità server con TsgcGridServerProvider_DataSet, una pagina alla volta | Registered |
| FireMonkey | No, solo VCL | TsgcFMXGrid su Windows, macOS, iOS e Android | Tutte |
| .NET | No | Griglie WinForms, WPF e Avalonia | Tutte |
Consulta la matrice completa delle funzionalità di sgcGrid, i benchmark e il confronto di sgcGrid.
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 loroAllowInsert: Ins aggiunge e registra un record, e OnNewRecord del dataset imposta i valori predefinitiApplyFilter 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 filtrateWriteBack, 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 DataSetTre passaggi: importa le colonne in fase di progettazione, sostituisci proprietà ed eventi, elimina la griglia DB. I dati restano nello stesso TDataSet.
TsgcVCLGrid accanto al TDBGrid.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.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.
| TDBGrid | sgcGrid |
|---|---|
| TDBGrid | TsgcVCLGrid (unit sgcGrid_VCL) |
| DataSource | TsgcGridSource_DataSet: DataSet, Grid, KeyField, poi Active := True (unit sgcGrid_Source_DataSet) |
| Columns, TColumn.FieldName | Columns, Columns[i].FieldName |
| ReadOnly, Options dgEditing | ReadOnly della griglia e WriteBack dell'origine (Registered) |
| dgRowSelect | SelectionMode := gsmRow |
| dgMultiSelect, SelectedRows | SelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys |
| dgIndicator | RowHeader := [grhIndicator], anche grhNumbers e grhCheckBox |
| dgColLines, dgRowLines | GridLinesV, GridLinesH |
| OnDrawColumnCell | OnCustomDrawCell; solo per i colori, OnGetCellStyle o FormatRules |
| OnTitleClick | OnHeaderClick; la griglia ordina da sola |
| OnColEnter, OnColExit | OnSelectionChange, 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.
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.
| Target | Componente | Piattaforme |
|---|---|---|
| Da Delphi 7 a 13, VCL | TsgcVCLGrid | Win32 e Win64 da XE2 |
| Da Delphi XE6 a 13, FireMonkey | TsgcFMXGrid | Windows, macOS, iOS e Android |
| Da C++ Builder 2007 a 13 | TsgcVCLGrid, TsgcFMXGrid | Header .hpp e librerie statiche generati |
| .NET Framework 4.7.2, .NET 8, 9 e 10 | TsgcWinFormsGrid, griglie WPF e Avalonia | WinForms, 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.
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.
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.
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.