sgcUI의 WinForms 컨트롤
C#용 모던 WinForms 컨트롤: 그리드, 차트, 리본, 스케줄러를 Windows를 따르는 Fluent 라이트와 다크 테마로 제공해요.
C#용 모던 WinForms 컨트롤: 그리드, 차트, 리본, 스케줄러를 Windows를 따르는 Fluent 라이트와 다크 테마로 제공해요.
Altamira ERP는 Delphi, C++Builder, .NET WinForms용 sgcUI 제품군 데모로, 대시보드, 고객, 청구서, 계획, 워크플로, 보고서, 분석이 하나의 창에 들어 있어요. 아래의 Realtime, 에디터, 보고서 화면은 WinForms에서 캡처했어요.
다크 모드의 ERP 대시보드: KPI 카드, 매출 차트, 목표 게이지, 고객 지도.
sgcDashboard →
그룹 요약, 바닥글 합계, 연락처 카드를 갖춘 지역별 그룹 고객 그리드.
sgcGrid →
WinForms 기반 Realtime 데모: 접속 상태, 활동 피드, 알림 받은 편지함, 실시간 로그.
Realtime UI 팩 →
프로젝트 계획: 종속성과 크리티컬 패스가 있는 간트 차트.
sgcPlanner →
코드로 PDF로 생성하고 내장 PDF 뷰어에 표시하는 청구서.
sgcPDF →
다이어그램으로 그리고 요청 그리드에 연결한 승인 워크플로.
sgcDiagram →
WinForms의 sgcRichEdit 에디터 데모: 스타일, 목록, 표, 링크.
sgcRichEdit →
WinForms의 ReportTables 데모: 인쇄, PDF, 내보내기를 지원하는 보고서 미리보기.
.NET 보고 →sgcUI WinForms 컨트롤은 C#으로 작성된 일반 Windows Forms 컨트롤이에요. NuGet 패키지를 추가하고, Visual Studio 도구 상자에서 컨트롤을 폼으로 끌어다 놓은 다음 속성 창이나 코드에서 설정하세요.
Fluent 프리셋은 sgcUI 컨트롤에 Windows 11의 색상, 모서리, 포커스 링을 라이트와 다크로 적용하며, Windows에서 선택한 강조 색으로 그려요.
.NET 9 이상에서는 컨트롤이 Application.SetColorMode로 설정한 색상 모드를 따르며, 모든 대상에서 Windows의 라이트 또는 다크 설정도 따를 수 있어요.
아이콘이 있는 도구 상자 항목, 스마트 태그, 열, 시리즈, 필드용 컬렉션 편집기, 데이터를 바인딩하기 전에도 디자이너에 표시되는 샘플 데이터를 제공해요.
DataGridView를 바인딩하는 방식과 같이 폼의 CurrencyManager를 통해 DataSet, DataTable, DataView, BindingSource, IList, IListSource를 바인딩하세요.
그리드 데이터는 스레드 안전해요. 작업자 스레드가 키로 행을 업데이트하면 그리드는 UI 스레드에서 초당 최대 MaxFPS번 다시 그려져요.
WinForms, WPF, Avalonia에서 같은 모델과 클래스 이름을 사용하므로 화면을 호스트 사이에서 옮길 수 있고, 같은 컴포넌트가 Delphi와 C++Builder에도 있어요.
WinForms 컨트롤은 TsgcWinForms 접두사를 사용해요. 각 제품은 esegece.<Product>.WinForms NuGet 패키지를 제공하며, 대부분은 nuget.org에 무료 .WinForms.Community 빌드도 있어요.
| 제품 | WinForms 폼에 더해지는 기능 | 주요 WinForms 컨트롤 | Community |
|---|---|---|---|
| sgcGrid | WinForms 그리드: 어느 스레드에서든 키로 업데이트되는 행, 깜박이는 변경 표시, 조건부 서식, 그룹화, 요약, 필터를 지원해요. | TsgcWinFormsGrid, TsgcWinFormsFilterBuilder | 예 |
| sgcPivotGrid | 필드를 행, 열, 필터, 값 사이로 끌어다 놓는 필드 목록을 갖춘 피벗 테이블이에요. | TsgcWinFormsPivotGrid, TsgcWinFormsPivotFieldList | 예 |
| sgcCharts | WinForms 차트: 하나의 차트 모델에서 꺾은선, 막대, 캔들스틱, 원형 등 여러 시리즈를 지원하며 PNG와 SVG 출력과 스파크라인을 제공해요. | TsgcWinFormsChart, TsgcWinFormsSparkline | 예 |
| sgcDashboard | 차트, 게이지, 그리드, 피벗, 지도용 타일을 갖춘 타일과 KPI 카드 대시보드예요. | TsgcWinFormsDashboard, TsgcWinFormsDashboardTile, TsgcWinFormsKPICard | 예 |
| sgcGauges | 원형, 선형, LED 게이지와 노브, 슬라이더, 스위치 입력이에요. | TsgcWinFormsRadialGauge, TsgcWinFormsLinearGauge, TsgcWinFormsKnobGauge | 예 |
| sgcPlanner | 하나의 데이터 모델 위에서 동작하는 WinForms 스케줄러, 간트 차트, 칸반 보드예요. | TsgcWinFormsScheduler, TsgcWinFormsGantt, TsgcWinFormsKanban | 예 |
| sgcDiagram | 도형 팔레트, 커넥터, 미니맵을 갖춘 다이어그램 에디터예요. | TsgcWinFormsDiagramView, TsgcWinFormsDiagramPalette | 예 |
| sgcMaps | 타일 레이어, 마커, 선을 갖춘 지도 컨트롤로, 타일을 백그라운드 스레드에서 불러와요. | SgcMapControl | 예 |
| sgcEditors | 날짜 선택기, 통화, 마스크, 조회, 토큰 편집기 같은 입력 컨트롤과 데이터 폼, 유효성 검사를 제공해요. | TsgcWinFormsDatePicker, TsgcWinFormsCurrencyEdit, TsgcWinFormsLookupEdit | 예 |
| sgcNavigation | 사이드바, 탭, 도킹 패널, 토스트, 알림 받은 편지함이에요. | TsgcWinFormsNavigationBar, TsgcWinFormsNavigationTabs, TsgcWinFormsDockManager | 예 |
| sgcToolbar | 도구 모음, 상태 표시줄, WinForms 리본이에요. | TsgcWinFormsToolbar, TsgcWinFormsStatusBar, TsgcWinFormsRibbon | 예 |
| sgcWizard | 다중 페이지 마법사와 스테퍼예요. | TsgcWinFormsWizard, TsgcWinFormsStepper | 예 |
| sgcPDF | 축소판, 확대/축소, 검색, 인쇄, 주석 도구를 갖춘 WinForms PDF 뷰어예요. | TsgcPDFViewerControl | 예 |
| sgcReports | 인쇄, PDF, 내보내기를 지원하는 보고서 디자이너와 보고서 미리보기예요. | TsgcWinFormsReportPreview, TsgcWinFormsReportDesigner | 예 |
| sgcRichEdit | 스타일, 목록, 표, 이미지, 링크를 갖춘 서식 있는 텍스트 편집기와 코드 편집기예요. | TsgcWinFormsRichEdit, TsgcWinFormsCodeEdit | Registered |
| sgcSpreadsheet | 수식 입력줄을 갖춘 Excel 스타일 WinForms 스프레드시트예요. | TsgcWinFormsSpreadsheet | Registered |
| sgcChat | Markdown 뷰어를 갖춘 AI 어시스턴트나 팀용 채팅 보기예요. | TsgcWinFormsChatView, TsgcWinFormsChatPanel, TsgcWinFormsMarkdownViewer | Registered |
정확한 패키지 이름은 .NET 다운로드 탭에 있고, 기능 매트릭스에서 Community 빌드에 포함된 내용을 확인할 수 있어요.
모든 sgcUI 컨트롤은 하나의 애플리케이션 테마로 그려져요. 프리셋이 색상과 모서리를 결정해요. Classic이 기본값이고 Fluent는 Windows 11의 모습을 제공해요.
sgcUIApplication.ThemePreset은 Theme이 utDefault인 모든 sgcUI 컨트롤을 라이트와 다크에서 Classic과 Fluent 사이로 전환하며, Windows 고대비가 우선해요.Application.SetColorMode로 다크로 설정된 폼이나 다크 Windows에서 시스템 모드로 설정된 폼은 sgcUI 컨트롤도 다크로 바뀌어요. .NET Framework 4.7.2와 .NET 8에서는 호스트 테마가 라이트예요.sgcUIApplication.ThemeFollow = TsgcUIThemeFollow.utfSystem은 사용자가 Windows 설정을 바꾸면 다시 시작하지 않고도 컨트롤을 라이트와 다크 사이로 전환해요.sgcUIApplyThemeToForm 또는 aApplyToForms를 true로 설정한 SetTheme은 폼과 그 표준 자식 컨트롤에 테마의 배경색과 글꼴 색을 적용해요.sgcUIApplication.AccentColor로 직접 지정하면 그 색을 사용해요.net8.0-windows WinForms 프로젝트를 만들고 nuget.org에서 sgcGrid와 sgcCharts의 무료 Community 패키지를 추가하세요. 이 프로그램은 그 패키지를 대상으로 그대로 빌드돼요.
dotnet new winforms -n ModernWinForms
cd ModernWinForms
dotnet add package esegece.sgcGrid.WinForms.Community
dotnet add package esegece.sgcCharts.WinForms.Community
using System;
using System.Drawing;
using System.Windows.Forms;
using esegece.sgcCharts;
using esegece.sgcGrid;
using esegece.sgcUICore;
namespace ModernWinForms
{
internal class MainForm : Form
{
private readonly TsgcWinFormsGrid FGrid = new TsgcWinFormsGrid();
private readonly TsgcWinFormsChart FView = new TsgcWinFormsChart();
private readonly TsgcChart FChart = new TsgcChart();
public MainForm()
{
Text = "Sales";
ClientSize = new Size(960, 540);
// the grid: field name, caption and data type
FGrid.Dock = DockStyle.Fill;
FGrid.Columns.Add("customer", "Customer");
FGrid.Columns.Add("region", "Region");
FGrid.Columns.Add("total", "Total", TsgcGridDataType.gdtFloat).DisplayFormat = "#,##0.00";
// one row per key, the values follow the column order
FGrid.Data.AppendRow("C001", "Aurora Logistics", "Iberia", 12840.5);
FGrid.Data.AppendRow("C002", "Cobalt Foods", "DACH", 9310.0);
// the chart: a model with two axes and a line series
TsgcChartAxis oBottom = FChart.Axes.Add();
oBottom.Name = "bottom";
oBottom.Position = TsgcChartAxisPosition.capBottom;
TsgcChartAxis oLeft = FChart.Axes.Add();
oLeft.Name = "left";
oLeft.Position = TsgcChartAxisPosition.capLeft;
TsgcChartSeries_Line oSeries = new TsgcChartSeries_Line();
oSeries.Chart = FChart;
oSeries.AxisX = "bottom";
oSeries.AxisY = "left";
for (int i = 0; i < 12; i++)
oSeries.AddXY(i, 200 + i * 15);
FView.Chart = FChart;
FView.Dock = DockStyle.Right;
FView.Width = 420;
Controls.Add(FGrid);
Controls.Add(FView);
}
}
internal static class Program
{
[STAThread]
private static void Main()
{
Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(false);
// Fluent colours and corners, light or dark as chosen in Windows
sgcUIApplication.ThemePreset = sgcUICore_Theme.CS_UI_THEME_FLUENT;
sgcUIApplication.ThemeFollow = TsgcUIThemeFollow.utfSystem;
MainForm oForm = new MainForm();
// the form, its standard controls and its title bar follow the theme
sgcUICore_Theme_WinForms.sgcUIApplyThemeToForm(oForm, sgcUIApplication.Theme);
Application.Run(oForm);
}
}
}
나중에 행을 업데이트하려면 어느 스레드에서든 키와 함께 FGrid.Data.UpdateRow를 호출하세요. BeginUpdate와 EndUpdate는 여러 변경을 한 번의 다시 그리기로 묶어요. 애플리케이션이 다크일 때 컨트롤 하나만 라이트로 유지하려면 Theme을 TsgcUITheme.utLight로 설정하세요. 도움말: .NET 패키지.
WinForms 컨트롤은 .NET Framework 4.7.2의 Visual Studio 디자이너에서 열리고, .NET 8 이상에서는 Visual Studio 2022 이상의 아웃 오브 프로세스 디자이너로 열려요.
WinForms NuGet 패키지는 컨트롤을 도구 상자에 추가하며, 각각 고유한 아이콘을 갖고 "sgcUI Grid"나 "sgcUI Planner"처럼 제품마다 하나의 카테고리 아래에 놓여요.
스마트 태그로 테마, 데이터 소스, 주요 옵션을 설정해요. 차트에서는 꺾은선, 막대, 캔들스틱, 원형 시리즈를 한 번의 실행 취소 단계로 추가해요.
컬렉션 편집기에서 그리드 열, 차트 시리즈, 피벗 필드를 편집하면 디자이너가 InitializeComponent에 저장해요.
비어 있는 그리드, 피벗, 차트, 플래너, 다이어그램은 샘플 행, 샘플 피벗, 샘플 선, 샘플 작업, 샘플 흐름을 보여 주므로 바인딩하기 전에 레이아웃을 확인할 수 있어요.
속성 창이 바인딩된 데이터의 테이블과 멤버를 나열하므로 DataMember에 테이블이나 Customers.CustomerOrders 같은 관계를 지정할 수 있어요.
WinForms 도구 상자 컴포넌트 69개 전체의 스마트 태그를 디자인 서피스에서 테스트해요: 모든 속성, 컬렉션 편집기, 데이터 소스 목록, 작업, 동사가 대상이에요.
.NET Framework에서는 sgcUI 스마트 태그가 Visual Studio 안에서 실행되는 기본 디자이너에 표시돼요. 도움말: WinForms DataSource와 DataMember.
sgcUICore 기반 제품의 WinForms 패키지는 이 네 가지 프레임워크를 대상으로 해요.
| 대상 프레임워크 | .NET | sgcUI 컨트롤의 다크 모드 |
|---|---|---|
net472 | .NET Framework 4.7.2 | utfSystem으로 Windows를 따르거나 코드에서 테마를 설정해요 |
net8.0-windows | .NET 8 | utfSystem으로 Windows를 따르거나 코드에서 테마를 설정해요 |
net9.0-windows | .NET 9 | 기본적으로 Application.SetColorMode를 따라요 |
net10.0-windows | .NET 10 | 기본적으로 Application.SetColorMode를 따라요 |
sgcMaps, sgcPDF, sgcReports는 자체 대상을 유지해요. sgcMaps WinForms 컨트롤은 .NET 8 이상이 필요해요. 각 제품 페이지에 정확한 대상이 나와 있어요. Linux와 macOS에서도 같은 컨트롤이 필요하세요? WinForms와 WPF에서 Avalonia로를 읽고 Avalonia 컨트롤을 확인해 보세요.
nuget.org의 Community 패키지로 시작한 다음, 모든 기능과 전체 C# 소스 코드, 상용 라이선스가 포함된 Registered 패키지로 옮겨 가세요. 가격은 sgcUI .NET 가격에서 확인하세요.
sgcGrid, sgcNavigation, sgcToolbar, sgcEditors를 개발자당 €380부터 제공하며, WinForms, WPF, Avalonia용 전체 C# 소스 코드와 무료 바이너리 재배포가 포함돼요.
sgcUI .NET Standard 구매 →Delphi와 C++Builder용도 만드시나요? 같은 컴포넌트가 Delphi VCL 컴포넌트와 FireMonkey 컴포넌트로도 있어요.
sgcUI WinForms 패키지를 추가하고 그리드, 차트, 대시보드 타일, 리본, 내비게이션 바 같은 컨트롤을 폼에 배치하세요. 그런 다음 sgcUIApplication.ThemePreset = sgcUICore_Theme.CS_UI_THEME_FLUENT로 Fluent 프리셋을 선택하세요. sgcUI 컨트롤은 Windows 11의 색상, 모서리, 강조 색을 사용하고, sgcUIApplyThemeToForm은 폼과 표준 컨트롤에 어울리는 배경색과 글꼴 색을 적용하며 테마가 다크일 때는 다크 제목 표시줄도 적용해요.
네. 모든 sgcUI 컨트롤에는 라이트와 다크 테마가 있어요. .NET 9 이상에서는 Theme이 utDefault인 컨트롤이 코드 없이 기본적으로 Application.SetColorMode로 설정한 색상 모드를 따라요. 어떤 대상에서든 sgcUIApplication.ThemeFollow = TsgcUIThemeFollow.utfSystem은 애플리케이션이 실행되는 동안 Windows의 라이트 또는 다크 설정을 따르고, sgcUIApplication.SetTheme(TsgcUITheme.utDark)는 애플리케이션 전체를 다크로 고정해요.
sgcUICore 기반 제품의 WinForms 패키지는 net472, net8.0-windows, net9.0-windows, net10.0-windows를 대상으로 하므로 .NET Framework 4.7.2와 .NET 8, 9, 10에서 실행돼요. sgcMaps, sgcPDF, sgcReports는 제품 페이지에 나온 자체 대상을 유지해요. Visual Studio 디자이너는 .NET Framework 4.7.2와 .NET 8 이상에서 동작해요.
네. Community 빌드는 패키지 ID에 .Community 접미사가 붙으며, 예를 들어 esegece.sgcGrid.WinForms.Community이고 제품 14종에 대해 nuget.org에 게시돼요. 개인과 연간 총매출 100만 유로 미만이며 개발자가 5명 이하인 조직에 무료예요. sgcRichEdit, sgcSpreadsheet, sgcChat은 Registered 전용이며, 각 Community 빌드에서 빠진 내용은 기능 매트릭스에서 확인할 수 있어요.
네. 패키지는 컨트롤을 아이콘과 함께 Visual Studio 도구 상자에 추가하고, Windows Forms 디자이너는 스마트 태그, 컬렉션 편집기, 바인딩된 데이터의 멤버를 보여 줘요. .NET 8 이상에서는 디자이너 어셈블리가 Visual Studio 2022 이상의 아웃 오브 프로세스 디자이너에서 로드돼요.
네. WinForms, WPF, Avalonia 컨트롤은 제품마다 하나의 모델을 공유하고, 호스트 접두사를 제외하면 같은 클래스 이름을 유지해요. 예를 들면 TsgcWinFormsGrid와 TsgcAvaloniaGrid예요. WinForms와 WPF에서 Avalonia로 키트에서 호스트 유형과 알려진 차이점을 확인할 수 있어요.
관련 항목: WPF DataGrid, Avalonia 컨트롤, .NET 보고 도구, sgcUI 제품군.