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.
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.
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.
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.DisableControls y se restaura su registro actual. Cerrar el dataset conserva las filas.BooleanFields muestra como casilla de verificación un indicador guardado como texto o número, como S y 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 fuente es un componente, así que el mismo enlace puede vivir en el archivo del formulario y establecerse en el Inspector de objetos:
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.
Las filas vienen del dataset; la agrupación, los resúmenes, los filtros y la exportación se ejecutan en la cuadrícula.
GroupBy o arrastrando una cabecera al panel de gruposSummaryTypeOnApplySort pasa la ordenación como nombres de campo, por ejemplo para el IndexFieldNames de una consulta FireDACSaveToXLSX 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)
Las celdas modificadas destellan cuando se actualiza una fila.
Dos niveles de grupo, filas de detalle y celdas teñidas.
Filtra y después ordena por varias columnas.
Enlazado a un TClientDataSet mediante 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;
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ística | TDBGrid | sgcGrid | Edición de sgcGrid |
|---|---|---|---|
| Enlazar un TDataSet | A través de un TDataSource | TsgcGridSource_DataSet con DataSet, Grid y KeyField | Todas |
| Columnas diseñadas | Columns de TColumn | Columns emparejadas por FieldName, o AutoColumns | Todas |
| Filas modificadas actualizadas en el sitio, con destello | No | Sí, por KeyField | Todas |
| Ordenar con un clic en la cabecera | Código en OnTitleClick | Integrado, con OnApplySort para el dataset | Todas |
| Agrupación y panel de grupos | No | GroupBy, ShowGroupPanel | Todas |
| Resúmenes de pie y de grupo | No | SummaryType gsuSum, gsuCount, gsuAverage, gsuMin, gsuMax | Todas |
| Fila de filtros y filtros de columna | No | ShowFilterRow, ShowFilterButtons | Todas |
| Panel de búsqueda | No | ShowFindPanel, FindOnlyMatches | Todas |
| Bandas, ajuste óptimo y diseños guardados | No | Bands, BestFitColumns, SaveLayoutToFile, AutoSaveLayout | Todas |
| Colores por celda sin código de dibujo | Código en OnDrawColumnCell | FormatRules, OnGetCellStyle y OnCustomDrawCell para pintado personalizado | Todas |
| Selección de varias filas | dgMultiSelect, SelectedRows | SelectionMode gsmMultiRow, GetSelectedKeys | Todas |
| Editar y publicar en el dataset | Sí, con dgEditing | WriteBack publica cada edición en su registro, SyncCursor mantiene sincronizado el registro actual | Registered |
| Exportación a Excel | No | SaveToXLSX, a un archivo o a un flujo | Registered |
| Tablas demasiado grandes para cargarlas | No | Modo servidor con TsgcGridServerProvider_DataSet, una página cada vez | Registered |
| FireMonkey | No, solo VCL | TsgcFMXGrid en Windows, macOS, iOS y Android | Todas |
| .NET | No | Cuadrículas de WinForms, WPF y Avalonia | Todas |
Consulta la matriz completa de características de sgcGrid, las pruebas comparativas y la comparación de sgcGrid.
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 ellosAllowInsert: Ins añade y publica un registro, y OnNewRecord del dataset rellena los valores por defectoApplyFilter 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 filtradasWriteBack, 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 DataSetTres 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.
TsgcVCLGrid junto al TDBGrid.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.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.
| TDBGrid | sgcGrid |
|---|---|
| TDBGrid | TsgcVCLGrid (unidad sgcGrid_VCL) |
| DataSource | TsgcGridSource_DataSet: DataSet, Grid, KeyField, y después Active := True (unidad sgcGrid_Source_DataSet) |
| Columns, TColumn.FieldName | Columns, Columns[i].FieldName |
| ReadOnly, Options dgEditing | ReadOnly de la cuadrícula y WriteBack de la fuente (Registered) |
| dgRowSelect | SelectionMode := gsmRow |
| dgMultiSelect, SelectedRows | SelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys |
| dgIndicator | RowHeader := [grhIndicator], también grhNumbers y grhCheckBox |
| dgColLines, dgRowLines | GridLinesV, GridLinesH |
| OnDrawColumnCell | OnCustomDrawCell; solo para colores, OnGetCellStyle o FormatRules |
| OnTitleClick | OnHeaderClick; la cuadrícula ordena por sí sola |
| OnColEnter, OnColExit | OnSelectionChange, 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.
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.
| Destino | Componente | Plataformas |
|---|---|---|
| Delphi 7 a 13, VCL | TsgcVCLGrid | Win32, y Win64 desde XE2 |
| Delphi XE6 a 13, FireMonkey | TsgcFMXGrid | Windows, macOS, iOS y Android |
| C++ Builder 2007 a 13 | TsgcVCLGrid, TsgcFMXGrid | Cabeceras .hpp generadas y bibliotecas estáticas |
| .NET Framework 4.7.2, .NET 8, 9 y 10 | TsgcWinFormsGrid, cuadrículas de WPF y Avalonia | WinForms, 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.
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 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.
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.