sgcGrid, un remplacement de DBGrid lié aux données pour Delphi
sgcGrid est une grille Delphi liée aux données qui se connecte au TDataSet que ta DBGrid utilise déjà, puis regroupe, totalise, filtre et exporte les mêmes lignes.
sgcGrid est une grille Delphi liée aux données qui se connecte au TDataSet que ta DBGrid utilise déjà, puis regroupe, totalise, filtre et exporte les mêmes lignes.
Ton code de base de données continue de fonctionner. Seuls la grille et le lien entre la grille et le dataset changent.
sgcGrid se lie à un TFDQuery FireDAC, à un TClientDataSet ou à tout autre dataset. En plus de ce que montre TDBGrid, elle regroupe et totalise les lignes, filtre avec une ligne de filtre, des filtres de colonne et un panneau de recherche, exporte vers Excel et met à jour les lignes modifiées sur place, sur VCL et sur FireMonkey.
Une TDBGrid lit son dataset via un TDataSource. Dans sgcGrid, un TsgcGridSource_DataSet prend la place du TDataSource : renseigne ses propriétés Grid et DataSet, rends-le Active, et les lignes apparaissent. Le dataset peut être une requête FireDAC, un TClientDataSet ou tout autre descendant de TDataSet.
KeyField, la grille est synchronisée au lieu d'être rechargée : les lignes modifiées sont mises à jour sur place et clignotent, les nouvelles clés sont ajoutées et les clés manquantes supprimées.LiveUpdates fait suivre à la grille chaque Post, Delete et Refresh du dataset.AutoColumns crée les colonnes à partir des champs quand la grille n'en a aucune. Les colonnes définies sont conservées et associées par FieldName.DisableControls et son enregistrement courant est restauré. Fermer le dataset conserve les lignes.BooleanFields affiche comme une case à cocher un indicateur stocké en texte ou en nombre, tel que S et 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;
La source est un composant, donc la même liaison peut vivre dans le fichier de la fiche et se régler dans l'Inspecteur d'objets :
object SourceDB: TsgcGridSource_DataSet
DataSet = cdsProducts
Grid = GridDB
KeyField = 'ID'
end
La même source lie une TsgcFMXGrid FireMonkey avec le même code. La liaison, le regroupement, les synthèses et le filtrage font partie de chaque édition, l'édition Delphi Community gratuite comprise.
Les lignes viennent du dataset ; le regroupement, les synthèses, les filtres et l'export s'exécutent dans la grille.
GroupBy ou en faisant glisser un en-tête vers le panneau de groupesSummaryTypeOnApplySort transmet le tri sous forme de noms de champs, par exemple pour l'IndexFieldNames d'une requête FireDACSaveToXLSX écrit un classeur Excel sans bibliothèque externe, avec les groupes sous forme de plan réductible et les totaux de groupe sous forme de formules SUBTOTAL (édition Registered)
Les cellules modifiées clignotent quand une ligne est mise à jour.
Deux niveaux de groupe, des lignes de détail et des cellules teintées.
Filtre, puis tri sur plusieurs colonnes.
Liée à un 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;
La TDBGrid VCL de base affiche et modifie un dataset. Ce tableau liste ce que chaque grille fait d'office, sans code supplémentaire.
| Fonctionnalité | TDBGrid | sgcGrid | Édition sgcGrid |
|---|---|---|---|
| Lier un TDataSet | Via un TDataSource | TsgcGridSource_DataSet avec DataSet, Grid et KeyField | Toutes |
| Colonnes définies | Columns de TColumn | Columns associées par FieldName, ou AutoColumns | Toutes |
| Lignes modifiées mises à jour sur place, avec un flash | No | Oui, par KeyField | Toutes |
| Tri par clic sur l'en-tête | Code dans OnTitleClick | Intégré, avec OnApplySort pour le dataset | Toutes |
| Regroupement et panneau de groupes | No | GroupBy, ShowGroupPanel | Toutes |
| Synthèses du pied de page et des groupes | No | SummaryType gsuSum, gsuCount, gsuAverage, gsuMin, gsuMax | Toutes |
| Ligne de filtre et filtres de colonne | No | ShowFilterRow, ShowFilterButtons | Toutes |
| Panneau de recherche | No | ShowFindPanel, FindOnlyMatches | Toutes |
| Bandes, ajustement automatique et dispositions enregistrées | No | Bands, BestFitColumns, SaveLayoutToFile, AutoSaveLayout | Toutes |
| Couleurs par cellule sans code de dessin | Code dans OnDrawColumnCell | FormatRules, OnGetCellStyle et OnCustomDrawCell pour un dessin personnalisé | Toutes |
| Sélection multi-lignes | dgMultiSelect, SelectedRows | SelectionMode gsmMultiRow, GetSelectedKeys | Toutes |
| Modifier et valider dans le dataset | Oui, avec dgEditing | WriteBack valide chaque modification dans son enregistrement, SyncCursor garde l'enregistrement courant synchronisé | Registered |
| Export Excel | No | SaveToXLSX, vers un fichier ou un flux | Registered |
| Tables trop grandes pour être chargées | No | Mode serveur avec TsgcGridServerProvider_DataSet, une page à la fois | Registered |
| FireMonkey | Non, VCL uniquement | TsgcFMXGrid sur Windows, macOS, iOS et Android | Toutes |
| .NET | No | Grilles WinForms, WPF et Avalonia | Toutes |
Consulte la matrice complète des fonctionnalités de sgcGrid, les benchmarks et la comparaison de sgcGrid.
Avec WriteBack activé, la source écrit chaque modification de la grille dans l'enregistrement de sa ligne. Elle localise l'enregistrement par KeyField et valide la valeur. Quand la validation échoue, par exemple dans un contrôle BeforePost, l'enregistrement est annulé et la cellule garde son ancienne valeur.
SyncCursor garde ensemble l'enregistrement courant et la ligne ayant le focus, de sorte qu'un TDBNavigator et des contrôles TDBEdit sur le même dataset suivent la grille, et que la grille les suitAllowInsert : Ins ajoute et valide un enregistrement, et OnNewRecord du dataset remplit les valeurs par défautApplyFilter fait garder au dataset uniquement les lignes que la grille affiche, donc les contrôles liés aux données et les états qui l'utilisent voient les lignes filtréesWriteBack, SyncCursor, l'insertion, la suppression, le collage et l'annulation font partie de l'édition Registered. L'essai les inclut pour l'évaluation.
Lire la rubrique d'aide DataSet EditingTrois étapes : importer les colonnes à la conception, remplacer les propriétés et les événements, supprimer la grille DB. Les données restent dans le même TDataSet.
TsgcVCLGrid à côté de la TDBGrid.TsgcGridSource_DataSet lié au dataset du DataSource, copier les dimensions (Parent, Align, Anchors, TabOrder et plus), copier les gestionnaires d'événements, et vider d'abord les colonnes de la grille.L'import copie FieldName, Title.Caption vers Caption, Width (converti en DIP avec le PixelsPerInch de la fiche), Visible, Alignment, ReadOnly vers Editable et PickList. Depuis le code, sgcGridImportDBGrid de l'unité sgcGrid_Import_VCL fait la même chose à l'exécution.
| TDBGrid | sgcGrid |
|---|---|
| TDBGrid | TsgcVCLGrid (unité sgcGrid_VCL) |
| DataSource | TsgcGridSource_DataSet : DataSet, Grid, KeyField, puis Active := True (unité sgcGrid_Source_DataSet) |
| Columns, TColumn.FieldName | Columns, Columns[i].FieldName |
| ReadOnly, Options dgEditing | ReadOnly de la grille et WriteBack de la source (Registered) |
| dgRowSelect | SelectionMode := gsmRow |
| dgMultiSelect, SelectedRows | SelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys |
| dgIndicator | RowHeader := [grhIndicator], aussi grhNumbers et grhCheckBox |
| dgColLines, dgRowLines | GridLinesV, GridLinesH |
| OnDrawColumnCell | OnCustomDrawCell ; pour les couleurs seules, OnGetCellStyle ou FormatRules |
| OnTitleClick | OnHeaderClick ; la grille trie toute seule |
| OnColEnter, OnColExit | OnSelectionChange, avec SelectedCol |
Le kit de migration TDBGrid contient la correspondance complète des membres, le code avant et après de la démo MigrateFromDBGrid, qui compile avec Delphi 7 et Delphi 13 (Win32 et Win64), et les différences connues. D'autres kits sont sur la page migration sgcUI.
Un seul modèle de grille pilote la grille VCL et la grille FireMonkey, donc une fiche VCL et une fiche FireMonkey partagent le code de liaison.
| Cible | Composant | Plateformes |
|---|---|---|
| Delphi 7 à 13, VCL | TsgcVCLGrid | Win32, et Win64 à partir de XE2 |
| Delphi XE6 à 13, FireMonkey | TsgcFMXGrid | Windows, macOS, iOS et Android |
| C++ Builder 2007 à 13 | TsgcVCLGrid, TsgcFMXGrid | En-têtes .hpp générés et bibliothèques statiques |
| .NET Framework 4.7.2, .NET 8, 9 et 10 | TsgcWinFormsGrid, grilles WPF et Avalonia | WinForms, WPF, Avalonia |
L'import des colonnes TDBGrid s'exécute dans le concepteur de fiches VCL. Les fiches FireMonkey lient le dataset avec le même TsgcGridSource_DataSet.
Liaison au DataSet avec colonnes définies associées par FieldName, champs lookup, sélection de cellule, de ligne et multi-lignes, en-tête de ligne, dessin personnalisé, Ctrl+C, panneau de groupes, synthèses du pied de page et des groupes, ligne de filtre, filtre de colonne de style Excel, panneau de recherche, bandes, ajustement automatique, et enregistrement et chargement des dispositions en JSON. L'édition Delphi Community gratuite inclut sgcGrid.
Édition bidirectionnelle dans le dataset (WriteBack), synchronisation du curseur (SyncCursor), insertion, suppression, collage et annulation, export Excel, vue en cartes et mode serveur pour les très grandes tables. sgcGrid se vend seule avec des licences Single, Team et Site et le code source complet, et est incluse dans sgcUI Standard, Professional, Enterprise et All-Access.
Voir les tarifs de sgcGrid ou télécharger l'essai, qui inclut toutes les fonctionnalités Registered pour l'évaluation.
Dépose une TsgcVCLGrid à côté de la TDBGrid, fais un clic droit dessus et choisis Import columns from DB grid. L'import copie les colonnes, crée un TsgcGridSource_DataSet lié au même dataset, copie les dimensions et les gestionnaires d'événements, et signale les événements à porter à la main. Supprime ensuite la TDBGrid. Le kit de migration associe chaque propriété et chaque événement.
TDBGrid est un contrôle VCL. sgcGrid a une grille FireMonkey, TsgcFMXGrid, pour Delphi XE6 à 13 sur Windows, macOS, iOS et Android, et le même TsgcGridSource_DataSet la lie à n'importe quel TDataSet avec le même code que la grille VCL.
Oui. Appelle GroupBy avec les noms de champs, ou laisse les utilisateurs faire glisser un en-tête de colonne vers le panneau de groupes. Règle SummaryType sur une colonne (somme, nombre, moyenne, minimum ou maximum) et active ShowFooter : les totaux apparaissent dans le pied de page et dans chaque ligne de groupe. Le regroupement et les synthèses font partie de chaque édition, Community comprise.
Lie le dataset à sgcGrid et appelle SaveToXLSX avec un nom de fichier ou un flux. Le classeur n'a besoin d'aucune bibliothèque externe et garde ce que voit l'utilisateur : les colonnes visibles dans l'ordre d'affichage avec leurs largeurs et formats numériques, l'en-tête figé, les groupes sous forme de plan réductible et les totaux de groupe sous forme de formules SUBTOTAL. L'export Excel fait partie de l'édition Registered ; l'édition Community exporte en JSON et en CSV.
Oui. Un TFDQuery ou un TFDTable est un TDataSet, donc TsgcGridSource_DataSet le lie comme un TClientDataSet. OnApplySort transmet le tri de la grille sous la forme des IndexFieldNames de FireDAC, par exemple Name;Date:D. Pour une table trop grande pour être chargée, le mode serveur (Registered) avec TsgcGridServerProvider_DataSet lit une page à la fois et laisse la base de données trier, filtrer, compter et regrouper en SQL, exécuté par FireDAC ou un autre composant de requête.
Oui, dans l'édition Registered. Avec WriteBack, la source valide chaque modification dans l'enregistrement de sa ligne, localisé par KeyField, et SyncCursor garde ensemble l'enregistrement courant et la ligne ayant le focus, de sorte qu'un TDBNavigator et des contrôles TDBEdit sur le même dataset restent synchronisés. Dans l'édition Community, la grille affiche le dataset en lecture seule.