sgcGrid 기능 표
sgcGrid의 모든 기능을 작업별로 정리했으며, 각 기능의 도움말 항목으로 연결됩니다. 동일한 모델이 VCL, FireMonkey, WinForms, WPF, Avalonia 그리드를 구동합니다.
sgcGrid의 모든 기능을 작업별로 정리했으며, 각 기능의 도움말 항목으로 연결됩니다. 동일한 모델이 VCL, FireMonkey, WinForms, WPF, Avalonia 그리드를 구동합니다.
6개 기능
24개 기능
4개 기능
22개 기능
11개 기능
3개 기능
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가 그려지는 값마다 값을 반환하므로, 백만 행도 오십 행과 같은 비용이 듭니다. | 도움말 | |
| ISA-18.2 알람 목록 | TsgcGridAlarmModel은 HMI의 알람을 ISA-18.2 상태(확인 전 활성, 확인된 활성, 확인 전 정상 복귀, 정상, 보류 및 억제)와 우선순위 1~4로 관리합니다. 애플리케이션은 RaiseAlarm과 ClearAlarm을 호출하고, 운영자는 Acknowledge, AcknowledgeAll, Shelve, Unshelve를 사용하며, FilterPriorities, FilterStates, FilterText로 목록을 필터링하고 JSON 또는 CSV로 내보낼 수 있습니다. TsgcGridAlarmLink는 이를 태그당 한 행씩 그리드에 표시하며 우선순위 색상과 확인 전 행의 깜박임을 적용하고, TsgcVCLGridAlarmMenu는 컨텍스트 메뉴를 추가합니다(FireMonkey에서는 TsgcFMXGridAlarmMenu, .NET에서는 WinForms, WPF, Avalonia 메뉴). | 도움말 | |
| 알람 확인 로그 | 모든 확인, 보류, 보류 해제, 억제, 억제 해제와 만료되는 모든 보류는 시간과 사용자를 담은 항목을 Log에 추가하고 OnLog를 발생시키므로, 예를 들어 데이터베이스에 기록할 수 있습니다. SaveToJSON과 SaveToCSV가 로그를 저장합니다. | Registered 에디션 | 도움말 |
| 로그 뷰어 | TsgcGridLogModel은 시간, trace부터 fatal까지의 수준, 소스, 메시지가 있는 로그 줄을 링 버퍼에 보관하며, 작업자 스레드가 줄을 직접 추가합니다. TsgcGridLogLink는 이를 가상 모드의 그리드에 수준별 색상으로 표시하고, 수준, 소스, 텍스트로 필터링하며, 강조 규칙, 사용자가 위로 스크롤하면 멈추는 끝 따라가기, 일시 중지와 재개, 텍스트, JSON, CSV로 내보내기를 지원합니다. | 도움말 |
| 기능 | 세부 정보 | Community | 도움말 |
|---|---|---|---|
| 정렬 | SortOrder와 SortIndex로 여러 열을 기준으로 정렬하며, Ctrl 키를 누르고 클릭하면 열이 추가됩니다. 정렬은 안정적입니다. | 도움말 | |
| 필터링 | FilterText는 표시된 열 중 하나에라도 해당 텍스트가 들어 있는 행만 남기고, OnFilterRow로 사용자 지정 규칙을 추가할 수 있습니다. | 도움말 | |
| 선택 및 키보드 | SelectionMode로 행 또는 셀을 선택하고 키보드로 이동하며, Ctrl+C는 탭으로 구분된 텍스트로 복사합니다. 선택은 해당 키를 따라갑니다. | 도움말 | |
| 열 크기 조절 | 사용자가 머리글 가장자리를 끌어 열 크기를 조절하며 MinWidth 아래로는 줄어들지 않고, OnColumnResized가 이를 알려 줍니다. | 도움말 | |
| 너비를 가득 채우는 열 | AutoFitColumns는 그리드 너비를 열의 너비에 비례하여 열에 나누어 주고, Column.AutoFit를 False로 하면 고정 너비를 유지하며, MaxWidth는 열의 크기를 조정하거나 맞출 때 열 너비의 상한을 정합니다. | 도움말 | |
| 고정 열 | FrozenColumns는 나머지 열이 스크롤되는 동안 처음 보이는 열들을 제자리에 유지하며, 머리글, 바닥글, 그룹 요약도 함께 따라갑니다. | 도움말 | |
| 조건부 서식 | 값이 조건과 일치하면 서식 규칙이 셀 또는 행 전체에 색을 입히며, 반투명 색상으로 배경 위에 셀을 물들입니다. | 도움말 | |
| 글꼴 스타일과 아이콘 세트 | 서식 규칙은 굵게뿐 아니라 기울임꼴, 밑줄, 취소선도 설정할 수 있으며, OnGetCellFont는 모든 셀의 글꼴 스타일과 크기를 설정합니다. AddIconSet은 두 개의 임계값을 기준으로 화살표, 원, 깃발, 확인 표시를 추가하며, 규칙은 직접 만든 아이콘이나 이미지도 표시할 수 있습니다. | 도움말 | |
| 오른쪽에서 왼쪽 (아랍어와 히브리어) | 열이 오른쪽에서부터 흐르고 고정 열은 오른쪽 가장자리에 있으며, 스크롤 막대, 트리와 그룹 들여쓰기, 화살표 표시, 머리글 아이콘, 바닥글, 인플레이스 편집기가 미러링됩니다. 숫자와 날짜는 왼쪽에서 오른쪽 구간으로 유지됩니다. SaveToXLSX(Registered)는 TsgcGridXLSXWriter.RightToLeft를 통해서도 오른쪽에서 왼쪽 시트를 만듭니다. | 도움말 | |
| 열 필터 | 모든 머리글의 깔대기(ShowFilterButtons)는 해당 열의 고유 값과 개수, 검색 상자, And 또는 Or로 연결한 형식 지정 조건 최대 2개가 있는 팝업을 엽니다. | 도움말 | |
| 필터 행 | ShowFilterRow는 머리글 아래에 입력하는 동안 각 열을 필터링하는 행을 추가하며, 열별 연산자는 FilterRowOperator에서 지정합니다. | 도움말 | |
| 날짜 기간 | 날짜 열은 오늘, 어제, 이번 주 또는 지난주, 이번 달 또는 지난달, 올해 또는 작년, 최근 N일로 필터링할 수 있으며, 열 필터와 필터 행에서 사용합니다. FirstDayOfWeek는 한 주의 시작 요일을 정하며 기본값은 로캘을 따릅니다. | 도움말 | |
| 찾기 패널 | Ctrl+F 또는 ShowFindPanel은 모든 셀의 텍스트를 강조 표시하고, F3과 Shift+F3은 일치 항목 사이를 이동하며, FindOnlyMatches는 나머지 행을 숨깁니다. | 도움말 | |
| 열 선택기와 머리글 메뉴 | 머리글을 마우스 오른쪽 버튼으로 클릭하면 정렬, 그룹화, 너비 맞춤, 필터링, 열 선택기 열기를 할 수 있습니다. 열 선택기는 열마다 확인란이 있는 팝업입니다. ShowColumnChooser는 코드에서 이를 엽니다. | 도움말 | |
| 머리글 이미지와 버튼 | HeaderImageIndex는 캡션 앞에 이미지를 표시하고, HeaderButton은 OnHeaderButtonClick을 발생시키는 버튼을 추가하며, OnHeaderClick은 머리글 클릭에 따른 정렬을 건너뛸 수 있습니다. | 도움말 | |
| 열 순서 변경 | 사용자는 머리글을 끌어 열을 옮깁니다. 열은 고정 열의 같은 쪽과 자신의 밴드 안에 머물며, OnColumnMoved가 이동을 알려 줍니다. | 도움말 | |
| 최적 너비 | 머리글 가장자리를 더블 클릭하거나 BestFitColumn과 BestFitColumns를 사용하면, 캡션과 최대 1,000개의 샘플 행에 맞춰 너비가 조정됩니다. | 도움말 | |
| 레이아웃 유지 | SaveLayoutToString, SaveLayoutToStream, SaveLayoutToFile은 열 순서, 너비, 표시 여부, 정렬, 그룹화, 열 필터, 밴드를 버전이 있는 JSON으로 유지하고, Load 메서드가 이를 복원합니다. | 도움말 | |
| 자동 레이아웃 | AutoSaveLayout을 사용하면 그리드가 닫힐 때 레이아웃을 저장하고 다음 실행에서 복원하며, 저장 위치는 그리드별 파일 또는 OnSaveLayout과 OnLoadLayout입니다. 열 머리글 메뉴의 Reset layout은 디자인 타임 열을 되돌립니다. | 도움말 | |
| 다중 선택 | gsmMultiRow는 임의의 행 집합을, gsmCellRange는 셀 범위를 Ctrl, Shift, Ctrl+A로 선택합니다. 선택은 행 키로 유지되며, Ctrl+C는 이를 탭으로 구분된 텍스트로 복사합니다. | 도움말 | |
| 행 머리글 | RowHeader는 행 왼쪽에 레코드 표시기, 행 번호, 행마다 하나의 확인란이 있는 띠를 추가하며, 모서리의 확인란은 모든 행을 선택하거나 해제합니다. SelectionColor와 SelectionTextColor는 선택 색상을 설정합니다. | 도움말 | |
| 행 끌어다 놓기 | RowDragMode는 선택한 행을 다른 컨트롤로 끌어다 놓으며, VCL에서는 grdOLE가 Excel 같은 다른 애플리케이션에 텍스트, CSV, HTML 표로 놓습니다. OnStartRowDrag로 끌기를 취소할 수 있습니다. | 도움말 | |
| 카드 보기 | ViewStyle을 gvsCard로 설정하면 모든 행이 카드가 되며, 카드에는 선택 사항인 캡션 막대, 선택 사항인 이미지, 보이는 열마다 한 줄이 들어 있습니다. 카드는 표와 같은 행을 보여 주므로 정렬, 필터, 찾기 패널, 선택, 편집, 서버 모드가 두 보기에서 모두 동작합니다. CardOptions가 CaptionField, ImageField, CardWidth, CardColumns, 간격을 설정합니다. 카드 보기는 그룹화하지 않습니다. | Registered 에디션 | 도움말 |
| 카드 보기 키와 마우스 | 화살표 키는 카드 사이를 이동하고, Home과 End는 밴드의 첫 카드와 마지막 카드로 이동하며, Tab은 카드의 필드 사이를 이동하고, F2는 필드를 편집하며, 필드 캡션을 마우스 오른쪽 버튼으로 누르면 머리글 없이 정렬하고 필터링할 수 있는 열 메뉴가 열립니다. | Registered 에디션 | 도움말 |
| 기능 | 세부 정보 | 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을 읽습니다. | 도움말 | |
| DataSet 필터와 정렬 | ApplyFilter를 사용하면 DataSet이 그리드가 표시하는 행만 유지하므로 그 DataSet을 쓰는 다른 컨트롤도 같은 행을 보며, OnApplySort는 그리드의 정렬을 쿼리에 쓸 필드 이름으로 전달합니다. .NET에서는 DataTable 뷰가 그리드 필터를 따릅니다. | 도움말 | |
| 서버 모드 | 프로바이더 컴포넌트가 한 번에 한 페이지씩 행을 읽고, 데이터 소스가 정렬, 열 필터, 필터 행, 찾기 텍스트, 바닥글 요약, 행 수를 평가하므로 수백만 행의 테이블도 쉰 행의 테이블만큼 빠르게 열립니다. 아직 불러오지 않은 행은 자리 표시자 막대로 표시하며, 편집 내용은 프로바이더를 통해 다시 쓰입니다. 서버 모드에서는 트리 행과 상세 영역을 사용할 수 없으며, 필터 팝업에 행 수가 표시되지 않습니다. | Registered 에디션 | 도움말 |
| 서버 모드 프로바이더 | TsgcGridServerProvider_DataSet는 SQLite, SQL Server, PostgreSQL, MySQL, Oracle, Firebird, InterBase 또는 일반 Dialect용 SQL을 만들어 FireDAC, dbExpress, ADO, IBX, UniDAC, Zeos 같은 모든 쿼리 컴포넌트로 실행합니다. .NET에서는 TsgcGridServerProvider_Queryable이 모든 IQueryable을, TsgcGridServerProvider_AdoNet이 모든 ADO.NET 연결을 읽습니다. TsgcGridServerProvider_Callback은 그 밖의 모든 소스를 이벤트로 제공하며 어느 스레드에서든 응답할 수 있습니다. | Registered 에디션 | 도움말 |
| 서버 그룹화 | 서버 모드의 그룹화는 수준마다 GROUP BY 하나를 실행합니다. 그룹은 행 수와 요약과 함께 오고, 그룹의 하위 행은 처음 펼칠 때 불러옵니다. MaxGroups는 한 부모 아래에 나열되는 그룹 수를 제한합니다. | Registered 에디션 | 도움말 |
| TDBGrid에서 가져오기 (VCL) | 디자인 타임에 그리드 컨텍스트 메뉴의 Import columns from DB grid 명령이 TDBGrid의 열, DataSet 연결, 위치, 이벤트를 복사하고 복사하지 못한 항목을 나열합니다. | 도움말 | |
| 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 통합 문서를 만듭니다. Excel 모드에서는 모든 시트를 수식과 계산된 값과 함께 씁니다. | Registered 에디션 | 도움말 |
| Excel 모드 | ExcelMode를 켜면 그리드가 가벼운 스프레드시트처럼 동작합니다. Ctrl+C로 복사하는 범위 선택, 계열을 이어 가고 수식 참조를 이동하는 채우기 핸들, A1 참조, 다른 시트 참조, SUM, AVERAGE, MIN, MAX, COUNT, IF, ROUND, ABS를 지원하는 수식을 제공합니다. LoadFromXLSX는 외부 라이브러리 없이 Excel 통합 문서를, 모든 시트를 수식과 셀 서식과 함께 엽니다. | Registered 에디션 | 도움말 |
| 셀 서식 | 셀별 굵게, 기울임, 밑줄, 취소선, 글꼴 크기와 색, 채우기 색, 가로 및 세로 맞춤, 줄 바꿈, 숫자 서식, 테두리를 Excel 모드에서 FormatSelection, ToggleSelectionFontStyle 또는 Ctrl+B, Ctrl+I, Ctrl+U, Ctrl+5로 지정합니다. 서식은 데이터와 함께 저장되고, 변경은 모두 실행 취소 한 단계이며, SaveToXLSX와 LoadFromXLSX가 서식을 유지합니다. | Registered 에디션 | 도움말 |
| 시트 | AddSheet, RenameSheet, DeleteSheet, MoveSheet, ActiveSheet로 한 그리드에 여러 시트를 두고, ShowSheetTabs를 켜면 탭 막대에서 시트를 전환, 추가, 이름 변경, 순서 변경할 수 있습니다. 수식은 Orders!E1:E20 또는 'Q4 Notes'!B1 같은 참조로 다른 시트를 읽으며, 이름을 바꾸면 이 참조도 함께 바뀝니다. | Registered 에디션 | 도움말 |
| 열 수식 | 열 Formula(예: =C1*D1)는 1행 기준으로 작성하며, 읽기 전용 열의 모든 행을 메모리 데이터, 가상 모드, TsgcGridSource_DataSet에서 계산합니다. 가상 모드에서는 OnGetValue가 반환하는 수식 텍스트도 계산됩니다. | Registered 에디션 | 도움말 |
| DataSet 편집 | WriteBack을 켜면 TsgcGridSource_DataSet이 그리드의 변경을 각 레코드에 포스트하고, SyncCursor는 현재 레코드와 활성 행을 함께 유지하며, AllowInsert와 AllowDelete는 레코드를 추가하고 삭제합니다. 조회 필드는 선택 목록으로 편집됩니다. | Registered 에디션 | 도움말 |
| 클립보드 붙여넣기 | Ctrl+V는 Excel에서 가져온 탭 구분 텍스트를 셀 범위에 붙여넣습니다. 모든 값은 무엇이든 기록하기 전에 변환되고 검증되며, 붙여넣기 전체가 하나의 실행 취소 단계가 됩니다. | Registered 에디션 | 도움말 |
| 실행 취소와 다시 실행 | Ctrl+Z와 Ctrl+Y는 셀 편집과 붙여넣기를 행 키 단위로 최대 UndoLimit단계까지 실행 취소하고 다시 실행합니다. | Registered 에디션 | 도움말 |
| 셀 편집기 | EditorKind는 날짜, 시간, 날짜와 시간 선택기, 화살표가 있는 숫자 상자, 색 선택기, sgcEditors의 토큰 편집기 중에서 고르고, OnCreateEditor는 원하는 컨트롤을 셀에 놓습니다. | Registered 에디션 | 도움말 |
| 메모 및 조회 편집기 | gedMemo는 긴 텍스트를 여러 줄로 편집하고, gedLookup은 여러 열이 있는 목록에서 값을 고르며, 목록은 LookupItems 또는 DataSet의 조회 필드로 채웁니다. | 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, 행 높이와 밀도 설정. Fluent 테마 프리셋에서는 그리드가 Windows 11 색상과 Windows 강조 색을 사용하고, 태그 칩은 프리셋의 RadiusChip에서 모서리를 가져옵니다(Classic은 6픽셀, Fluent는 4픽셀). | 도움말 | |
| 헤드리스 렌더링 | SaveToPNG와 SaveToSVG는 현재 보기를 저장하고, TsgcGridRenderer는 독립된 TsgcGridData를 PNG 또는 SVG로 그리며 Linux64에서도 동작합니다. | 도움말 | |
| 그리드에서 차트 만들기 | sgcCharts의 TsgcChartDataSource_Table이 그리드 행을 그리고 정렬과 필터를 그대로 따르며, 그 사이에 코드가 필요 없습니다. | 도움말 | |
| 밴드 | 열 그룹 위의 캡션으로, 단계 수에는 제한이 없습니다. Bands가 캡션을 보관하고 Column.Band가 열을 밴드 중 하나 아래에 놓습니다. | 도움말 | |
| 셀 형식 | CellKind는 셀을 이미지 목록의 이미지, 진행률 막대, 꺾은선, 영역, 막대 스파크라인으로 그리지만 셀은 원래 값을 유지합니다. gcdTags는 구분된 텍스트 값으로 한 셀에 여러 색상 태그를 그리며, 테마에 맞는 자동 색상이나 태그별 고유 색상을 쓸 수 있고, +N 칩에는 전체 목록이 힌트로 표시되며, 태그별 필터도 지원합니다. | 도움말 | |
| 확인 및 링크 셀 | TrueValue와 FalseValue는 S와 N 같은 값을 저장하는 열에 확인란을 표시하며, DataSet 소스에서는 BooleanFields가 이를 설정합니다. 확인란을 전환하려면 Registered 에디션이 필요합니다. gcdLink는 텍스트를 OnLinkClick을 발생시키는 링크로 표시합니다. | 도움말 | |
| BLOB 필드의 이미지 | BLOB 필드의 gcdImage 열은 그 안에 저장된 그림을 그리고, OnGetCellImage는 다른 모든 이미지를 제공하며, ImagePreview는 마우스가 셀 위에 머물면 더 큰 사본을 표시합니다. | 도움말 | |
| 여러 줄 머리글과 행 | HeaderLines와 RowLines는 머리글과 행의 높이를 여러 줄로 만들고, WordWrap은 열의 텍스트를 줄 바꿈합니다. | 도움말 | |
| 셀과 머리글 힌트 | ShowTruncatedHints는 들어가지 않는 셀이나 캡션의 전체 텍스트를 힌트로 표시하고, OnGetCellHint는 모든 셀에 직접 만든 힌트를 설정합니다. | 도움말 | |
| 사용자 지정 셀 그리기 | OnCustomDrawCell 이벤트는 캔버스와 셀 사각형을 제공하며, 기본 내용을 유지하거나 건너뛸 수 있습니다. 인쇄와 PDF 내보내기에서도 실행됩니다. OnRenderError는 그리드가 그리는 동안 발생한 예외를 보고합니다. | 도움말 | |
| 접근성 | 열 머리글, 행, 셀이 있는 표로 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가 각 요청을 수정하거나 취소할 수 있습니다. | 도움말 |
| 기능 | 세부 정보 | Community | 도움말 |
|---|---|---|---|
| 실시간 피드 | sgcGridWS 브리지는 수신 메시지를 그리드에 기록하는 WebSocket, MQTT, SSE 피드 소스를 추가합니다. sgcWebSockets가 필요합니다. | Registered 에디션 | 도움말 |
| 실시간 로그 | sgcUICoreWS 브리지의 WebSocket, MQTT, SSE 실시간 소스가 JSON 메시지(append, batch, clear)에서 TsgcGridLogModel에 로그 줄을 추가하며, 소켓 스레드에서 한꺼번에 들어오는 로그는 메인 스레드를 한 번만 거칩니다. ApplyMessage는 자체 코드의 같은 메시지를 받습니다. sgcWebSockets가 필요합니다. | Registered | 도움말 |
| AI 어시스턴트로 그리드에 질문하기 | TsgcGridAIQuery는 이전 브리지 컴포넌트로, TsgcHTMLAIAssistant를 통해 답합니다. 새 프로젝트에서는 TsgcUIAIChatProvider와 함께 TsgcGridAI를 사용할 수 있습니다. | Registered 에디션 | 도움말 |
| 기능 | sgcGrid | 기본 Delphi 컨트롤 |
|---|---|---|
| 작업자 스레드에서 Synchronize 없이 키로 행 업데이트 | — | |
| 변경된 셀이 깜박이다 사라짐 | — | |
| 셀 또는 행 전체에 서식 규칙 적용 | — | |
| 그룹 패널, 그룹 및 바닥글 요약을 갖춘 그룹화 | — | |
| 트리 행과 마스터 상세 영역 | — | |
| 수백만 행의 데이터베이스 테이블을 서버에서 SQL로 페이징, 정렬, 필터링, 그룹화 | — | |
| 같은 행을 같은 정렬, 필터, 편집으로 보여 주는 카드 보기 | — | |
| 윤곽, 수식, 셀 서식, 여러 시트가 있는 Excel 통합 문서 내보내기 | — | |
| Linux64에서도 가능한 헤드리스 PNG 및 SVG 렌더링 | — | |
| Excel 스타일 열 필터 팝업, 필터 행, 찾기 패널 | — | |
| 열 선택기, 머리글 메뉴, JSON으로 저장되는 레이아웃 | — | |
| 열 그룹 위의 밴드 머리글 | — | |
| 사용자 지정 그리기 코드 없이 쓰는 진행률 막대, 스파크라인, 이미지, 태그 셀 | — | |
| 저장된 모든 값을 지원하는 확인란 열, 링크 셀, BLOB 필드의 그림 | — | |
| 여러 줄 머리글과 행, 머리글의 이미지와 버튼, 잘린 텍스트의 힌트 | — | |
| 확인란과 행 번호가 있는 행 머리글, 다른 애플리케이션으로 행 끌어다 놓기 | — | |
| 자동으로 저장되는 레이아웃과 그리드 너비를 가득 채우는 열 | — | |
| Excel에서 셀 범위 붙여넣기, 실행 취소와 다시 실행 | — |
도움말에 문서화된 기능만 비교하며, 성능에 대한 주장은 포함하지 않습니다.
.NET 그리드는 동일한 클래스 이름을 가진 C# 포트이며 WinForms, WPF, Avalonia를 지원합니다. 무료 Community 패키지로 시작하고, 모든 기능이 필요하면 등록 패키지로 전환하세요.
| 패키지 | 에디션 | 내용 |
|---|---|---|
esegece.sgcGrid.Community | Community (무료) | 코어 라이브러리 |
esegece.sgcGrid.WinForms.Community | Community (무료) | Windows Forms 컨트롤 |
esegece.sgcGrid.Wpf.Community | Community (무료) | WPF 컨트롤 |
esegece.sgcGrid.Avalonia.Community | Community (무료) | Avalonia 컨트롤 |
esegece.sgcGrid.Rendering.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) →