Delphi & C++ Builder VCL et FireMonkey

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.

Regroupement avec totaux
Ligne de filtre et panneau de recherche
Les lignes modifiées se mettent à jour sur place
Export Excel
N'importe quel TDataSetDelphi 7 à 13FireMonkey à partir de XE6Édition Delphi Community gratuite

Migrer depuis TDBGrid → · Voir les tarifs →

Grille de données Delphi regroupant des clients par région, avec des synthèses dans chaque ligne de groupe et des totaux dans le pied de page, à côté d'une fiche contact et d'une carte, sgcGrid dans la démo Altamira ERP

Lie sgcGrid à un TDataSet, un TFDQuery ou un TClientDataSet

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.

  • Avec un 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.
  • Le dataset est parcouru avec DisableControls et son enregistrement courant est restauré. Fermer le dataset conserve les lignes.
  • Les champs lookup alimentent la liste déroulante de leur colonne, et BooleanFields affiche comme une case à cocher un indicateur stocké en texte ou en nombre, tel que S et N.
Delphi, une requête FireDAC dans 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;

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 :

frmMain.dfm
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.

Lire la rubrique d'aide DataSet Binding

Regroupe, totalise, filtre et exporte les mêmes lignes

Les lignes viennent du dataset ; le regroupement, les synthèses, les filtres et l'export s'exécutent dans la grille.

sgcGrid avec 100 000 commandes regroupées par Region puis Category, puces du panneau de groupes et totaux du pied de page

Ce que gagne un utilisateur de DBGrid

  • Regroupement par une ou plusieurs colonnes, depuis le code avec GroupBy ou en faisant glisser un en-tête vers le panneau de groupes
  • Somme, nombre, moyenne, minimum et maximum dans le pied de page et dans chaque ligne de groupe, avec SummaryType
  • Une ligne de filtre, un filtre de style Excel sur chaque colonne et un panneau de recherche qui surligne les correspondances
  • Un clic sur l'en-tête trie tout seul, et OnApplySort transmet le tri sous forme de noms de champs, par exemple pour l'IndexFieldNames d'une requête FireDAC
  • SaveToXLSX é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)
  • Bandes, ajustement automatique, sélecteur de colonnes, et disposition des colonnes enregistrée et chargée en JSON
Delphi, regroupement, totaux, filtres et 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 et sgcGrid comparées

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éTDBGridsgcGridÉdition sgcGrid
Lier un TDataSetVia un TDataSourceTsgcGridSource_DataSet avec DataSet, Grid et KeyFieldToutes
Colonnes définiesColumns de TColumnColumns associées par FieldName, ou AutoColumnsToutes
Lignes modifiées mises à jour sur place, avec un flashNoOui, par KeyFieldToutes
Tri par clic sur l'en-têteCode dans OnTitleClickIntégré, avec OnApplySort pour le datasetToutes
Regroupement et panneau de groupesNoGroupBy, ShowGroupPanelToutes
Synthèses du pied de page et des groupesNoSummaryType gsuSum, gsuCount, gsuAverage, gsuMin, gsuMaxToutes
Ligne de filtre et filtres de colonneNoShowFilterRow, ShowFilterButtonsToutes
Panneau de rechercheNoShowFindPanel, FindOnlyMatchesToutes
Bandes, ajustement automatique et dispositions enregistréesNoBands, BestFitColumns, SaveLayoutToFile, AutoSaveLayoutToutes
Couleurs par cellule sans code de dessinCode dans OnDrawColumnCellFormatRules, OnGetCellStyle et OnCustomDrawCell pour un dessin personnaliséToutes
Sélection multi-lignesdgMultiSelect, SelectedRowsSelectionMode gsmMultiRow, GetSelectedKeysToutes
Modifier et valider dans le datasetOui, avec dgEditingWriteBack valide chaque modification dans son enregistrement, SyncCursor garde l'enregistrement courant synchroniséRegistered
Export ExcelNoSaveToXLSX, vers un fichier ou un fluxRegistered
Tables trop grandes pour être chargéesNoMode serveur avec TsgcGridServerProvider_DataSet, une page à la foisRegistered
FireMonkeyNon, VCL uniquementTsgcFMXGrid sur Windows, macOS, iOS et AndroidToutes
.NETNoGrilles WinForms, WPF et AvaloniaToutes

Consulte la matrice complète des fonctionnalités de sgcGrid, les benchmarks et la comparaison de sgcGrid.

Démo DataSetEditing : un TDBNavigator et deux TDBEdit sur les mêmes enregistrements que la grille, avec une colonne lookup de catégorie

Modifie le dataset via la grille

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 suit
  • AllowInsert : Ins ajoute et valide un enregistrement, et OnNewRecord du dataset remplit les valeurs par défaut
  • ApplyFilter 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ées

WriteBack, 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 Editing

Comment remplacer TDBGrid dans Delphi

Trois é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.

  1. Enregistre la fiche, puis dépose un TsgcVCLGrid à côté de la TDBGrid.
  2. Fais un clic droit sur la grille, choisis Import columns from DB grid... et sélectionne la TDBGrid dans la liste.
  3. Garde les quatre options cochées : créer un 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.
  4. Lis le rapport. Il liste chaque colonne importée et chaque événement à porter à la main.
  5. Vérifie le résultat, puis supprime la TDBGrid, et son TDataSource si rien d'autre ne l'utilise.

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.

TDBGridsgcGrid
TDBGridTsgcVCLGrid (unité sgcGrid_VCL)
DataSourceTsgcGridSource_DataSet : DataSet, Grid, KeyField, puis Active := True (unité sgcGrid_Source_DataSet)
Columns, TColumn.FieldNameColumns, Columns[i].FieldName
ReadOnly, Options dgEditingReadOnly de la grille et WriteBack de la source (Registered)
dgRowSelectSelectionMode := gsmRow
dgMultiSelect, SelectedRowsSelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys
dgIndicatorRowHeader := [grhIndicator], aussi grhNumbers et grhCheckBox
dgColLines, dgRowLinesGridLinesV, GridLinesH
OnDrawColumnCellOnCustomDrawCell ; pour les couleurs seules, OnGetCellStyle ou FormatRules
OnTitleClickOnHeaderClick ; la grille trie toute seule
OnColEnter, OnColExitOnSelectionChange, 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.

VCL, FireMonkey et versions de Delphi

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.

CibleComposantPlateformes
Delphi 7 à 13, VCLTsgcVCLGridWin32, et Win64 à partir de XE2
Delphi XE6 à 13, FireMonkeyTsgcFMXGridWindows, macOS, iOS et Android
C++ Builder 2007 à 13TsgcVCLGrid, TsgcFMXGridEn-têtes .hpp générés et bibliothèques statiques
.NET Framework 4.7.2, .NET 8, 9 et 10TsgcWinFormsGrid, grilles WPF et AvaloniaWinForms, 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.

Community et Registered

Dans chaque édition

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 Registered

É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.

Foire aux questions

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.

Meilleur rapport qualité-prix : All-AccessTous les produits eSeGeCe, Support Premium inclus, à partir de €1,059/an.
Voir les tarifs All-Access

Déplace tes fiches DBGrid vers sgcGrid

Télécharge l'essai et lie sgcGrid aux datasets que ton application Delphi possède déjà.