适用于 C# 和 XAML 的 WPF UI 控件
为您的 WPF 应用提供图表、日期选择器、向导、功能区、停靠和 PDF 查看器,支持 Fluent 浅色和深色。
为您的 WPF 应用提供图表、日期选择器、向导、功能区、停靠和 PDF 查看器,支持 Fluent 浅色和深色。
每个 sgcUI 控件都通过 sgcUICore(共享的画布和主题运行时)绘制,因此图表、向导或规划器在 WPF 窗口中的外观与套件其他宿主中的完全相同。
WPF 上的 Realtime 演示:在线状态、动态流、通知收件箱和实时日志网格。
sgcNavigation →
Fluent 深色预设:选项卡、网格、KPI 卡片、图表、编辑器、仪表和看板。
Fluent 与深色模式 →
深色主题下带步骤条的四步向导。
sgcWizard →
周视图中的日程表,全天事件和重叠预约并排显示。
sgcPlanner →适用于 .NET 的 sgcUI 是托管的 C# 移植版,类名与 Delphi 套件相同。WPF 控件带有 TsgcWpf 前缀,每个产品一个 NuGet 包,并共用 XAML 命名空间 https://www.esegece.com/sgcui。
sgcCharts 的 TsgcWpfChart 使用二十一种系列类型绘制 TsgcChart 模型,从折线、柱状和 K 线到饼图、雷达图和树状图。系列在 XAML 中声明并绑定到视图模型的集合,所有版本均支持,且图表可安全地由后台线程提供数据。SaveToPNG 和 SaveToSVG 可导出用户所见的内容。查看 XAML 示例。
sgcEditors 提供 TsgcWpfDatePicker、TsgcWpfTimePicker、TsgcWpfDateTimePicker 和 TsgcWpfMonthCalendar,以及掩码、货币、查找和令牌编辑框。日历支持真实的预订规则,编辑器保留原生文本输入,支持 IME 和剪贴板,窗体验证是每个版本的一部分,包括免费的 Community 包。
sgcWizard 的 TsgcWpfWizard 在 XAML 中每一步对应一个 TsgcWpfWizardPage 子元素,每个页面的 Caption 和 Description 会成为步骤条中显示的步骤。页面可以在其数据有效之前拒绝进入下一步,TsgcWpfStepper 可单独显示进度。所有功能都包含在免费的 .NET Community 包中。
sgcDashboard 的 TsgcWpfDashboard 将磁贴排列在 12 列网格上,网格随窗口大小流动,并随显示器 DPI 缩放。磁贴可容纳 KPI 卡片(TsgcWpfKPICard)、图表、网格、仪表、地图和透视表,用户可拖动并调整其大小,形成您可保存和恢复的布局。
sgcNavigation 的 TsgcWpfToastManager 在窗口一角堆叠简短卡片,每张卡片带有严重程度图标、标题、最多三行文本和最多两个操作按钮,并在倒计时后关闭。TsgcWpfNotificationInbox 列出带未读计数的通知,TsgcWpfNotificationPrefsEditor 让用户按类别选择渠道。Delphi 方面的说明见 Delphi 通知。
sgcToolbar 提供带选项卡、图库、KeyTips 和后台视图的 TsgcWpfRibbon,以及用于功能区窗体的 TsgcWpfRibbonWindow。TsgcWpfToolbar 和 TsgcWpfStatusBar 完善了外壳;状态栏面板可从任意线程更新,命令绑定到 ICommand 并在 XAML 中声明。
sgcPDF 的 esegece.sgcPDF.Wpf 包添加了 TsgcWpfPDFViewer、TsgcWpfPDFThumbnailView 和 TsgcWpfPDFOutlineView,构成完整的阅读窗格,另有 TsgcWpfPDFBarcodeControl 条形码控件。它们背后是适用于 .NET 的 sgcPDF 库,该库同样可以创建、编辑和签署文档。
sgcNavigation 的 TsgcWpfDockManager 将窗口变成 IDE 风格的工作区:两侧的工具面板、中间的选项卡文档、停靠引导、自动隐藏和浮动窗口。它基于与 WinForms、Avalonia 和 Delphi 停靠管理器相同的 TsgcDockManagerModel 运行,因此 JSON 布局是共享的。完整演示请参阅 Avalonia 上的停靠。
sgcMaps 的 TsgcWpfMap 自行绘制地图,无需浏览器控件和 JavaScript。它显示标记、路线和离线瓦片,同一引擎也可在控制台或服务中将地图渲染为 PNG 文件。
sgcPlanner 以三种方式展示同一份计划:TsgcWpfScheduler 为日历,TsgcWpfGantt 为甘特图,TsgcWpfKanban 为看板,全部通过 ItemsSource 绑定到一个数据对象。将卡片移到 Done,甘特条和日历随之更新。计划可以 JSON、iCalendar 和 Microsoft Project XML 格式加载和保存。
sgcRichEdit 的 TsgcWpfRichEdit 可编辑带样式、列表、表格、图片和链接的文档。它读写 JSON、HTML、Markdown 和 RTF,并基于与 WinForms 和 Avalonia 编辑器共享的同一个文档模型导出 DOCX、PDF 和 PNG 页面。
sgcGauges 提供十六种仪表类型,其中十二种包含在 .NET Community 包中:径向、线性、数字、LED、水箱等,包括 TsgcWpfRadialGauge、TsgcWpfLinearGauge 和 TsgcWpfKnobGauge。旋钮、滑块和开关等输入仪表支持鼠标、滚轮和键盘,每个仪表都可无窗口渲染为 PNG 和 SVG。
sgcSpreadsheet 的 TsgcWpfSpreadsheet 像 Excel 一样输入值和公式,并通过可溢出的动态数组计算 211 个工作表函数。它支持多个带已定义名称和冻结窗格的工作表,可基于单元格区域绘制图表,并加载和保存 XLSX 文件。TsgcWpfSpreadsheetFormulaBar 提供公式栏。
在找网格?TsgcWpfGrid 有单独的页面:带实时更新、分组、筛选和 Excel 导出的 WPF DataGrid 控件。数据透视表(TsgcWpfPivotGrid)、图表绘制(TsgcWpfDiagramView)、报表预览和聊天视图完善了整个套件,请参阅下表。
sgcUI 控件以浅色、深色或高对比度自行绘制,并通过主题预设设置其颜色、圆角和线宽。Fluent 是三个内置预设之一。
Theme 属性。保持默认值时,控件会跟随应用程序主题,您可以用 sgcUIApplication.SetTheme 固定该主题。Application.ThemeMode,因此 Light、Dark 和 System 都能切换它们,并且当 Windows 的主题或强调色变化时会重绘。在 .NET Framework 4.7.2 和 .NET 8 上,宿主报告为浅色,因此需要深色时请固定主题为深色。sgcUICore_Theme_Wpf 的 sgcUIApplyThemeToWindow 会设置窗口及其子控件的背景色和字体颜色,使窗口的其余部分与主题一致。将 sgcCharts 的 Community 包添加到 net8.0-windows WPF 项目中,在 XAML 中声明图表和一个系列,并将该系列绑定到 ObservableCollection。
dotnet add package esegece.sgcCharts.Wpf.Community<Window x:Class="LiveChart.MainWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:sgc="https://www.esegece.com/sgcui"
Title="Live chart" Width="900" Height="480">
<sgc:TsgcWpfChart Theme="utDark">
<!-- one line series bound to the view model, X and Y read from each item -->
<sgc:TsgcWpfChartSeries ItemsSource="{Binding Samples}" SeriesKind="cskLine"
Title="Temperature" XMember="Index" YMember="Value" />
</sgc:TsgcWpfChart>
</Window>
using System;
using System.Collections.ObjectModel;
using System.Windows;
using System.Windows.Threading;
namespace LiveChart
{
public class TSample
{
public int Index { get; set; }
public double Value { get; set; }
}
public partial class MainWindow : Window
{
private readonly DispatcherTimer FTimer = new DispatcherTimer();
private readonly Random FRandom = new Random();
private int FIndex;
public ObservableCollection<TSample> Samples { get; } = new ObservableCollection<TSample>();
public MainWindow()
{
InitializeComponent();
DataContext = this;
FTimer.Interval = TimeSpan.FromMilliseconds(250);
FTimer.Tick += (sender, e) => AddSample();
FTimer.Start();
}
private void AddSample()
{
// WPF collection views take adds and removes on the UI thread
Samples.Add(new TSample { Index = FIndex++, Value = 20 + FRandom.NextDouble() * 5 });
if (Samples.Count > 200)
Samples.RemoveAt(0);
}
}
}
集合的每次添加或移除都会更新该系列,图表每秒最多重绘 Chart.MaxFPS 次。实现了 INotifyPropertyChanged 的项也可以从工作线程更改其值。同一个 xmlns:sgc 声明可在同一文件中提供每个 sgcUI 产品的控件。请参阅 sgcUI 快速入门。
WPF 包面向 net472、net8.0-windows、net9.0-windows 和 net10.0-windows。每个包都将其核心包和渲染包作为依赖项一并引入,因此一个包引用就足够了。一个项目引用 Community 包或 Registered 包二者之一,不能同时引用。
| 产品 | 主要 WPF 控件 | 免费 Community 包 | Registered 包 |
|---|---|---|---|
| sgcGrid | TsgcWpfGrid, TsgcWpfFilterBuilder | esegece.sgcGrid.Wpf.Community | esegece.sgcGrid.Wpf |
| sgcCharts | TsgcWpfChart, TsgcWpfSparkline | esegece.sgcCharts.Wpf.Community | esegece.sgcCharts.Wpf |
| sgcDashboard | TsgcWpfDashboard, TsgcWpfKPICard | esegece.sgcDashboard.Wpf.Community | esegece.sgcDashboard.Wpf |
| sgcGauges | TsgcWpfRadialGauge, TsgcWpfLinearGauge | esegece.sgcGauges.Wpf.Community | esegece.sgcGauges.Wpf |
| sgcEditors | TsgcWpfDatePicker, TsgcWpfLookupEdit | esegece.sgcEditors.Wpf.Community | esegece.sgcEditors.Wpf |
| sgcWizard | TsgcWpfWizard, TsgcWpfStepper | esegece.sgcWizard.Wpf.Community | esegece.sgcWizard.Wpf |
| sgcNavigation | TsgcWpfNavigationBar, TsgcWpfDockManager, TsgcWpfToastManager | esegece.sgcNavigation.Wpf.Community | esegece.sgcNavigation.Wpf |
| sgcToolbar | TsgcWpfRibbon, TsgcWpfToolbar, TsgcWpfStatusBar | esegece.sgcToolbar.Wpf.Community | esegece.sgcToolbar.Wpf |
| sgcPlanner | TsgcWpfScheduler, TsgcWpfGantt, TsgcWpfKanban | esegece.sgcPlanner.Wpf.Community | esegece.sgcPlanner.Wpf |
| sgcMaps | TsgcWpfMap | esegece.sgcMaps.Wpf.Community | esegece.sgcMaps.Wpf |
| sgcPivotGrid | TsgcWpfPivotGrid, TsgcWpfPivotFieldList | esegece.sgcPivotGrid.Wpf.Community | esegece.sgcPivotGrid.Wpf |
| sgcDiagram | TsgcWpfDiagramView, TsgcWpfDiagramPalette | esegece.sgcDiagram.Wpf.Community | esegece.sgcDiagram.Wpf |
| sgcPDF | TsgcWpfPDFViewer, TsgcWpfPDFThumbnailView | esegece.sgcPDF.Wpf.Community | esegece.sgcPDF.Wpf |
| sgcReports | TsgcWpfReportPreview, TsgcWpfReportDesigner | esegece.sgcReports.Wpf.Community | esegece.sgcReports.Wpf |
| sgcRichEdit | TsgcWpfRichEdit | – | esegece.sgcRichEdit.Wpf |
| sgcSpreadsheet | TsgcWpfSpreadsheet, TsgcWpfSpreadsheetFormulaBar | – | esegece.sgcSpreadsheet.Wpf |
| sgcChat | TsgcWpfChatView, TsgcWpfChatPanel | – | esegece.sgcChat.Wpf |
Community 包位于 nuget.org,对个人以及年总收入低于 100 万欧元且开发者不超过 5 人的组织免费。Registered 包来自您的账户,包含全部功能和完整的 C# 源代码。sgcUI .NET Standard 涵盖 sgcGrid、sgcNavigation、sgcToolbar 和 sgcEditors,起价 €380,Professional 增加 sgcCharts、sgcDashboard 和 sgcGauges,Enterprise 包含所有产品。请参阅下载和 .NET 价格。
有。sgcEditors 在 esegece.sgcEditors.Wpf 包中提供 TsgcWpfDatePicker、TsgcWpfTimePicker、TsgcWpfDateTimePicker 和 TsgcWpfMonthCalendar。它们由 sgcUICore 以浅色、深色和高对比度绘制,若选择 Fluent 预设也支持,并保留支持 IME 和剪贴板的原生文本输入。免费的 esegece.sgcEditors.Wpf.Community 包包含它们,sgcUI .NET Standard 也包含 sgcEditors。
将 esegece.sgcWizard.Wpf 包或其 Community 版本添加到 WPF 项目。在 XAML 中,声明一个 TsgcWpfWizard,每一步对应一个 TsgcWpfWizardPage,并设置每个页面的 Caption 和 Description。在代码隐藏中分配向导事件:它们是委托,而不是 WPF 路由事件,因此不能作为 XAML 特性设置。所有向导功能都包含在免费的 Community 包中。
sgcCharts 的 TsgcWpfChart。它绘制到持久位图中,按 Chart.MaxFPS 节流,并且可安全地由后台线程提供数据。将 TsgcWpfChartSeries 绑定到 ObservableCollection,每次添加或移除都会更新该系列;在 WPF 中,这些集合更改在 UI 线程上进行,而项属性的更改可来自任意线程。上面的示例每秒添加四个点。
支持。每个 sgcUI 控件都以浅色、深色或高对比度绘制,并提供 Classic、Fluent 或 ISA101 预设。在 .NET 9 及更高版本中,控件会跟随 Application.ThemeMode,并在它或 Windows 主题变化时重绘。在 .NET Framework 4.7.2 和 .NET 8 上,WPF 宿主报告为浅色,因此您可以通过控件的 Theme 属性选择深色,或用 sgcUIApplication.SetTheme 为整个应用程序选择深色。
有,涵盖十四个产品:sgcGrid、sgcCharts、sgcDashboard、sgcGauges、sgcEditors、sgcWizard、sgcNavigation、sgcToolbar、sgcPlanner、sgcMaps、sgcPivotGrid、sgcDiagram、sgcPDF 和 sgcReports 在 nuget.org 上各有一个 .Wpf.Community 包。它们对个人以及年总收入低于 100 万欧元且开发者不超过 5 人的组织免费。sgcRichEdit、sgcSpreadsheet 和 sgcChat 仅提供 Registered 包。
WPF 包面向 .NET Framework 4.7.2(net472)以及 .NET 8、9 和 10(net8.0-windows、net9.0-windows、net10.0-windows)。相同的产品还提供类名相同的 WinForms 和 Avalonia 12 控件,因此您为 WPF 编写的模型或视图模型可以沿用;请参阅 Avalonia 控件和从 WinForms 和 WPF 迁移到 Avalonia 套件。
也适用于 Delphi 和 C++Builder:Delphi VCL 组件和 Delphi FireMonkey 组件,名称和模型相同。相关内容:WPF DataGrid 和 sgcUI 套件。