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.
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.
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.
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.DisableControls e o registro atual é restaurado. Fechar o dataset mantém as linhas.BooleanFields exibe um indicador armazenado como texto ou número, como S e N, como uma caixa de seleção.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:
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.
As linhas vêm do dataset; agrupamento, resumos, filtros e exportação rodam na grade.
GroupBy ou arrastando um cabeçalho para o painel de agrupamentoSummaryTypeOnApplySort passa a ordenação como nomes de campos, por exemplo para o IndexFieldNames de uma consulta FireDACSaveToXLSX 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)
As células alteradas piscam quando uma linha é atualizada.
Dois níveis de grupo, linhas de detalhe e células coloridas.
Filtre e depois ordene por várias colunas.
Vinculado a um TClientDataSet por meio de 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;
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.
| Recurso | TDBGrid | sgcGrid | Edição do sgcGrid |
|---|---|---|---|
| Vincular um TDataSet | Por meio de um TDataSource | TsgcGridSource_DataSet com DataSet, Grid e KeyField | Todas |
| Colunas projetadas | Columns de TColumn | Columns associadas por FieldName, ou AutoColumns | Todas |
| Linhas alteradas atualizadas no local, com flash | No | Sim, por KeyField | Todas |
| Ordenar com um clique no cabeçalho | Código em OnTitleClick | Integrado, com OnApplySort para o dataset | Todas |
| Agrupamento e painel de agrupamento | No | GroupBy, ShowGroupPanel | Todas |
| Resumos de rodapé e de grupo | No | SummaryType gsuSum, gsuCount, gsuAverage, gsuMin, gsuMax | Todas |
| Linha de filtro e filtros de coluna | No | ShowFilterRow, ShowFilterButtons | Todas |
| Painel de busca | No | ShowFindPanel, FindOnlyMatches | Todas |
| Bandas, ajuste automático e layouts salvos | No | Bands, BestFitColumns, SaveLayoutToFile, AutoSaveLayout | Todas |
| Cores por célula sem código de desenho | Código em OnDrawColumnCell | FormatRules, OnGetCellStyle e OnCustomDrawCell para pintura personalizada | Todas |
| Seleção de várias linhas | dgMultiSelect, SelectedRows | SelectionMode gsmMultiRow, GetSelectedKeys | Todas |
| Editar e gravar no dataset | Sim, com dgEditing | WriteBack grava cada edição no seu registro, SyncCursor mantém o registro atual sincronizado | Registered |
| Exportação para Excel | No | SaveToXLSX, para um arquivo ou um stream | Registered |
| Tabelas grandes demais para carregar | No | Modo servidor com TsgcGridServerProvider_DataSet, uma página por vez | Registered |
| FireMonkey | Não, somente VCL | TsgcFMXGrid no Windows, macOS, iOS e Android | Todas |
| .NET | No | Grades WinForms, WPF e Avalonia | Todas |
Veja a matriz completa de recursos do sgcGrid, os benchmarks e a comparação do sgcGrid.
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 acompanhaAllowInsert: Ins adiciona e grava um registro, e OnNewRecord do dataset preenche os valores padrãoApplyFilter 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 filtradasWriteBack, 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 EditingTrê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.
TsgcVCLGrid ao lado do TDBGrid.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.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.
| TDBGrid | sgcGrid |
|---|---|
| TDBGrid | TsgcVCLGrid (unit sgcGrid_VCL) |
| DataSource | TsgcGridSource_DataSet: DataSet, Grid, KeyField e depois Active := True (unit sgcGrid_Source_DataSet) |
| Columns, TColumn.FieldName | Columns, Columns[i].FieldName |
| ReadOnly, Options dgEditing | ReadOnly da grade e WriteBack da fonte (Registered) |
| dgRowSelect | SelectionMode := gsmRow |
| dgMultiSelect, SelectedRows | SelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys |
| dgIndicator | RowHeader := [grhIndicator], também grhNumbers e grhCheckBox |
| dgColLines, dgRowLines | GridLinesV, GridLinesH |
| OnDrawColumnCell | OnCustomDrawCell; só para cores, OnGetCellStyle ou FormatRules |
| OnTitleClick | OnHeaderClick; a grade ordena sozinha |
| OnColEnter, OnColExit | OnSelectionChange, 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.
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.
| Destino | Componente | Plataformas |
|---|---|---|
| Delphi 7 a 13, VCL | TsgcVCLGrid | Win32 e Win64 a partir do XE2 |
| Delphi XE6 a 13, FireMonkey | TsgcFMXGrid | Windows, macOS, iOS e Android |
| C++ Builder 2007 a 13 | TsgcVCLGrid, TsgcFMXGrid | Cabeçalhos .hpp gerados e bibliotecas estáticas |
| .NET Framework 4.7.2, .NET 8, 9 e 10 | TsgcWinFormsGrid, grades WPF e Avalonia | WinForms, 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.
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 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.
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.