Delphi & C++ Builder VCL i FireMonkey

sgcGrid, zamiennik DBGrid dla Delphi powiązany z danymi

sgcGrid to siatka Delphi powiązana z danymi, która łączy się z TDataSet, którego używa już Twój DBGrid, a następnie grupuje, sumuje, filtruje i eksportuje te same wiersze.

Grupowanie z sumami
Wiersz filtra i panel wyszukiwania
Zmienione wiersze aktualizują się w miejscu
Eksport do Excela
Dowolny TDataSetDelphi 7 do 13FireMonkey od XE6Bezpłatna edycja Delphi Community

Przejdź z TDBGrid → · Zobacz cennik →

Siatka danych Delphi grupująca klientów według regionu z podsumowaniami w każdym wierszu grupy i sumami w stopce, obok karty kontaktu i mapy lokalizacji, sgcGrid w demie Altamira ERP

Powiąż sgcGrid z TDataSet, TFDQuery lub TClientDataSet

Twój kod bazodanowy nadal działa. Zmienia się tylko siatka i połączenie między siatką a zbiorem danych.

sgcGrid łączy się z FireDAC TFDQuery, TClientDataSet lub dowolnym innym zbiorem danych. Poza tym, co pokazuje TDBGrid, grupuje i sumuje wiersze, filtruje za pomocą wiersza filtrów, filtrów kolumn i panelu wyszukiwania, eksportuje do Excela i aktualizuje zmienione wiersze w miejscu, w VCL i FireMonkey.

TDBGrid czyta swój zbiór danych przez TDataSource. W sgcGrid miejsce TDataSource zajmuje TsgcGridSource_DataSet: ustaw jego Grid i DataSet, zrób go Active, a wiersze się pojawią. Zbiorem danych może być zapytanie FireDAC, TClientDataSet lub dowolny inny potomek TDataSet.

  • Z KeyField siatka jest synchronizowana, a nie ładowana od nowa: zmienione wiersze są aktualizowane w miejscu i błyskają, nowe klucze są dołączane, a brakujące klucze usuwane.
  • LiveUpdates sprawia, że siatka podąża za każdym Post, Delete i Refresh zbioru danych.
  • AutoColumns tworzy kolumny z pól, gdy siatka ich nie ma. Zaprojektowane kolumny są zachowywane i dopasowywane przez FieldName.
  • Zbiór danych jest przeglądany z DisableControls, a jego bieżący rekord zostaje przywrócony. Zamknięcie zbioru danych zachowuje wiersze.
  • Pola lookup wypełniają listę rozwijaną swojej kolumny, a BooleanFields pokazuje flagę zapisaną jako tekst lub liczba, na przykład S i N, jako pole wyboru.
Delphi, zapytanie FireDAC w 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;

Źródło jest komponentem, więc to samo powiązanie może znaleźć się w pliku formularza i być ustawione w Inspektorze obiektów:

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

To samo źródło wiąże siatkę FireMonkey TsgcFMXGrid tym samym kodem. Powiązanie, grupowanie, podsumowania i filtrowanie są częścią każdej edycji, także bezpłatnej edycji Delphi Community.

Przeczytaj temat pomocy o powiązaniu DataSet

Grupuj, sumuj, filtruj i eksportuj te same wiersze

Wiersze pochodzą ze zbioru danych; grupowanie, podsumowania, filtry i eksport działają w siatce.

sgcGrid ze 100 000 zamówień zgrupowanych według Region, potem Category, z chipami panelu grupowania i sumami w stopce

Co zyskuje użytkownik DBGrid

  • Grupowanie według jednej lub kilku kolumn, z kodu przez GroupBy lub przez przeciągnięcie nagłówka do panelu grupowania
  • Suma, liczba, średnia, minimum i maksimum w stopce i w każdym wierszu grupy, z SummaryType
  • Wiersz filtrów, filtr w stylu Excela w każdej kolumnie i panel wyszukiwania, który podświetla trafienia
  • Kliknięcie nagłówka sortuje samo, a OnApplySort przekazuje sortowanie jako nazwy pól, na przykład dla IndexFieldNames zapytania FireDAC
  • SaveToXLSX zapisuje skoroszyt Excela bez zewnętrznej biblioteki, grupy jako zwijany konspekt, a sumy grup jako formuły SUBTOTAL (edycja Registered)
  • Pasma, dopasowanie do zawartości, wybór kolumn oraz układ kolumn zapisywany i wczytywany jako JSON
Delphi, grupowanie, sumy, filtry i 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;

Porównanie TDBGrid i sgcGrid

Standardowy TDBGrid z VCL pokazuje i edytuje zbiór danych. Ta tabela wylicza, co każda siatka robi od razu, bez dodatkowego kodu.

FunkcjaTDBGridsgcGridEdycja sgcGrid
Powiązanie TDataSetPrzez TDataSourceTsgcGridSource_DataSet z DataSet, Grid i KeyFieldWszystkie
Zaprojektowane kolumnyColumns typu TColumnColumns dopasowane przez FieldName lub AutoColumnsWszystkie
Zmienione wiersze aktualizowane w miejscu, z podświetleniemNoTak, przez KeyFieldWszystkie
Sortowanie kliknięciem nagłówkaKod w OnTitleClickWbudowane, z OnApplySort dla zbioru danychWszystkie
Grupowanie i panel grupowaniaNoGroupBy, ShowGroupPanelWszystkie
Podsumowania w stopce i grupachNoSummaryType gsuSum, gsuCount, gsuAverage, gsuMin, gsuMaxWszystkie
Wiersz filtrów i filtry kolumnNoShowFilterRow, ShowFilterButtonsWszystkie
Panel wyszukiwaniaNoShowFindPanel, FindOnlyMatchesWszystkie
Pasma, dopasowanie do zawartości i zapisane układyNoBands, BestFitColumns, SaveLayoutToFile, AutoSaveLayoutWszystkie
Kolory komórek bez kodu rysującegoKod w OnDrawColumnCellFormatRules, OnGetCellStyle i OnCustomDrawCell do własnego rysowaniaWszystkie
Zaznaczanie wielu wierszydgMultiSelect, SelectedRowsSelectionMode gsmMultiRow, GetSelectedKeysWszystkie
Edycja i zapis do zbioru danychTak, z dgEditingWriteBack zapisuje każdą edycję w jej rekordzie, SyncCursor utrzymuje bieżący rekord w zgodzieRegistered
Eksport do ExcelaNoSaveToXLSX, do pliku lub strumieniaRegistered
Tabele zbyt duże do załadowaniaNoTryb serwerowy z TsgcGridServerProvider_DataSet, po jednej stronie narazRegistered
FireMonkeyNie, tylko VCLTsgcFMXGrid w systemach Windows, macOS, iOS i AndroidWszystkie
.NETNoSiatki WinForms, WPF i AvaloniaWszystkie

Zobacz pełną macierz funkcji sgcGrid, testy wydajności i porównanie sgcGrid.

Demo DataSetEditing: TDBNavigator i dwa TDBEdit na tych samych rekordach co siatka, z kolumną lookup kategorii

Edytuj zbiór danych przez siatkę

Gdy WriteBack jest włączony, źródło zapisuje każdą edycję siatki w rekordzie jej wiersza. Znajduje rekord przez KeyField i zapisuje wartość. Gdy zapis się nie powiedzie, na przykład w kontroli BeforePost, rekord zostaje anulowany, a komórka zachowuje starą wartość.

  • SyncCursor utrzymuje bieżący rekord i zaznaczony wiersz razem, więc TDBNavigator i kontrolki TDBEdit na tym samym zbiorze danych podążają za siatką, a siatka za nimi
  • AllowInsert: Ins dołącza i zapisuje rekord, a OnNewRecord zbioru danych wypełnia wartości domyślne
  • ApplyFilter sprawia, że zbiór danych zachowuje tylko wiersze, które pokazuje siatka, więc kontrolki DB-aware i raporty na nim widzą przefiltrowane wiersze

WriteBack, SyncCursor, wstawianie, usuwanie, wklejanie i cofanie są częścią edycji Registered. Wersja próbna zawiera je do oceny.

Przeczytaj temat pomocy o edycji DataSet

Jak zastąpić TDBGrid w Delphi

Trzy kroki: zaimportuj kolumny w czasie projektowania, zastąp właściwości i zdarzenia, usuń siatkę DB. Dane zostają w tym samym TDataSet.

  1. Zapisz formularz, a potem upuść TsgcVCLGrid obok TDBGrid.
  2. Kliknij siatkę prawym przyciskiem myszy, wybierz Import columns from DB grid... i wskaż TDBGrid na liście.
  3. Zostaw zaznaczone cztery opcje: utwórz TsgcGridSource_DataSet połączony ze zbiorem danych z DataSource, skopiuj granice (Parent, Align, Anchors, TabOrder i inne), skopiuj procedury obsługi zdarzeń i najpierw wyczyść kolumny siatki.
  4. Przeczytaj raport. Wylicza każdą zaimportowaną kolumnę i każde zdarzenie, które trzeba przenieść ręcznie.
  5. Sprawdź wynik, a potem usuń TDBGrid oraz jego TDataSource, jeśli nic innego go nie używa.

Import kopiuje FieldName, Title.Caption do Caption, Width (przeliczone na DIP przy użyciu PixelsPerInch formularza), Visible, Alignment, ReadOnly do Editable oraz PickList. Z kodu to samo robi w czasie działania sgcGridImportDBGrid w jednostce sgcGrid_Import_VCL.

TDBGridsgcGrid
TDBGridTsgcVCLGrid (jednostka sgcGrid_VCL)
DataSourceTsgcGridSource_DataSet: DataSet, Grid, KeyField, potem Active := True (jednostka sgcGrid_Source_DataSet)
Columns, TColumn.FieldNameColumns, Columns[i].FieldName
ReadOnly, Options dgEditingReadOnly siatki i WriteBack źródła (Registered)
dgRowSelectSelectionMode := gsmRow
dgMultiSelect, SelectedRowsSelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys
dgIndicatorRowHeader := [grhIndicator], także grhNumbers i grhCheckBox
dgColLines, dgRowLinesGridLinesV, GridLinesH
OnDrawColumnCellOnCustomDrawCell; tylko dla kolorów OnGetCellStyle lub FormatRules
OnTitleClickOnHeaderClick; siatka sortuje sama
OnColEnter, OnColExitOnSelectionChange, z SelectedCol

Zestaw migracyjny TDBGrid zawiera pełną mapę składowych, kod przed i po z dema MigrateFromDBGrid, które kompiluje się w Delphi 7 i Delphi 13 (Win32 i Win64), oraz znane różnice. Inne zestawy są na stronie migracji sgcUI.

VCL, FireMonkey i wersje Delphi

Jeden model siatki napędza siatkę VCL i FireMonkey, więc formularz VCL i formularz FireMonkey współdzielą kod powiązania.

CelKomponentPlatformy
Delphi 7 do 13, VCLTsgcVCLGridWin32, a Win64 od XE2
Delphi XE6 do 13, FireMonkeyTsgcFMXGridWindows, macOS, iOS i Android
C++ Builder 2007 do 13TsgcVCLGrid, TsgcFMXGridWygenerowane nagłówki .hpp i biblioteki statyczne
.NET Framework 4.7.2, .NET 8, 9 i 10TsgcWinFormsGrid, siatki WPF i AvaloniaWinForms, WPF, Avalonia

Import kolumn TDBGrid działa w projektancie formularzy VCL. Formularze FireMonkey wiążą zbiór danych tym samym TsgcGridSource_DataSet.

Community i Registered

W każdej edycji

Powiązanie DataSet z zaprojektowanymi kolumnami dopasowanymi przez FieldName, pola lookup, zaznaczanie komórek, wierszy i wielu wierszy, nagłówek wiersza, własne rysowanie, Ctrl+C, panel grupowania, podsumowania w stopce i grupach, wiersz filtrów, filtr kolumn w stylu Excela, panel wyszukiwania, pasma, dopasowanie do zawartości oraz zapis i odczyt układu JSON. Bezpłatna edycja Delphi Community zawiera sgcGrid.

Edycja Registered

Edycja dwukierunkowa w zbiorze danych (WriteBack), synchronizacja kursora (SyncCursor), wstawianie, usuwanie, wklejanie i cofanie, eksport do Excela, widok kart i tryb serwerowy dla bardzo dużych tabel. sgcGrid jest sprzedawany osobno z licencjami Single, Team i Site oraz pełnym kodem źródłowym i jest zawarty w sgcUI Standard, Professional, Enterprise i All-Access.

Zobacz cennik sgcGrid lub pobierz wersję próbną, która zawiera wszystkie funkcje Registered do oceny.

Najczęściej zadawane pytania

Upuść TsgcVCLGrid obok TDBGrid, kliknij go prawym przyciskiem myszy i wybierz Import columns from DB grid. Import kopiuje kolumny, tworzy TsgcGridSource_DataSet połączony z tym samym zbiorem danych, kopiuje granice i procedury obsługi zdarzeń oraz zgłasza zdarzenia do przeniesienia ręcznie. Potem usuń TDBGrid. Zestaw migracyjny mapuje każdą właściwość i zdarzenie.

TDBGrid to kontrolka VCL. sgcGrid ma siatkę FireMonkey, TsgcFMXGrid, dla Delphi XE6 do 13 w systemach Windows, macOS, iOS i Android, a ten sam TsgcGridSource_DataSet wiąże ją z dowolnym TDataSet tym samym kodem co siatkę VCL.

Tak. Wywołaj GroupBy z nazwami pól albo pozwól użytkownikom przeciągnąć nagłówek kolumny do panelu grupowania. Ustaw SummaryType w kolumnie (suma, liczba, średnia, minimum lub maksimum) i włącz ShowFooter: sumy pojawią się w stopce i w każdym wierszu grupy. Grupowanie i podsumowania są częścią każdej edycji, Community również.

Powiąż zbiór danych z sgcGrid i wywołaj SaveToXLSX z nazwą pliku lub strumieniem. Skoroszyt nie wymaga zewnętrznej biblioteki i zachowuje to, co widzi użytkownik: widoczne kolumny w kolejności wyświetlania z ich szerokościami i formatami liczb, zablokowany nagłówek, grupy jako zwijany konspekt i sumy grup jako formuły SUBTOTAL. Eksport do Excela jest częścią edycji Registered; edycja Community eksportuje JSON i CSV.

Tak. TFDQuery lub TFDTable to TDataSet, więc TsgcGridSource_DataSet wiąże je tak samo jak TClientDataSet. OnApplySort przekazuje sortowanie siatki w formie IndexFieldNames FireDAC, na przykład Name;Date:D. Dla tabeli zbyt dużej do załadowania tryb serwerowy (Registered) z TsgcGridServerProvider_DataSet czyta po jednej stronie naraz i pozwala bazie danych sortować, filtrować, liczyć i grupować za pomocą SQL, uruchamianego przez FireDAC lub inny komponent zapytań.

Tak, w edycji Registered. Z WriteBack źródło zapisuje każdą edycję w rekordzie jej wiersza, znalezionym przez KeyField, a SyncCursor utrzymuje bieżący rekord i zaznaczony wiersz razem, więc TDBNavigator i kontrolki TDBEdit na tym samym zbiorze danych pozostają zsynchronizowane. W edycji Community siatka pokazuje zbiór danych tylko do odczytu.

Najkorzystniejsza oferta: All-AccessWszystkie produkty eSeGeCe, ze wsparciem Premium w cenie, już od €1,059 rocznie.
Zobacz cennik All-Access

Przenieś swoje formularze DBGrid do sgcGrid

Pobierz wersję próbną i powiąż sgcGrid ze zbiorami danych, które Twoja aplikacja Delphi już ma.