sgcUI の WinForms コントロール
C# 向けのモダンな WinForms コントロール。グリッド、グラフ、リボン、スケジューラを、Windows に追従する Fluent のライトとダークのテーマで提供します。
C# 向けのモダンな WinForms コントロール。グリッド、グラフ、リボン、スケジューラを、Windows に追従する Fluent のライトとダークのテーマで提供します。
Altamira ERP は、Delphi、C++Builder、.NET WinForms 向けの sgcUI スイートデモです。ダッシュボード、顧客、請求書、計画、ワークフロー、レポート、分析を 1 つのウィンドウにまとめています。以下の 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 スレッドで、1 秒あたり最大 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 グラフ: 1 つのグラフモデルで、折れ線、棒、ローソク足、円などの系列を扱い、PNG と SVG の出力とスパークラインに対応します。 | TsgcWinFormsChart, TsgcWinFormsSparkline | あり |
| sgcDashboard | タイルと KPI カードのダッシュボード。グラフ、ゲージ、グリッド、ピボット、地図のタイルに対応します。 | TsgcWinFormsDashboard, TsgcWinFormsDashboardTile, TsgcWinFormsKPICard | あり |
| sgcGauges | ラジアル、リニア、LED のゲージに加え、ノブ、スライダー、スイッチの入力。 | TsgcWinFormsRadialGauge, TsgcWinFormsLinearGauge, TsgcWinFormsKnobGauge | あり |
| sgcPlanner | 1 つのデータモデルで動作する 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 コントロールは、1 つのアプリケーションテーマで描画されます。プリセットが配色と角を決めます。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 で独自に設定しない限り、コントロールは Windows のアクセントカラーで描画されます。ライトでは暗めの色合い、ダークでは明るめの色合いになります。ヘルプ: アプリケーションテーマとテーマプリセット。
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 は、多数の変更を 1 回の再描画にまとめます。アプリケーションがダークのときに 1 つのコントロールだけライトにしておくには、その Theme を TsgcUITheme.utLight に設定します。ヘルプ: .NET パッケージ。
WinForms コントロールは、.NET Framework 4.7.2 では Visual Studio のデザイナーで開き、.NET 8 以降では Visual Studio 2022 以降のアウトプロセスデザイナーで開きます。
WinForms NuGet パッケージは、「sgcUI Grid」や「sgcUI Planner」のように製品ごとに 1 つのカテゴリで、それぞれ専用のアイコン付きでコントロールをツールボックスに追加します。
スマートタグで、テーマ、データソース、主なオプションを設定できます。グラフでは、折れ線、棒、ローソク足、円の系列を、元に戻す 1 ステップとして追加できます。
グリッドの列、グラフの系列、ピボットのフィールドをコレクションエディターで編集すると、デザイナーがそれらを InitializeComponent に保存します。
空のグリッド、ピボット、グラフ、プランナー、ダイアグラムには、サンプルの行、ピボット、線、タスク、フローが表示されるため、バインドする前にレイアウトを確認できます。
プロパティウィンドウには、バインドしたデータのテーブルとメンバーが一覧表示されるため、DataMember にテーブルや Customers.CustomerOrders のようなリレーションを指定できます。
69 個すべての WinForms ツールボックスコンポーネントのスマートタグを、デザインサーフェスでテストしています。すべてのプロパティ、コレクションエディター、データソースリスト、アクション、動詞が対象です。
.NET Framework では、sgcUI のスマートタグは Visual Studio 内で動作する既定のデザイナーに表示されます。ヘルプ: WinForms DataSource と DataMember。
sgcUICore を基盤とする製品の WinForms パッケージは、これら 4 つのフレームワークを対象としています。
| ターゲットフレームワーク | .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 のコントロールは、製品ごとに 1 つのモデルを共有し、ホストのプレフィックスを除いて同じクラス名を維持しています。たとえば TsgcWinFormsGrid と TsgcAvaloniaGrid です。WinForms と WPF から Avalonia へのキットで、ホストの型と既知の違いを確認できます。