Delphi & C++ Builder VCL e FireMonkey

sgcGrid, um substituto do DBGrid com dados para Delphi

O sgcGrid é uma grade Delphi com suporte a dados que se vincula ao TDataSet que o seu DBGrid já usa e depois agrupa, totaliza, filtra e exporta as mesmas linhas.

Agrupamento com totais
Linha de filtro e painel de busca
As linhas alteradas são atualizadas no local
Exportação para Excel
Qualquer TDataSetDelphi 7 a 13FireMonkey a partir do XE6Edição Delphi Community gratuita

Migrar do TDBGrid → · Ver preços →

Grade de dados Delphi agrupando clientes por região com resumos em cada linha de grupo e totais no rodapé, ao lado de um cartão de contato e de um mapa de localização, sgcGrid na demonstração Altamira ERP

Vincule o sgcGrid a um TDataSet, TFDQuery ou TClientDataSet

O código do seu banco de dados continua funcionando. Só mudam a grade e a ligação entre a grade e o dataset.

O sgcGrid se vincula a um TFDQuery do FireDAC, a um TClientDataSet ou a qualquer outro dataset. Além do que o TDBGrid exibe, ele agrupa e totaliza linhas, filtra com uma linha de filtro, filtros de coluna e um painel de busca, exporta para Excel e atualiza linhas alteradas no local, em VCL e em FireMonkey.

Um TDBGrid lê seu dataset por meio de um TDataSource. No sgcGrid, um TsgcGridSource_DataSet ocupa o lugar do TDataSource: defina Grid e DataSet, torne-o Active, e as linhas aparecem. O dataset pode ser uma consulta FireDAC, um TClientDataSet ou qualquer outro descendente de TDataSet.

  • Com um KeyField, a grade é sincronizada em vez de recarregada: as linhas alteradas são atualizadas no local e piscam, as chaves novas são adicionadas e as chaves ausentes são excluídas.
  • LiveUpdates faz a grade acompanhar cada Post, Delete e Refresh do dataset.
  • AutoColumns cria as colunas a partir dos campos quando a grade não tem nenhuma. As colunas projetadas são mantidas e associadas por FieldName.
  • O dataset é percorrido com DisableControls e o registro atual é restaurado. Fechar o dataset mantém as linhas.
  • Os campos de lookup preenchem a lista suspensa da coluna, e BooleanFields exibe um indicador armazenado como texto ou número, como S e N, como uma caixa de seleção.
Delphi, uma consulta FireDAC no 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;

A fonte é um componente, então o mesmo binding pode ficar no arquivo do formulário e ser definido no Object Inspector:

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

A mesma fonte vincula um TsgcFMXGrid do FireMonkey com o mesmo código. Binding, agrupamento, resumos e filtragem fazem parte de todas as edições, inclusive da edição Delphi Community gratuita.

Leia o tópico de ajuda DataSet Binding

Agrupe, totalize, filtre e exporte as mesmas linhas

As linhas vêm do dataset; agrupamento, resumos, filtros e exportação rodam na grade.

sgcGrid com 100.000 pedidos agrupados por Region e depois Category, chips no painel de agrupamento e totais no rodapé

O que um usuário de DBGrid ganha

  • Agrupamento por uma ou mais colunas, pelo código com GroupBy ou arrastando um cabeçalho para o painel de agrupamento
  • Soma, contagem, média, mínimo e máximo no rodapé e em cada linha de grupo, com SummaryType
  • Uma linha de filtro, um filtro estilo Excel em cada coluna e um painel de busca que destaca as ocorrências
  • Um clique no cabeçalho ordena sozinho, e OnApplySort passa a ordenação como nomes de campos, por exemplo para o IndexFieldNames de uma consulta FireDAC
  • SaveToXLSX grava uma pasta de trabalho do Excel sem biblioteca externa, com grupos como estrutura recolhível e totais de grupo como fórmulas SUBTOTAL (edição Registered)
  • Bandas, ajuste automático, seletor de colunas e o layout das colunas salvo e carregado como JSON
Delphi, agrupamento, totais, filtros e 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 e sgcGrid comparados

O TDBGrid padrão da VCL exibe e edita um dataset. Esta tabela lista o que cada grade faz de fábrica, sem código extra.

RecursoTDBGridsgcGridEdição do sgcGrid
Vincular um TDataSetPor meio de um TDataSourceTsgcGridSource_DataSet com DataSet, Grid e KeyFieldTodas
Colunas projetadasColumns de TColumnColumns associadas por FieldName, ou AutoColumnsTodas
Linhas alteradas atualizadas no local, com flashNoSim, por KeyFieldTodas
Ordenar com um clique no cabeçalhoCódigo em OnTitleClickIntegrado, com OnApplySort para o datasetTodas
Agrupamento e painel de agrupamentoNoGroupBy, ShowGroupPanelTodas
Resumos de rodapé e de grupoNoSummaryType gsuSum, gsuCount, gsuAverage, gsuMin, gsuMaxTodas
Linha de filtro e filtros de colunaNoShowFilterRow, ShowFilterButtonsTodas
Painel de buscaNoShowFindPanel, FindOnlyMatchesTodas
Bandas, ajuste automático e layouts salvosNoBands, BestFitColumns, SaveLayoutToFile, AutoSaveLayoutTodas
Cores por célula sem código de desenhoCódigo em OnDrawColumnCellFormatRules, OnGetCellStyle e OnCustomDrawCell para pintura personalizadaTodas
Seleção de várias linhasdgMultiSelect, SelectedRowsSelectionMode gsmMultiRow, GetSelectedKeysTodas
Editar e gravar no datasetSim, com dgEditingWriteBack grava cada edição no seu registro, SyncCursor mantém o registro atual sincronizadoRegistered
Exportação para ExcelNoSaveToXLSX, para um arquivo ou um streamRegistered
Tabelas grandes demais para carregarNoModo servidor com TsgcGridServerProvider_DataSet, uma página por vezRegistered
FireMonkeyNão, somente VCLTsgcFMXGrid no Windows, macOS, iOS e AndroidTodas
.NETNoGrades WinForms, WPF e AvaloniaTodas

Veja a matriz completa de recursos do sgcGrid, os benchmarks e a comparação do sgcGrid.

Demonstração DataSetEditing: um TDBNavigator e dois TDBEdits nos mesmos registros da grade, com uma coluna de lookup de categoria

Edite o dataset por meio da grade

Com WriteBack ativado, a fonte grava cada edição da grade no registro da sua linha. Ela localiza o registro por KeyField e grava o valor. Quando a gravação falha, por exemplo em uma verificação de BeforePost, o registro é cancelado e a célula mantém o valor antigo.

  • SyncCursor mantém o registro atual e a linha com foco juntos, de modo que um TDBNavigator e controles TDBEdit no mesmo dataset acompanham a grade, e a grade os acompanha
  • AllowInsert: Ins adiciona e grava um registro, e OnNewRecord do dataset preenche os valores padrão
  • ApplyFilter faz o dataset manter apenas as linhas que a grade exibe, de modo que controles e relatórios com suporte a dados vejam as linhas filtradas

WriteBack, SyncCursor, inserção, exclusão, colagem e desfazer fazem parte da edição Registered. A versão de avaliação os inclui para teste.

Leia o tópico de ajuda DataSet Editing

Como substituir o TDBGrid no Delphi

Três passos: importe as colunas em tempo de design, substitua as propriedades e os eventos, exclua o DB grid. Os dados continuam no mesmo TDataSet.

  1. Salve o formulário e depois solte um TsgcVCLGrid ao lado do TDBGrid.
  2. Clique com o botão direito na grade, escolha Import columns from DB grid... e selecione o TDBGrid na lista.
  3. Mantenha as quatro opções marcadas: criar um TsgcGridSource_DataSet ligado ao dataset do DataSource, copiar os limites (Parent, Align, Anchors, TabOrder e mais), copiar os manipuladores de eventos e limpar antes as colunas da grade.
  4. Leia o relatório. Ele lista cada coluna importada e cada evento que precisa ser portado manualmente.
  5. Confira o resultado e depois exclua o TDBGrid e o TDataSource dele, quando mais nada o usar.

A importação copia FieldName, Title.Caption para Caption, Width (convertido para DIPs com o PixelsPerInch do formulário), Visible, Alignment, ReadOnly para Editable e PickList. Pelo código, sgcGridImportDBGrid na unit sgcGrid_Import_VCL faz o mesmo em tempo de execução.

TDBGridsgcGrid
TDBGridTsgcVCLGrid (unit sgcGrid_VCL)
DataSourceTsgcGridSource_DataSet: DataSet, Grid, KeyField e depois Active := True (unit sgcGrid_Source_DataSet)
Columns, TColumn.FieldNameColumns, Columns[i].FieldName
ReadOnly, Options dgEditingReadOnly da grade e WriteBack da fonte (Registered)
dgRowSelectSelectionMode := gsmRow
dgMultiSelect, SelectedRowsSelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys
dgIndicatorRowHeader := [grhIndicator], também grhNumbers e grhCheckBox
dgColLines, dgRowLinesGridLinesV, GridLinesH
OnDrawColumnCellOnCustomDrawCell; só para cores, OnGetCellStyle ou FormatRules
OnTitleClickOnHeaderClick; a grade ordena sozinha
OnColEnter, OnColExitOnSelectionChange, com SelectedCol

O kit de migração do TDBGrid traz o mapa completo de membros, código de antes e depois da demonstração MigrateFromDBGrid, que compila com Delphi 7 e Delphi 13 (Win32 e Win64), e as diferenças conhecidas. Outros kits estão na página de migração do sgcUI.

VCL, FireMonkey e versões do Delphi

Um único modelo de grade alimenta a grade VCL e a grade FireMonkey, então um formulário VCL e um formulário FireMonkey compartilham o código de binding.

DestinoComponentePlataformas
Delphi 7 a 13, VCLTsgcVCLGridWin32 e Win64 a partir do XE2
Delphi XE6 a 13, FireMonkeyTsgcFMXGridWindows, macOS, iOS e Android
C++ Builder 2007 a 13TsgcVCLGrid, TsgcFMXGridCabeçalhos .hpp gerados e bibliotecas estáticas
.NET Framework 4.7.2, .NET 8, 9 e 10TsgcWinFormsGrid, grades WPF e AvaloniaWinForms, WPF, Avalonia

A importação das colunas do TDBGrid roda no designer de formulários VCL. Os formulários FireMonkey vinculam o dataset com o mesmo TsgcGridSource_DataSet.

Community e Registered

Em todas as edições

Binding de DataSet com colunas projetadas associadas por FieldName, campos de lookup, seleção de célula, linha e várias linhas, cabeçalho de linha, desenho personalizado, Ctrl+C, painel de agrupamento, resumos de rodapé e de grupo, linha de filtro, filtro de coluna estilo Excel, painel de busca, bandas, ajuste automático e salvamento e carregamento de layout em JSON. A edição Delphi Community gratuita inclui o sgcGrid.

Edição Registered

Edição bidirecional no dataset (WriteBack), sincronização do cursor (SyncCursor), inserção, exclusão, colagem e desfazer, exportação para Excel, a visualização em cartões e o modo servidor para tabelas muito grandes. O sgcGrid é vendido isoladamente com licenças Single, Team e Site e código-fonte completo, e está incluído no sgcUI Standard, Professional, Enterprise e All-Access.

Veja os preços do sgcGrid ou baixe a versão de avaliação, que inclui todos os recursos Registered para teste.

Perguntas frequentes

Solte um TsgcVCLGrid ao lado do TDBGrid, clique com o botão direito nele e escolha Import columns from DB grid. A importação copia as colunas, cria um TsgcGridSource_DataSet ligado ao mesmo dataset, copia os limites e os manipuladores de eventos e informa os eventos que devem ser portados manualmente. Depois, exclua o TDBGrid. O kit de migração mapeia cada propriedade e evento.

O TDBGrid é um controle VCL. O sgcGrid tem uma grade FireMonkey, TsgcFMXGrid, para Delphi XE6 a 13 no Windows, macOS, iOS e Android, e o mesmo TsgcGridSource_DataSet a vincula a qualquer TDataSet com o mesmo código da grade VCL.

Sim. Chame GroupBy com os nomes dos campos, ou deixe os usuários arrastarem um cabeçalho de coluna para o painel de agrupamento. Defina SummaryType em uma coluna (soma, contagem, média, mínimo ou máximo) e ative ShowFooter: os totais aparecem no rodapé e em cada linha de grupo. Agrupamento e resumos fazem parte de todas as edições, inclusive da Community.

Vincule o dataset ao sgcGrid e chame SaveToXLSX com um nome de arquivo ou um stream. A pasta de trabalho não exige biblioteca externa e mantém o que o usuário vê: as colunas visíveis na ordem de exibição com suas larguras e formatos numéricos, o cabeçalho congelado, os grupos como estrutura recolhível e os totais de grupo como fórmulas SUBTOTAL. A exportação para Excel faz parte da edição Registered; a edição Community exporta JSON e CSV.

Sim. Um TFDQuery ou TFDTable é um TDataSet, então o TsgcGridSource_DataSet o vincula como faz com um TClientDataSet. OnApplySort passa a ordenação da grade no formato IndexFieldNames do FireDAC, por exemplo Name;Date:D. Para uma tabela grande demais para carregar, o modo servidor (Registered) com TsgcGridServerProvider_DataSet lê uma página por vez e deixa o banco de dados ordenar, filtrar, contar e agrupar com SQL, executado pelo FireDAC ou por outro componente de consulta.

Sim, na edição Registered. Com WriteBack, a fonte grava cada edição no registro da sua linha, localizado por KeyField, e SyncCursor mantém o registro atual e a linha com foco juntos, de modo que um TDBNavigator e controles TDBEdit no mesmo dataset permaneçam sincronizados. Na edição Community, a grade exibe o dataset somente para leitura.

Melhor custo-benefício: All-AccessTodos os produtos da eSeGeCe, com Suporte Premium incluído, a partir de €1,059/ano.
Ver preços do All-Access

Leve seus formulários DBGrid para o sgcGrid

Baixe a versão de avaliação e vincule o sgcGrid aos datasets que o seu aplicativo Delphi já tem.