sgcGrid, Delphi용 데이터 인식 DBGrid 대체
sgcGrid는 DBGrid가 이미 쓰는 TDataSet에 바인딩되는 데이터 인식 Delphi 그리드로, 같은 행을 그룹화하고 합산하고 필터링하고 내보내요.
sgcGrid는 DBGrid가 이미 쓰는 TDataSet에 바인딩되는 데이터 인식 Delphi 그리드로, 같은 행을 그룹화하고 합산하고 필터링하고 내보내요.
데이터베이스 코드는 그대로 동작해요. 바뀌는 것은 그리드와 그리드와 데이터셋 사이의 연결뿐이에요.
sgcGrid는 FireDAC TFDQuery, TClientDataSet 또는 다른 모든 데이터셋에 바인딩돼요. TDBGrid가 보여 주는 기능 위에 행 그룹화와 합계, 필터 행, 열 필터, 찾기 패널을 통한 필터링, Excel 내보내기, 바뀐 행의 제자리 업데이트를 VCL과 FireMonkey에서 제공해요.
TDBGrid는 TDataSource를 통해 데이터셋을 읽어요. sgcGrid에서는 TsgcGridSource_DataSet이 TDataSource를 대신해요. Grid와 DataSet을 설정하고 Active로 만들면 행이 나타나요. 데이터셋은 FireDAC 쿼리, TClientDataSet 또는 다른 모든 TDataSet 파생 클래스일 수 있어요.
KeyField가 있으면 그리드를 다시 불러오는 대신 동기화해요. 바뀐 행은 제자리에서 업데이트되며 깜박이고, 새 키는 추가되고, 없어진 키는 삭제돼요.LiveUpdates를 쓰면 그리드가 데이터셋의 모든 Post, Delete, Refresh를 따라가요.AutoColumns는 그리드에 열이 없을 때 필드로 열을 만들어요. 직접 만든 열은 유지되고 FieldName으로 대응돼요.DisableControls로 순회하고 현재 레코드는 복원돼요. 데이터셋을 닫아도 행은 그대로 남아요.BooleanFields는 S와 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;
소스는 컴포넌트라서 같은 바인딩을 폼 파일에 두고 오브젝트 인스펙터에서 설정할 수도 있어요.
object SourceDB: TsgcGridSource_DataSet
DataSet = cdsProducts
Grid = GridDB
KeyField = 'ID'
end
같은 소스가 같은 코드로 FireMonkey TsgcFMXGrid도 바인딩해요. 바인딩, 그룹화, 요약, 필터링은 무료 Delphi Community 에디션을 포함한 모든 에디션에 들어 있어요.
행은 데이터셋에서 오고, 그룹화, 요약, 필터, 내보내기는 그리드에서 실행돼요.
GroupBy를 쓰거나 머리글을 그룹 패널로 끌어다 놓아요SummaryType으로 바닥글과 모든 그룹 행에 합계, 개수, 평균, 최솟값, 최댓값 표시OnApplySort가 정렬 기준을 필드 이름으로 전달해요. 예를 들어 FireDAC 쿼리의 IndexFieldNames에 쓸 수 있어요SaveToXLSX는 외부 라이브러리 없이 Excel 통합 문서를 작성하고, 그룹은 접을 수 있는 개요로, 그룹 합계는 SUBTOTAL 수식으로 내보내요(Registered 에디션)
행이 업데이트되면 바뀐 셀이 깜박여요.
그룹 수준 두 개, 디테일 행, 색이 입혀진 셀.
필터링한 뒤 여러 열로 정렬해요.
TsgcGridSource_DataSet을 통해 TClientDataSet에 바인딩했어요.
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;
기본 VCL TDBGrid는 데이터셋을 보여 주고 편집해요. 이 표는 추가 코드 없이 각 그리드가 기본으로 하는 일을 정리한 거예요.
| 기능 | TDBGrid | sgcGrid | sgcGrid 에디션 |
|---|---|---|---|
| TDataSet 바인딩 | TDataSource를 통해 | DataSet, Grid, KeyField가 있는 TsgcGridSource_DataSet | 전체 |
| 직접 만든 열 | TColumn의 Columns | FieldName으로 대응되는 Columns, 또는 AutoColumns | 전체 |
| 바뀐 행을 제자리에서 업데이트하고 깜박임 표시 | No | 예, KeyField 기준 | 전체 |
| 머리글 클릭으로 정렬 | OnTitleClick의 코드 | 기본 제공, 데이터셋용 OnApplySort 포함 | 전체 |
| 그룹화와 그룹 패널 | No | GroupBy, ShowGroupPanel | 전체 |
| 바닥글과 그룹 요약 | No | SummaryType gsuSum, gsuCount, gsuAverage, gsuMin, gsuMax | 전체 |
| 필터 행과 열 필터 | No | ShowFilterRow, ShowFilterButtons | 전체 |
| 찾기 패널 | No | ShowFindPanel, FindOnlyMatches | 전체 |
| 밴드, 최적 맞춤, 저장된 레이아웃 | No | Bands, BestFitColumns, SaveLayoutToFile, AutoSaveLayout | 전체 |
| 그리기 코드 없이 셀별 색상 | OnDrawColumnCell의 코드 | FormatRules, OnGetCellStyle, 사용자 지정 그리기용 OnCustomDrawCell | 전체 |
| 다중 행 선택 | dgMultiSelect, SelectedRows | SelectionMode gsmMultiRow, GetSelectedKeys | 전체 |
| 데이터셋 편집과 게시 | 예, dgEditing 사용 | WriteBack은 모든 편집을 해당 레코드에 게시하고, SyncCursor는 현재 레코드를 맞춰 줘요 | Registered |
| Excel 내보내기 | No | 파일이나 스트림으로 SaveToXLSX | Registered |
| 불러오기에는 너무 큰 테이블 | No | TsgcGridServerProvider_DataSet을 쓰는 서버 모드, 한 번에 한 페이지씩 | Registered |
| FireMonkey | 아니요, VCL 전용 | Windows, macOS, iOS, Android의 TsgcFMXGrid | 전체 |
| .NET | No | WinForms, WPF, Avalonia 그리드 | 전체 |
전체 sgcGrid 기능 매트릭스, 벤치마크, sgcGrid 비교를 확인하세요.
WriteBack을 켜면 소스가 그리드에서 한 모든 편집을 해당 행의 레코드에 기록해요. KeyField로 레코드를 찾아 값을 게시해요. BeforePost 검사처럼 게시가 실패하면 레코드는 취소되고 셀은 이전 값을 유지해요.
SyncCursor가 현재 레코드와 포커스된 행을 함께 유지해요. 그래서 같은 데이터셋의 TDBNavigator와 TDBEdit 컨트롤이 그리드를 따라가고, 그리드도 그 컨트롤을 따라가요AllowInsert: Ins 키로 레코드를 추가하고 게시하며, 데이터셋의 OnNewRecord가 기본값을 채워요ApplyFilter를 쓰면 데이터셋이 그리드에 보이는 행만 유지해서, 그 데이터셋을 쓰는 DB 인식 컨트롤과 보고서도 필터링된 행을 봐요WriteBack, SyncCursor, 삽입, 삭제, 붙여넣기, 실행 취소는 Registered 에디션에 포함돼요. 체험판에는 평가용으로 들어 있어요.
DataSet 편집 도움말 주제 읽기세 단계예요. 디자인 타임에 열을 가져오고, 속성과 이벤트를 바꾸고, DB 그리드를 삭제하세요. 데이터는 같은 TDataSet에 그대로 있어요.
TsgcVCLGrid를 놓으세요.TsgcGridSource_DataSet 만들기, 범위 복사(Parent, Align, Anchors, TabOrder 등), 이벤트 핸들러 복사, 그리고 먼저 그리드의 열 지우기예요.가져오기는 FieldName, Title.Caption을 Caption으로, Width(폼의 PixelsPerInch로 DIP로 변환), Visible, Alignment, ReadOnly를 Editable로, 그리고 PickList를 복사해요. 코드에서는 sgcGrid_Import_VCL 유닛의 sgcGridImportDBGrid가 실행 시점에 같은 일을 해요.
| TDBGrid | sgcGrid |
|---|---|
| TDBGrid | TsgcVCLGrid(sgcGrid_VCL 유닛) |
| DataSource | TsgcGridSource_DataSet: DataSet, Grid, KeyField를 설정한 뒤 Active := True(sgcGrid_Source_DataSet 유닛) |
| Columns, TColumn.FieldName | Columns, Columns[i].FieldName |
| ReadOnly, Options dgEditing | 그리드의 ReadOnly와 소스의 WriteBack(Registered) |
| dgRowSelect | SelectionMode := gsmRow |
| dgMultiSelect, SelectedRows | SelectionMode := gsmMultiRow, SelectedRows, GetSelectedKeys |
| dgIndicator | RowHeader := [grhIndicator], grhNumbers와 grhCheckBox도 있어요 |
| dgColLines, dgRowLines | GridLinesV, GridLinesH |
| OnDrawColumnCell | OnCustomDrawCell, 색상만 바꿀 때는 OnGetCellStyle 또는 FormatRules |
| OnTitleClick | OnHeaderClick, 정렬은 그리드가 알아서 해요 |
| OnColEnter, OnColExit | SelectedCol이 있는 OnSelectionChange |
TDBGrid 마이그레이션 키트에는 전체 멤버 매핑, Delphi 7과 Delphi 13(Win32와 Win64)에서 컴파일되는 MigrateFromDBGrid 데모의 변경 전후 코드, 알려진 차이점이 들어 있어요. 다른 키트는 sgcUI 마이그레이션 페이지에 있어요.
하나의 그리드 모델이 VCL과 FireMonkey 그리드를 구동해서, VCL 폼과 FireMonkey 폼이 바인딩 코드를 공유해요.
| 대상 | 컴포넌트 | 플랫폼 |
|---|---|---|
| Delphi 7부터 13까지, VCL | TsgcVCLGrid | Win32, Win64는 XE2부터 |
| Delphi XE6부터 13까지, FireMonkey | TsgcFMXGrid | Windows, macOS, iOS, Android |
| C++ Builder 2007부터 13까지 | TsgcVCLGrid, TsgcFMXGrid | 생성된 .hpp 헤더와 정적 라이브러리 |
| .NET Framework 4.7.2, .NET 8, 9, 10 | TsgcWinFormsGrid, WPF와 Avalonia 그리드 | WinForms, WPF, Avalonia |
TDBGrid 열 가져오기는 VCL 폼 디자이너에서 실행돼요. FireMonkey 폼은 같은 TsgcGridSource_DataSet으로 데이터셋을 바인딩해요.
FieldName으로 대응되는 직접 만든 열이 있는 DataSet 바인딩, 조회 필드, 셀, 행, 다중 행 선택, 행 머리글, 사용자 지정 그리기, Ctrl+C, 그룹 패널, 바닥글과 그룹 요약, 필터 행, Excel 스타일 열 필터, 찾기 패널, 밴드, 최적 맞춤, JSON 레이아웃 저장과 불러오기. 무료 Delphi Community 에디션에도 sgcGrid가 들어 있어요.
데이터셋으로 양방향 편집(WriteBack), 커서 동기화(SyncCursor), 삽입, 삭제, 붙여넣기, 실행 취소, Excel 내보내기, 카드 뷰, 아주 큰 테이블을 위한 서버 모드가 들어 있어요. sgcGrid는 Single, Team, Site 라이선스와 전체 소스 코드로 단독 판매되며, sgcUI Standard, Professional, Enterprise, All-Access에도 포함돼요.
sgcGrid 가격 보기 또는 체험판 다운로드. 체험판에는 평가용으로 모든 Registered 기능이 들어 있어요.
TDBGrid 옆에 TsgcVCLGrid를 놓고 마우스 오른쪽 버튼으로 클릭한 뒤 Import columns from DB grid를 선택하세요. 가져오기는 열을 복사하고, 같은 데이터셋에 연결된 TsgcGridSource_DataSet을 만들고, 범위와 이벤트 핸들러를 복사하며, 직접 옮겨야 하는 이벤트를 알려 줘요. 그다음 TDBGrid를 삭제하면 돼요. 마이그레이션 키트가 모든 속성과 이벤트를 매핑해 줘요.
TDBGrid는 VCL 컨트롤이에요. sgcGrid에는 Windows, macOS, iOS, Android의 Delphi XE6부터 13까지 쓸 수 있는 FireMonkey 그리드 TsgcFMXGrid가 있고, 같은 TsgcGridSource_DataSet이 VCL 그리드와 같은 코드로 모든 TDataSet에 바인딩해 줘요.
네. 필드 이름과 함께 GroupBy를 호출하거나 사용자가 열 머리글을 그룹 패널로 끌어다 놓게 하세요. 열에 SummaryType(합계, 개수, 평균, 최솟값, 최댓값)을 설정하고 ShowFooter를 켜면 합계가 바닥글과 모든 그룹 행에 나타나요. 그룹화와 요약은 Community를 포함한 모든 에디션에 들어 있어요.
데이터셋을 sgcGrid에 바인딩하고 파일 이름이나 스트림으로 SaveToXLSX를 호출하세요. 통합 문서는 외부 라이브러리가 필요 없고 사용자가 보는 내용을 그대로 유지해요. 표시 순서대로 보이는 열과 그 너비, 숫자 서식, 고정 머리글, 접을 수 있는 개요로 표현한 그룹, SUBTOTAL 수식으로 표현한 그룹 합계가 포함돼요. Excel 내보내기는 Registered 에디션에 포함되고, Community 에디션은 JSON과 CSV를 내보내요.
네. TFDQuery나 TFDTable은 TDataSet이라서 TsgcGridSource_DataSet이 TClientDataSet처럼 바인딩해요. OnApplySort는 그리드의 정렬을 FireDAC IndexFieldNames 형식으로 전달해요. 예를 들어 Name;Date:D 같은 형태예요. 불러오기에는 너무 큰 테이블이라면 TsgcGridServerProvider_DataSet을 쓰는 서버 모드(Registered)가 한 번에 한 페이지씩 읽고, 정렬, 필터, 개수 세기, 그룹화는 FireDAC이나 다른 쿼리 컴포넌트가 실행하는 SQL로 데이터베이스가 처리해요.
네, Registered 에디션에서 가능해요. WriteBack을 쓰면 소스가 모든 편집을 KeyField로 찾은 해당 행의 레코드에 게시하고, SyncCursor가 현재 레코드와 포커스된 행을 함께 유지해서 같은 데이터셋의 TDBNavigator와 TDBEdit 컨트롤이 보조를 맞춰요. Community 에디션에서는 그리드가 데이터셋을 읽기 전용으로 보여 줘요.