sgcGrid 기능 표
sgcGrid의 모든 기능을 작업별로 정리했으며, 각 기능의 도움말 항목으로 연결됩니다. 동일한 모델이 VCL, FireMonkey, WinForms, WPF, Avalonia 그리드를 구동합니다.
sgcGrid의 모든 기능을 작업별로 정리했으며, 각 기능의 도움말 항목으로 연결됩니다. 동일한 모델이 VCL, FireMonkey, WinForms, WPF, Avalonia 그리드를 구동합니다.
3개 기능
15개 기능
4개 기능
12개 기능
5개 기능
2개 기능
NuGet 패키지 8개
온라인 도움말 및 PDF 매뉴얼
Registered 에디션은 Registered 에디션과 체험판 에디션에 포함되지만 무료 Community 에디션에는 없는 기능을 나타냅니다. ~는 Community에 일부만 포함된 기능이며, 차이점은 아래에 설명되어 있습니다.
모든 행은 해당 도움말 항목으로 연결됩니다. Community 열은 무료 .NET Community 에디션에 포함된 기능을 보여 주며, 모든 기능은 Registered 에디션과 체험판에 포함됩니다.
열 필터, 필터 행, 찾기 패널, 열 선택기, 열 이동, 최적 너비, 레이아웃, 다중 선택, 밴드, 셀 형식, DataSet 편집, 붙여넣기, 실행 취소, sgcEditors 셀 편집기는 Delphi와 C++ Builder용 VCL 및 FireMonkey 그리드에 있고, .NET용 WinForms, WPF, Avalonia 그리드에도 있으며, Community와 Registered의 구성은 같습니다. 구성은 에디션에 설명되어 있습니다. .NET에서 DataSet 편집은 DataTable에 다시 기록되고, AddLookup이 조회 열을 추가하며, SyncCursor는 Delphi 전용입니다.
| 기능 | 세부 정보 | Community | 도움말 |
|---|---|---|---|
| 모든 스레드에서 실시간 업데이트 | Data.AppendRow와 Data.UpdateRow는 스레드 안전합니다. 키로 필드 하나 또는 여러 개를 갱신할 수 있으며, BeginUpdate와 EndUpdate는 연속된 업데이트를 한 번의 다시 그리기로 묶고 MaxFPS가 속도를 조절합니다. | 도움말 | |
| 변경 시 깜박임 | 값이 오르면 변경된 셀이 녹색으로, 내리면 빨간색으로 깜박인 뒤 사라집니다. 테일 모드는 로그나 피드의 최신 행이 계속 보이도록 유지합니다. | 도움말 | |
| 가상 모드 | 행을 저장하지 않습니다. VirtualRowCount가 개수를 지정하고 OnGetValue가 그려지는 값마다 값을 반환하므로, 백만 행도 오십 행과 같은 비용이 듭니다. | 도움말 |
| 기능 | 세부 정보 | Community | 도움말 |
|---|---|---|---|
| 정렬 | SortOrder와 SortIndex로 여러 열을 기준으로 정렬하며, Ctrl 키를 누르고 클릭하면 열이 추가됩니다. 정렬은 안정적입니다. | 도움말 | |
| 필터링 | FilterText는 표시된 열 중 하나에라도 해당 텍스트가 들어 있는 행만 남기고, OnFilterRow로 사용자 지정 규칙을 추가할 수 있습니다. | 도움말 | |
| 선택 및 키보드 | SelectionMode로 행 또는 셀을 선택하고 키보드로 이동하며, Ctrl+C는 탭으로 구분된 텍스트로 복사합니다. 선택은 해당 키를 따라갑니다. | 도움말 | |
| 열 크기 조절 | 사용자가 머리글 가장자리를 끌어 열 크기를 조절하며 MinWidth 아래로는 줄어들지 않고, OnColumnResized가 이를 알려 줍니다. | 도움말 | |
| 고정 열 | FrozenColumns는 나머지 열이 스크롤되는 동안 처음 보이는 열들을 제자리에 유지하며, 머리글, 바닥글, 그룹 요약도 함께 따라갑니다. | 도움말 | |
| 조건부 서식 | 값이 조건과 일치하면 서식 규칙이 셀 또는 행 전체에 색을 입히며, 반투명 색상으로 배경 위에 셀을 물들입니다. | 도움말 | |
| 오른쪽에서 왼쪽 (아랍어와 히브리어) | 열이 오른쪽에서부터 흐르고 고정 열은 오른쪽 가장자리에 있으며, 스크롤 막대, 트리와 그룹 들여쓰기, 화살표 표시, 머리글 아이콘, 바닥글, 인플레이스 편집기가 미러링됩니다. 숫자와 날짜는 왼쪽에서 오른쪽 구간으로 유지됩니다. SaveToXLSX(Registered)는 TsgcGridXLSXWriter.RightToLeft를 통해서도 오른쪽에서 왼쪽 시트를 만듭니다. | 도움말 | |
| 열 필터 | 모든 머리글의 깔대기(ShowFilterButtons)는 해당 열의 고유 값과 개수, 검색 상자, And 또는 Or로 연결한 형식 지정 조건 최대 2개가 있는 팝업을 엽니다. | 도움말 | |
| 필터 행 | ShowFilterRow는 머리글 아래에 입력하는 동안 각 열을 필터링하는 행을 추가하며, 열별 연산자는 FilterRowOperator에서 지정합니다. | 도움말 | |
| 찾기 패널 | Ctrl+F 또는 ShowFindPanel은 모든 셀의 텍스트를 강조 표시하고, F3과 Shift+F3은 일치 항목 사이를 이동하며, FindOnlyMatches는 나머지 행을 숨깁니다. | 도움말 | |
| 열 선택기와 머리글 메뉴 | 머리글을 마우스 오른쪽 버튼으로 클릭하면 정렬, 그룹화, 너비 맞춤, 필터링, 열 선택기 열기를 할 수 있습니다. 열 선택기는 열마다 확인란이 있는 팝업입니다. ShowColumnChooser는 코드에서 이를 엽니다. | 도움말 | |
| 열 순서 변경 | 사용자는 머리글을 끌어 열을 옮깁니다. 열은 고정 열의 같은 쪽과 자신의 밴드 안에 머물며, OnColumnMoved가 이동을 알려 줍니다. | 도움말 | |
| 최적 너비 | 머리글 가장자리를 더블 클릭하거나 BestFitColumn과 BestFitColumns를 사용하면, 캡션과 최대 1,000개의 샘플 행에 맞춰 너비가 조정됩니다. | 도움말 | |
| 레이아웃 유지 | SaveLayoutToString, SaveLayoutToStream, SaveLayoutToFile은 열 순서, 너비, 표시 여부, 정렬, 그룹화, 열 필터, 밴드를 버전이 있는 JSON으로 유지하고, Load 메서드가 이를 복원합니다. | 도움말 | |
| 다중 선택 | gsmMultiRow는 임의의 행 집합을, gsmCellRange는 셀 범위를 Ctrl, Shift, Ctrl+A로 선택합니다. 선택은 행 키로 유지되며, Ctrl+C는 이를 탭으로 구분된 텍스트로 복사합니다. | 도움말 |
| 기능 | 세부 정보 | Community | 도움말 |
|---|---|---|---|
| 그룹화 | GroupBy 또는 머리글을 그룹 패널로 끌어서 하나 이상의 열로 그룹화하며, 중첩되고 접을 수 있는 그룹 행이 표시됩니다. | 도움말 | |
| 요약 | SummaryType으로 Sum, Count, Average, Min, Max를 모든 그룹 행과 바닥글에 표시하며 SummaryFormat으로 서식을 지정합니다. | 도움말 | |
| 트리 행 | 키 열과 부모 열(Tree.KeyField, Tree.ParentField)로 계층 구조를 만들며, 펼침 상태는 키별로 유지됩니다. | Registered 에디션 | 도움말 |
| 마스터 상세 | 펼친 각 마스터 행 아래에 관련 행의 상세 영역이 열리며, TsgcGridDataStore, 그리드 또는 OnGetDetailData로 채웁니다. | Registered 에디션 | 도움말 |
| 기능 | 세부 정보 | Community | 도움말 |
|---|---|---|---|
| 인플레이스 편집 | 텍스트 에디터 또는 선택 목록 콤보 상자로 셀을 편집하며, OnValidate, OnEditError, OnEdited를 지원합니다. | Registered 에디션 | 도움말 |
| DataSet 바인딩 | TsgcGridSource_DataSet는 모든 TDataSet으로 그리드를 채우고, AutoColumns로 열을 만들며, LiveUpdates를 사용하면 모든 Append, Edit, Delete를 따라갑니다. .NET에서는 같은 소스가 DataTable을 읽습니다. | 도움말 | |
| ItemsSource 및 MVVM 바인딩 (.NET) | TsgcWpfGrid와 TsgcAvaloniaGrid는 모든 IEnumerable인 ItemsSource의 항목을 표시하며, AutoGenerateColumns, KeyMember, 양방향 SelectedItem을 지원합니다. WPF에서는 ICollectionView의 정렬, 필터, 그룹화가 적용되고, IsSynchronizedWithCurrentItem은 현재 항목을 따라갑니다. TsgcWinFormsGrid는 DataGridView처럼 DataSource와 DataMember를 바인딩합니다. ItemsWriteBack을 사용하면 편집, 삽입, 삭제가 항목에 다시 반영됩니다. | ~Community는 바인딩된 항목을 표시하고 따라갑니다. ItemsWriteBack은 Registered 에디션입니다. | 도움말 |
| XAML과 디자이너의 열 (.NET) | 그리드 안의 TsgcWpfGridColumn과 TsgcAvaloniaGridColumn 요소가 FieldName(Customer.Country 같은 점 경로), Caption, DataType, DisplayFormat으로 열을 선언합니다. WinForms에서는 .NET Framework와 .NET 8 이상의 Visual Studio 디자이너가 스마트 태그와 컬렉션 편집기로 Columns를 편집하며, 빈 그리드는 디자이너와 WPF 및 Avalonia 미리 보기에 샘플 행을 표시합니다. | 도움말 | |
| JSON 및 CSV | sgcGrid_IO는 문자열, 스트림, 파일에서 행을 JSON 또는 CSV(RFC 4180)로 불러오고 저장하며 Linux64에서도 동작합니다. | 도움말 | |
| Excel 내보내기 | SaveToXLSX는 열 너비, 숫자 서식, 고정 틀, 그룹 또는 트리 윤곽, SUBTOTAL 수식을 포함한 Excel 통합 문서를 만듭니다. | Registered 에디션 | 도움말 |
| Excel 모드 | ExcelMode를 켜면 그리드가 가벼운 스프레드시트처럼 동작합니다. Ctrl+C로 복사하는 범위 선택, 계열을 이어 가고 수식 참조를 이동하는 채우기 핸들, A1 참조와 SUM, AVERAGE, MIN, MAX, COUNT, IF, ROUND, ABS를 지원하는 수식을 제공합니다. LoadFromXLSX는 외부 라이브러리 없이 Excel 통합 문서의 시트를 엽니다. | Registered 에디션 | 도움말 |
| DataSet 편집 | WriteBack을 켜면 TsgcGridSource_DataSet이 그리드의 변경을 각 레코드에 포스트하고, SyncCursor는 현재 레코드와 활성 행을 함께 유지하며, AllowInsert와 AllowDelete는 레코드를 추가하고 삭제합니다. 조회 필드는 선택 목록으로 편집됩니다. | Registered 에디션 | 도움말 |
| 클립보드 붙여넣기 | Ctrl+V는 Excel에서 가져온 탭 구분 텍스트를 셀 범위에 붙여넣습니다. 모든 값은 무엇이든 기록하기 전에 변환되고 검증되며, 붙여넣기 전체가 하나의 실행 취소 단계가 됩니다. | Registered 에디션 | 도움말 |
| 실행 취소와 다시 실행 | Ctrl+Z와 Ctrl+Y는 셀 편집과 붙여넣기를 행 키 단위로 최대 UndoLimit단계까지 실행 취소하고 다시 실행합니다. | Registered 에디션 | 도움말 |
| 셀 편집기 | EditorKind는 날짜, 시간, 날짜와 시간 선택기, 화살표가 있는 숫자 상자, 색 선택기, sgcEditors의 토큰 편집기 중에서 고르고, OnCreateEditor는 원하는 컨트롤을 셀에 놓습니다. | Registered 에디션 | 도움말 |
| 인쇄 및 인쇄 미리 보기 | Print와 ShowPrintPreview는 필터, 정렬, 그룹화를 적용한 그리드 표시 그대로 모든 행을 인쇄하고, 모든 페이지에 밴드와 열 머리글을 반복하며, 한 페이지에는 온전한 행만 담습니다. PrintSettings는 용지, 방향, 여백, 배율, 머리글과 바닥글을 한 번 설정하면 프린터, 미리 보기, PDF에 모두 적용됩니다. 모든 에디션에서 VCL, FireMonkey, WinForms, WPF, Avalonia에서 사용할 수 있습니다(FireMonkey 인쇄는 Windows와 macOS에서 동작합니다). | 도움말 | |
| 접근 가능한 PDF 내보내기, PDF/UA 및 PDF/A(sgcPDF 사용) | ExportToPDF는 글꼴이 포함되고 검색 가능한 텍스트를 가진 벡터 페이지를 기록하며, 모든 페이지가 머리글 셀을 가진 실제 표이므로 화면 읽기 프로그램이 읽을 수 있습니다. 파일은 기본적으로 태그가 지정된 PDF/UA 문서이며, PDFALevel로 PDF/A-2a 또는 PDF/A-3a를 추가할 수 있습니다. sgcUIPDF 브리지와 라이선스가 있는 sgcPDF가 필요합니다(.NET에서는 esegece.sgcUICore.sgcPDF). | Registered 에디션 | 도움말 |
| 기능 | 세부 정보 | Community | 도움말 |
|---|---|---|---|
| 테마 | 모든 sgcUI 제품이 공유하는 라이트 및 다크 테마: Theme, AccentColor, 행 높이와 밀도 설정. | 도움말 | |
| 헤드리스 렌더링 | SaveToPNG와 SaveToSVG는 현재 보기를 저장하고, TsgcGridRenderer는 독립된 TsgcGridData를 PNG 또는 SVG로 그리며 Linux64에서도 동작합니다. | 도움말 | |
| 그리드에서 차트 만들기 | sgcCharts의 TsgcChartDataSource_Table이 그리드 행을 그리고 정렬과 필터를 그대로 따르며, 그 사이에 코드가 필요 없습니다. | 도움말 | |
| 밴드 | 열 그룹 위의 캡션으로, 단계 수에는 제한이 없습니다. Bands가 캡션을 보관하고 Column.Band가 열을 밴드 중 하나 아래에 놓습니다. | 도움말 | |
| 셀 형식 | CellKind는 셀을 이미지 목록의 이미지, 진행률 막대, 꺾은선, 영역, 막대 스파크라인으로 그리지만 셀은 원래 값을 유지합니다. | 도움말 | |
| 접근성 | 열 머리글, 행, 셀이 있는 표로 UI Automation에 노출되며, 포커스된 셀, 선택 영역, 정렬, 필터, 그룹화, 트리 행도 노출됩니다. 화면 읽기 프로그램(Narrator, NVDA 등)이 이 API를 사용합니다. 필터링, 그룹화, 열 이동에는 키보드 대안이 있고(열 너비 조절은 마우스가 필요합니다), 포커스 링은 항상 보이며 Windows 고대비를 따릅니다. Delphi 7~13의 VCL, Windows의 FireMonkey, WinForms, WPF, Avalonia에서 기본으로 켜져 있습니다. | 도움말 |
| 기능 | 세부 정보 | Community | 도움말 |
|---|---|---|---|
| 그리드에 질문하기 | TsgcGridAI는 일상 언어로 된 질문을 필터, 정렬, 행 강조 표시로 바꿉니다. 공급자를 지정하지 않으면 규칙 기반 로컬 파서가 네트워크도 API 키도 없이 답합니다. 공급자를 지정하면 어떤 LLM이든 답하며, 호출이 실패하거나 답이 검증을 통과하지 못하면 규칙 기반 파서가 대신합니다. | 도움말 | |
| AI 쿼리 바(VCL 및 FireMonkey) | TsgcVCLAIQueryBar와 TsgcFMXAIQueryBar, FireMonkey는 Windows, macOS, iOS, Android: 질문을 입력하고 Enter를 누르면 적용된 내용이 표시되며, 실행 중인 질문은 취소하고 마지막 답은 실행 취소할 수 있습니다. 최근 질문과 추천 질문도 제공합니다. 키보드, 화면 읽기 프로그램, 고대비, 오른쪽에서 왼쪽 레이아웃에서 동작합니다. | 도움말 | |
| AI 쿼리 바(WinForms, WPF, Avalonia) | TsgcWinFormsAIQueryBar, TsgcWpfAIQueryBar, TsgcAvaloniaAIQueryBar는 .NET에서 같은 기능을 제공하며, 호스트의 라이트 또는 다크 테마를 따릅니다. | 도움말 | |
| 모든 LLM | TsgcUIAIEventProvider는 OnRequest 이벤트에서 각 요청을 사용자 코드에 넘기므로, 어떤 AI 서비스, 모델, 온프레미스 서버든 답할 수 있습니다. .NET에서는 RequestAsync가 비동기 핸들러를 받습니다. | 도움말 | |
| sgcWebSockets AI 공급자 | sgcUICoreWS 브리지의 TsgcUIAIChatProvider는 모든 플랫폼에서 sgcWebSockets의 TsgcAIChat 컴포넌트를 사용합니다. .NET에서는 esegece.sgcUICore.sgcWebSockets 패키지입니다. 등록된 sgcWebSockets가 필요합니다. | Registered 에디션 | 도움말 |
| 개인정보 보호 | 질문과 필드 카탈로그만 전송합니다. 이름, 캡션, 형식, 기본적으로 열당 최대 3개의 샘플 값(MaxSampleValues, SendSampleValues)이며 행은 절대 전송하지 않습니다. OnBeforeAsk가 각 요청을 수정하거나 취소할 수 있습니다. | 도움말 |
| 기능 | sgcGrid | 기본 Delphi 컨트롤 |
|---|---|---|
| 작업자 스레드에서 Synchronize 없이 키로 행 업데이트 | — | |
| 변경된 셀이 깜박이다 사라짐 | — | |
| 셀 또는 행 전체에 서식 규칙 적용 | — | |
| 그룹 패널, 그룹 및 바닥글 요약을 갖춘 그룹화 | — | |
| 트리 행과 마스터 상세 영역 | — | |
| 윤곽과 수식이 있는 Excel 통합 문서 내보내기 | — | |
| Linux64에서도 가능한 헤드리스 PNG 및 SVG 렌더링 | — | |
| Excel 스타일 열 필터 팝업, 필터 행, 찾기 패널 | — | |
| 열 선택기, 머리글 메뉴, JSON으로 저장되는 레이아웃 | — | |
| 열 그룹 위의 밴드 머리글 | — | |
| 사용자 지정 그리기 코드 없이 쓰는 진행률 막대, 스파크라인, 이미지 셀 | — | |
| Excel에서 셀 범위 붙여넣기, 실행 취소와 다시 실행 | — |
도움말에 문서화된 기능만 비교하며, 성능에 대한 주장은 포함하지 않습니다.
.NET 그리드는 동일한 클래스 이름을 가진 C# 포트이며 WinForms, WPF, Avalonia를 지원합니다. 무료 Community 패키지로 시작하고, 모든 기능이 필요하면 등록 패키지로 전환하세요.
| 패키지 | 에디션 | 내용 |
|---|---|---|
esegece.sgcGrid.Community | Community (무료) | 코어 라이브러리 |
esegece.sgcGrid | Registered 에디션 | 코어 라이브러리 |
esegece.sgcGrid.WinForms | Registered 에디션 | Windows Forms 컨트롤 |
esegece.sgcGrid.Wpf | Registered 에디션 | WPF 컨트롤 |
esegece.sgcGrid.Avalonia | Registered 에디션 | Avalonia 컨트롤 |
esegece.sgcGrid.Rendering | Registered 에디션 | 헤드리스 렌더링 |
esegece.sgcGrid.sgcWebSockets | Registered 에디션 전용 | sgcWebSockets 브리지 |
esegece.sgcUICore.sgcWebSockets | Registered 에디션 전용 | sgcWebSockets AI 공급자 (TsgcUIAIChatProvider) |
esegece.sgcGrid.sgcHTML | Registered 에디션 전용 | sgcHTML 브리지 |
sgcGrid의 모든 기능은 sgcUI 도움말에 문서화되어 있으며, 개발 환경별로 별도의 도움말이 제공됩니다.
sgcUI 전체 도움말을 PDF 파일로 제공하며, 오프라인으로 읽거나 인쇄할 수 있습니다.
Delphi (PDF) →