sgcGrid, Delphi için Veri Duyarlı Bir DBGrid Alternatifi
sgcGrid, DBGrid'inizin zaten kullandığı TDataSet'e bağlanan, ardından aynı satırları gruplayan, toplayan, filtreleyen ve dışa aktaran veri duyarlı bir Delphi grididir.
sgcGrid, DBGrid'inizin zaten kullandığı TDataSet'e bağlanan, ardından aynı satırları gruplayan, toplayan, filtreleyen ve dışa aktaran veri duyarlı bir Delphi grididir.
Veritabanı kodunuz çalışmaya devam eder. Yalnızca grid ile grid ve veri kümesi arasındaki bağlantı değişir.
sgcGrid, bir FireDAC TFDQuery, bir TClientDataSet ya da herhangi bir veri kümesine bağlanır. TDBGrid'in gösterdiklerine ek olarak satırları gruplar ve toplar, filtre satırı, sütun filtreleri ve arama paneliyle filtreler, Excel'e aktarır ve değişen satırları yerinde günceller, hem VCL'de hem de FireMonkey'de.
Bir TDBGrid, veri kümesini bir TDataSource aracılığıyla okur. sgcGrid'de TDataSource'un yerini bir TsgcGridSource_DataSet alır: Grid ve DataSet değerlerini ayarlayın, Active yapın, satırlar görünür. Veri kümesi bir FireDAC sorgusu, bir TClientDataSet ya da başka herhangi bir TDataSet türevi olabilir.
KeyField ile grid yeniden yüklenmek yerine eşitlenir: değişen satırlar yerinde güncellenir ve yanıp söner, yeni anahtarlar eklenir, eksik anahtarlar silinir.LiveUpdates, gridin veri kümesinin her Post, Delete ve Refresh işlemini izlemesini sağlar.AutoColumns, gridde sütun yoksa sütunları alanlardan oluşturur. Tasarlanmış sütunlar korunur ve FieldName ile eşleştirilir.DisableControls ile dolaşılır ve geçerli kaydı geri yüklenir. Veri kümesini kapatmak satırları korur.BooleanFields ise metin ya da sayı olarak saklanan bir bayrağı, örneğin S ve N değerlerini, bir onay kutusu olarak gösterir.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;
Kaynak bir bileşendir, dolayısıyla aynı bağlama form dosyasında bulunabilir ve Object Inspector'da ayarlanabilir:
object SourceDB: TsgcGridSource_DataSet
DataSet = cdsProducts
Grid = GridDB
KeyField = 'ID'
end
Aynı kaynak, bir FireMonkey TsgcFMXGrid bileşenini aynı kodla bağlar. Bağlama, gruplama, özetler ve filtreleme, ücretsiz Delphi Community sürümü dahil her sürümün parçasıdır.
Satırlar veri kümesinden gelir; gruplama, özetler, filtreler ve dışa aktarma gridde çalışır.
GroupBy ile ya da bir başlığı gruplama paneline sürükleyerekSummaryType ile altbilgide ve her grup satırında toplam, adet, ortalama, en küçük ve en büyük değerOnApplySort ise sıralamayı alan adları olarak iletir, örneğin bir FireDAC sorgusunun IndexFieldNames değeri içinSaveToXLSX harici kitaplık olmadan bir Excel çalışma kitabı yazar; gruplar daraltılabilir anahtar hat olarak, grup toplamları SUBTOTAL formülleri olarak yazılır (Registered sürümü)
Bir satır güncellendiğinde değişen hücreler yanıp söner.
İki grup düzeyi, ayrıntı satırları ve renklendirilmiş hücreler.
Filtreleyin, ardından birkaç sütuna göre sıralayın.
TsgcGridSource_DataSet aracılığıyla bir TClientDataSet'e bağlı.
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;
Standart VCL TDBGrid bir veri kümesini gösterir ve düzenler. Bu tablo, her gridin ek kod olmadan kutudan çıktığı gibi neler yaptığını listeler.
| Özellik | TDBGrid | sgcGrid | sgcGrid sürümü |
|---|---|---|---|
| Bir TDataSet bağlama | Bir TDataSource aracılığıyla | DataSet, Grid ve KeyField ile TsgcGridSource_DataSet | Tümü |
| Tasarlanmış sütunlar | TColumn türünde Columns | FieldName ile eşleştirilen Columns ya da AutoColumns | Tümü |
| Değişen satırlar yerinde güncellenir, yanıp sönme ile | No | Evet, KeyField ile | Tümü |
| Başlığa tıklayarak sıralama | OnTitleClick içinde kod | Yerleşik, veri kümesi için OnApplySort ile | Tümü |
| Gruplama ve gruplama paneli | No | GroupBy, ShowGroupPanel | Tümü |
| Altbilgi ve grup özetleri | No | SummaryType gsuSum, gsuCount, gsuAverage, gsuMin, gsuMax | Tümü |
| Filtre satırı ve sütun filtreleri | No | ShowFilterRow, ShowFilterButtons | Tümü |
| Arama paneli | No | ShowFindPanel, FindOnlyMatches | Tümü |
| Bantlar, en iyi sığdırma ve kaydedilmiş düzenler | No | Bands, BestFitColumns, SaveLayoutToFile, AutoSaveLayout | Tümü |
| Çizim kodu olmadan hücre başına renkler | OnDrawColumnCell içinde kod | FormatRules, OnGetCellStyle ve özel boyama için OnCustomDrawCell | Tümü |
| Çok satırlı seçim | dgMultiSelect, SelectedRows | SelectionMode gsmMultiRow, GetSelectedKeys | Tümü |
| Veri kümesinde düzenleme ve kaydetme | Evet, dgEditing ile | WriteBack her düzenlemeyi kendi kaydına gönderir, SyncCursor geçerli kaydı uyumlu tutar | Registered |
| Excel dışa aktarma | No | SaveToXLSX, bir dosyaya ya da bir akışa | Registered |
| Yüklenemeyecek kadar büyük tablolar | No | TsgcGridServerProvider_DataSet ile sunucu modu, her seferinde bir sayfa | Registered |
| FireMonkey | Hayır, yalnızca VCL | Windows, macOS, iOS ve Android'de TsgcFMXGrid | Tümü |
| .NET | No | WinForms, WPF ve Avalonia gridleri | Tümü |
Tam sgcGrid özellik matrisine, kıyaslamalara ve sgcGrid karşılaştırmasına bakın.
WriteBack açıkken kaynak, her grid düzenlemesini satırının kaydına yazar. Kaydı KeyField ile bulur ve değeri gönderir. Gönderme başarısız olursa, örneğin bir BeforePost denetiminde, kayıt iptal edilir ve hücre eski değerini korur.
SyncCursor geçerli kaydı ve odaklanılan satırı birlikte tutar, böylece aynı veri kümesindeki bir TDBNavigator ve TDBEdit denetimleri gridi izler, grid de onları izlerAllowInsert: Ins bir kayıt ekler ve gönderir, veri kümesinin OnNewRecord olayı varsayılanları doldururApplyFilter, veri kümesinin yalnızca gridin gösterdiği satırları tutmasını sağlar, böylece üzerindeki veritabanı duyarlı denetimler ve raporlar filtrelenmiş satırları görürWriteBack, SyncCursor, ekleme, silme, yapıştırma ve geri alma Registered sürümünün parçasıdır. Deneme sürümü bunları değerlendirme için içerir.
DataSet Editing yardım konusunu okuyunÜç adım: sütunları tasarım zamanında içe aktarın, özellikleri ve olayları değiştirin, DB gridi silin. Veriler aynı TDataSet içinde kalır.
TsgcVCLGrid bırakın.TsgcGridSource_DataSet oluşturma, sınırları kopyalama (Parent, Align, Anchors, TabOrder ve daha fazlası), olay işleyicilerini kopyalama ve önce gridin sütunlarını temizleme.İçe aktarma şunları kopyalar: FieldName, Title.Caption değerini Caption alanına, Width (formun PixelsPerInch değeriyle DIP'e dönüştürülür), Visible, Alignment, ReadOnly değerini Editable alanına ve PickList. Kodda, sgcGrid_Import_VCL biriminin sgcGridImportDBGrid yordamı aynı işi çalışma zamanında yapar.
| TDBGrid | sgcGrid |
|---|---|
| TDBGrid | TsgcVCLGrid (sgcGrid_VCL birimi) |
| DataSource | TsgcGridSource_DataSet: DataSet, Grid, KeyField, ardından Active := True (sgcGrid_Source_DataSet birimi) |
| Columns, TColumn.FieldName | Columns, Columns[i].FieldName |
| ReadOnly, Options dgEditing | Gridin ReadOnly ve kaynağın WriteBack özellikleri (Registered) |
| dgRowSelect | SelectionMode := gsmRow |
| dgMultiSelect, SelectedRows | SelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys |
| dgIndicator | RowHeader := [grhIndicator], ayrıca grhNumbers ve grhCheckBox |
| dgColLines, dgRowLines | GridLinesV, GridLinesH |
| OnDrawColumnCell | OnCustomDrawCell; yalnızca renkler için OnGetCellStyle ya da FormatRules |
| OnTitleClick | OnHeaderClick; grid kendi başına sıralar |
| OnColEnter, OnColExit | SelectedCol ile birlikte OnSelectionChange |
TDBGrid geçiş kiti, tam üye eşlemesini, Delphi 7 ve Delphi 13 (Win32 ve Win64) ile derlenen MigrateFromDBGrid demosundan önce ve sonra kodunu ve bilinen farklılıkları içerir. Diğer kitler sgcUI geçiş sayfasındadır.
Tek bir grid modeli hem VCL hem de FireMonkey gridini yönetir, böylece bir VCL formu ile bir FireMonkey formu bağlama kodunu paylaşır.
| Hedef | Bileşen | Platformlar |
|---|---|---|
| Delphi 7'den 13'e, VCL | TsgcVCLGrid | Win32 ve XE2'den itibaren Win64 |
| Delphi XE6'dan 13'e, FireMonkey | TsgcFMXGrid | Windows, macOS, iOS ve Android |
| C++ Builder 2007'den 13'e | TsgcVCLGrid, TsgcFMXGrid | Oluşturulmuş .hpp başlıkları ve statik kitaplıklar |
| .NET Framework 4.7.2, .NET 8, 9 ve 10 | TsgcWinFormsGrid, WPF ve Avalonia gridleri | WinForms, WPF, Avalonia |
TDBGrid sütunlarının içe aktarılması VCL form tasarımcısında çalışır. FireMonkey formları veri kümesini aynı TsgcGridSource_DataSet ile bağlar.
FieldName ile eşleştirilen tasarlanmış sütunlarla DataSet bağlama, lookup alanları, hücre, satır ve çok satırlı seçim, satır başlığı, özel çizim, Ctrl+C, gruplama paneli, altbilgi ve grup özetleri, filtre satırı, Excel tarzı sütun filtresi, arama paneli, bantlar, en iyi sığdırma ve JSON düzen kaydetme ve yükleme. Ücretsiz Delphi Community sürümü sgcGrid ile birlikte gelir.
Veri kümesine çift yönlü düzenleme (WriteBack), imleç eşitleme (SyncCursor), ekleme, silme, yapıştırma ve geri alma, Excel dışa aktarma, kart görünümü ve çok büyük tablolar için sunucu modu. sgcGrid tek başına Single, Team ve Site lisanslarıyla ve tam kaynak koduyla satılır, ayrıca sgcUI Standard, Professional, Enterprise ve All-Access içinde yer alır.
sgcGrid fiyatlandırmasına bakın ya da değerlendirme için her Registered özelliğini içeren deneme sürümünü indirin.
TDBGrid'in yanına bir TsgcVCLGrid bırakın, sağ tıklayın ve Import columns from DB grid seçeneğini seçin. İçe aktarma sütunları kopyalar, aynı veri kümesine bağlı bir TsgcGridSource_DataSet oluşturur, sınırları ve olay işleyicilerini kopyalar ve elle taşınacak olayları bildirir. Ardından TDBGrid'i silin. Geçiş kiti her özelliği ve olayı eşler.
TDBGrid bir VCL denetimidir. sgcGrid'in Windows, macOS, iOS ve Android'de Delphi XE6'dan 13'e kadar çalışan bir FireMonkey gridi vardır, TsgcFMXGrid, ve aynı TsgcGridSource_DataSet onu VCL gridiyle aynı kodla herhangi bir TDataSet'e bağlar.
Evet. GroupBy yordamını alan adlarıyla çağırın ya da kullanıcıların bir sütun başlığını gruplama paneline sürüklemesine izin verin. Bir sütunda SummaryType ayarlayın (toplam, adet, ortalama, en küçük ya da en büyük) ve ShowFooter özelliğini açın: toplamlar altbilgide ve her grup satırında görünür. Gruplama ve özetler, Community dahil her sürümün parçasıdır.
Veri kümesini sgcGrid'e bağlayın ve SaveToXLSX yordamını bir dosya adı ya da bir akışla çağırın. Çalışma kitabı harici bir kitaplık gerektirmez ve kullanıcının gördüğünü korur: görünür sütunlar görüntüleme sırasıyla, genişlikleri ve sayı biçimleriyle, sabitlenmiş başlık, daraltılabilir anahtar hat olarak gruplar ve SUBTOTAL formülleri olarak grup toplamları. Excel dışa aktarma Registered sürümünün parçasıdır; Community sürümü JSON ve CSV dışa aktarır.
Evet. Bir TFDQuery ya da TFDTable bir TDataSet'tir, bu nedenle TsgcGridSource_DataSet onu bir TClientDataSet gibi bağlar. OnApplySort, gridin sıralamasını FireDAC IndexFieldNames biçiminde iletir, örneğin Name;Date:D. Yüklenemeyecek kadar büyük bir tablo için, TsgcGridServerProvider_DataSet ile sunucu modu (Registered) her seferinde bir sayfa okur ve sıralamayı, filtrelemeyi, saymayı ve gruplamayı FireDAC ya da başka bir sorgu bileşeni tarafından çalıştırılan SQL ile veritabanına yaptırır.
Evet, Registered sürümünde. WriteBack ile kaynak her düzenlemeyi KeyField ile bulunan satırının kaydına gönderir, SyncCursor ise geçerli kaydı ve odaklanılan satırı birlikte tutar, böylece aynı veri kümesindeki bir TDBNavigator ve TDBEdit denetimleri uyumlu kalır. Community sürümünde grid veri kümesini salt okunur gösterir.