Delphi & C++ Builder VCL y FireMonkey

sgcGrid, un sustituto de DBGrid con enlace a datos para Delphi

sgcGrid es una cuadrícula de Delphi con enlace a datos que se conecta al TDataSet que ya usa tu DBGrid, y después agrupa, totaliza, filtra y exporta las mismas filas.

Agrupación con totales
Fila de filtro y panel de búsqueda
Las filas modificadas se actualizan en el sitio
Exportación a Excel
Cualquier TDataSetDelphi 7 a 13FireMonkey desde XE6Edición gratuita Delphi Community

Migrar desde TDBGrid → · Ver precios →

Cuadrícula de datos de Delphi que agrupa clientes por región con resúmenes en cada fila de grupo y totales en el pie, junto a una tarjeta de contacto y un mapa de ubicación, sgcGrid en la demo Altamira ERP

Enlaza sgcGrid a un TDataSet, TFDQuery o TClientDataSet

El código de tu base de datos sigue funcionando. Solo cambian la cuadrícula y el enlace entre la cuadrícula y el dataset.

sgcGrid se enlaza a un TFDQuery de FireDAC, a un TClientDataSet o a cualquier otro dataset. Además de lo que muestra TDBGrid, agrupa y totaliza filas, filtra con una fila de filtros, filtros de columna y un panel de búsqueda, exporta a Excel y actualiza las filas modificadas en el sitio, en VCL y en FireMonkey.

Un TDBGrid lee su dataset a través de un TDataSource. En sgcGrid, un TsgcGridSource_DataSet ocupa el lugar del TDataSource: establece su Grid y DataSet, ponlo en Active, y aparecen las filas. El dataset puede ser una consulta FireDAC, un TClientDataSet o cualquier otro descendiente de TDataSet.

  • Con un KeyField la cuadrícula se sincroniza en lugar de recargarse: las filas modificadas se actualizan en el sitio y destellan, las claves nuevas se añaden y las claves que faltan se eliminan.
  • LiveUpdates hace que la cuadrícula siga cada Post, Delete y Refresh del dataset.
  • AutoColumns crea las columnas a partir de los campos cuando la cuadrícula no tiene ninguna. Las columnas diseñadas se conservan y se emparejan por FieldName.
  • El dataset se recorre con DisableControls y se restaura su registro actual. Cerrar el dataset conserva las filas.
  • Los campos lookup rellenan la lista desplegable de su columna, y BooleanFields muestra como casilla de verificación un indicador guardado como texto o número, como S y N.
Delphi, una consulta FireDAC en 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 fuente es un componente, así que el mismo enlace puede vivir en el archivo del formulario y establecerse en el Inspector de objetos:

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

La misma fuente enlaza un TsgcFMXGrid de FireMonkey con el mismo código. El enlace, la agrupación, los resúmenes y el filtrado forman parte de todas las ediciones, incluida la edición gratuita Delphi Community.

Lee el tema de ayuda sobre el enlace a DataSet

Agrupa, totaliza, filtra y exporta las mismas filas

Las filas vienen del dataset; la agrupación, los resúmenes, los filtros y la exportación se ejecutan en la cuadrícula.

sgcGrid con 100.000 pedidos agrupados por Region y luego por Category, chips en el panel de grupos y totales en el pie

Lo que gana un usuario de DBGrid

  • Agrupación por una o más columnas, desde código con GroupBy o arrastrando una cabecera al panel de grupos
  • Suma, recuento, media, mínimo y máximo en el pie y en cada fila de grupo, con SummaryType
  • Una fila de filtros, un filtro al estilo Excel en cada columna y un panel de búsqueda que resalta las coincidencias
  • Un clic en la cabecera ordena por sí solo, y OnApplySort pasa la ordenación como nombres de campo, por ejemplo para el IndexFieldNames de una consulta FireDAC
  • SaveToXLSX escribe un libro de Excel sin biblioteca externa, con los grupos como un esquema plegable y los totales de grupo como fórmulas SUBTOTAL (edición Registered)
  • Bandas, ajuste óptimo, selector de columnas, y el diseño de columnas guardado y cargado como JSON
Delphi, agrupación, totales, filtros y 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 y sgcGrid comparados

El TDBGrid estándar de VCL muestra y edita un dataset. Esta tabla enumera lo que hace cada cuadrícula de serie, sin código adicional.

CaracterísticaTDBGridsgcGridEdición de sgcGrid
Enlazar un TDataSetA través de un TDataSourceTsgcGridSource_DataSet con DataSet, Grid y KeyFieldTodas
Columnas diseñadasColumns de TColumnColumns emparejadas por FieldName, o AutoColumnsTodas
Filas modificadas actualizadas en el sitio, con destelloNoSí, por KeyFieldTodas
Ordenar con un clic en la cabeceraCódigo en OnTitleClickIntegrado, con OnApplySort para el datasetTodas
Agrupación y panel de gruposNoGroupBy, ShowGroupPanelTodas
Resúmenes de pie y de grupoNoSummaryType gsuSum, gsuCount, gsuAverage, gsuMin, gsuMaxTodas
Fila de filtros y filtros de columnaNoShowFilterRow, ShowFilterButtonsTodas
Panel de búsquedaNoShowFindPanel, FindOnlyMatchesTodas
Bandas, ajuste óptimo y diseños guardadosNoBands, BestFitColumns, SaveLayoutToFile, AutoSaveLayoutTodas
Colores por celda sin código de dibujoCódigo en OnDrawColumnCellFormatRules, OnGetCellStyle y OnCustomDrawCell para pintado personalizadoTodas
Selección de varias filasdgMultiSelect, SelectedRowsSelectionMode gsmMultiRow, GetSelectedKeysTodas
Editar y publicar en el datasetSí, con dgEditingWriteBack publica cada edición en su registro, SyncCursor mantiene sincronizado el registro actualRegistered
Exportación a ExcelNoSaveToXLSX, a un archivo o a un flujoRegistered
Tablas demasiado grandes para cargarlasNoModo servidor con TsgcGridServerProvider_DataSet, una página cada vezRegistered
FireMonkeyNo, solo VCLTsgcFMXGrid en Windows, macOS, iOS y AndroidTodas
.NETNoCuadrículas de WinForms, WPF y AvaloniaTodas

Consulta la matriz completa de características de sgcGrid, las pruebas comparativas y la comparación de sgcGrid.

Demo DataSetEditing: un TDBNavigator y dos TDBEdit sobre los mismos registros que la cuadrícula, con una columna lookup de categoría

Edita el dataset a través de la cuadrícula

Con WriteBack activado, la fuente escribe cada edición de la cuadrícula en el registro de su fila. Localiza el registro por KeyField y publica el valor. Cuando la publicación falla, por ejemplo en una comprobación BeforePost, el registro se cancela y la celda conserva su valor anterior.

  • SyncCursor mantiene juntos el registro actual y la fila con el foco, de modo que un TDBNavigator y controles TDBEdit sobre el mismo dataset siguen a la cuadrícula, y la cuadrícula los sigue a ellos
  • AllowInsert: Ins añade y publica un registro, y OnNewRecord del dataset rellena los valores por defecto
  • ApplyFilter hace que el dataset conserve solo las filas que muestra la cuadrícula, así los controles de datos y los informes sobre él ven las filas filtradas

WriteBack, SyncCursor, insertar, eliminar, pegar y deshacer forman parte de la edición Registered. La prueba los incluye para evaluación.

Lee el tema de ayuda sobre la edición de DataSet

Cómo sustituir TDBGrid en Delphi

Tres pasos: importa las columnas en tiempo de diseño, sustituye las propiedades y los eventos, elimina la cuadrícula DB. Los datos siguen en el mismo TDataSet.

  1. Guarda el formulario y después coloca un TsgcVCLGrid junto al TDBGrid.
  2. Haz clic derecho en la cuadrícula, elige Import columns from DB grid... y selecciona el TDBGrid de la lista.
  3. Deja marcadas las cuatro opciones: crear un TsgcGridSource_DataSet enlazado al dataset del DataSource, copiar los límites (Parent, Align, Anchors, TabOrder y más), copiar los manejadores de eventos y limpiar antes las columnas de la cuadrícula.
  4. Lee el informe. Enumera cada columna importada y cada evento que hay que portar a mano.
  5. Comprueba el resultado, y después elimina el TDBGrid, y su TDataSource si nada más lo usa.

La importación copia FieldName, Title.Caption a Caption, Width (convertido a DIPs con el PixelsPerInch del formulario), Visible, Alignment, ReadOnly a Editable y PickList. Desde código, sgcGridImportDBGrid de la unidad sgcGrid_Import_VCL hace lo mismo en tiempo de ejecución.

TDBGridsgcGrid
TDBGridTsgcVCLGrid (unidad sgcGrid_VCL)
DataSourceTsgcGridSource_DataSet: DataSet, Grid, KeyField, y después Active := True (unidad sgcGrid_Source_DataSet)
Columns, TColumn.FieldNameColumns, Columns[i].FieldName
ReadOnly, Options dgEditingReadOnly de la cuadrícula y WriteBack de la fuente (Registered)
dgRowSelectSelectionMode := gsmRow
dgMultiSelect, SelectedRowsSelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys
dgIndicatorRowHeader := [grhIndicator], también grhNumbers y grhCheckBox
dgColLines, dgRowLinesGridLinesV, GridLinesH
OnDrawColumnCellOnCustomDrawCell; solo para colores, OnGetCellStyle o FormatRules
OnTitleClickOnHeaderClick; la cuadrícula ordena por sí sola
OnColEnter, OnColExitOnSelectionChange, con SelectedCol

El kit de migración de TDBGrid incluye el mapa completo de miembros, código de antes y después de la demo MigrateFromDBGrid, que compila con Delphi 7 y Delphi 13 (Win32 y Win64), y las diferencias conocidas. Otros kits están en la página de migración de sgcUI.

VCL, FireMonkey y versiones de Delphi

Un único modelo de cuadrícula mueve la cuadrícula VCL y la de FireMonkey, así que un formulario VCL y uno FireMonkey comparten el código de enlace.

DestinoComponentePlataformas
Delphi 7 a 13, VCLTsgcVCLGridWin32, y Win64 desde XE2
Delphi XE6 a 13, FireMonkeyTsgcFMXGridWindows, macOS, iOS y Android
C++ Builder 2007 a 13TsgcVCLGrid, TsgcFMXGridCabeceras .hpp generadas y bibliotecas estáticas
.NET Framework 4.7.2, .NET 8, 9 y 10TsgcWinFormsGrid, cuadrículas de WPF y AvaloniaWinForms, WPF, Avalonia

La importación de columnas de TDBGrid se ejecuta en el diseñador de formularios VCL. Los formularios FireMonkey enlazan el dataset con el mismo TsgcGridSource_DataSet.

Community y Registered

En todas las ediciones

Enlace a DataSet con columnas diseñadas emparejadas por FieldName, campos lookup, selección de celda, fila y varias filas, cabecera de fila, dibujo personalizado, Ctrl+C, panel de grupos, resúmenes de pie y de grupo, fila de filtros, filtro de columna al estilo Excel, panel de búsqueda, bandas, ajuste óptimo, y guardado y carga de diseños en JSON. La edición gratuita Delphi Community incluye sgcGrid.

Edición Registered

Edición bidireccional en el dataset (WriteBack), sincronización del cursor (SyncCursor), insertar, eliminar, pegar y deshacer, exportación a Excel, la vista de tarjetas y el modo servidor para tablas muy grandes. sgcGrid se vende solo con licencias Single, Team y Site y código fuente completo, y está incluido en sgcUI Standard, Professional, Enterprise y All-Access.

Ver precios de sgcGrid o descargar la prueba, que incluye todas las características Registered para evaluación.

Preguntas frecuentes

Coloca un TsgcVCLGrid junto al TDBGrid, haz clic derecho en él y elige Import columns from DB grid. La importación copia las columnas, crea un TsgcGridSource_DataSet enlazado al mismo dataset, copia los límites y los manejadores de eventos, e informa de los eventos que hay que portar a mano. Después elimina el TDBGrid. El kit de migración asigna cada propiedad y evento.

TDBGrid es un control VCL. sgcGrid tiene una cuadrícula FireMonkey, TsgcFMXGrid, para Delphi XE6 a 13 en Windows, macOS, iOS y Android, y el mismo TsgcGridSource_DataSet la enlaza a cualquier TDataSet con el mismo código que la cuadrícula VCL.

Sí. Llama a GroupBy con los nombres de campo, o deja que los usuarios arrastren una cabecera de columna al panel de grupos. Establece SummaryType en una columna (suma, recuento, media, mínimo o máximo) y activa ShowFooter: los totales aparecen en el pie y en cada fila de grupo. La agrupación y los resúmenes forman parte de todas las ediciones, Community incluida.

Enlaza el dataset a sgcGrid y llama a SaveToXLSX con un nombre de archivo o un flujo. El libro no necesita biblioteca externa y conserva lo que ve el usuario: las columnas visibles en el orden de pantalla con sus anchos y formatos numéricos, la cabecera fija, los grupos como un esquema plegable y los totales de grupo como fórmulas SUBTOTAL. La exportación a Excel forma parte de la edición Registered; la edición Community exporta JSON y CSV.

Sí. Un TFDQuery o un TFDTable es un TDataSet, así que TsgcGridSource_DataSet lo enlaza igual que un TClientDataSet. OnApplySort pasa la ordenación de la cuadrícula en forma de IndexFieldNames de FireDAC, por ejemplo Name;Date:D. Para una tabla demasiado grande para cargarla, el modo servidor (Registered) con TsgcGridServerProvider_DataSet lee una página cada vez y deja que la base de datos ordene, filtre, cuente y agrupe con SQL, ejecutado por FireDAC u otro componente de consulta.

Sí, en la edición Registered. Con WriteBack la fuente publica cada edición en el registro de su fila, localizado por KeyField, y SyncCursor mantiene juntos el registro actual y la fila con el foco, así que un TDBNavigator y controles TDBEdit sobre el mismo dataset permanecen sincronizados. En la edición Community la cuadrícula muestra el dataset en solo lectura.

La mejor opción: All-AccessTodos los productos de eSeGeCe, con Premium Support incluido, desde €1,059 al año.
Ver precios de All-Access

Lleva tus formularios DBGrid a sgcGrid

Descarga la prueba y enlaza sgcGrid a los datasets que tu aplicación Delphi ya tiene.