来自 sgcUI 的 Avalonia 控件
适用于 Avalonia 12 的原生 Avalonia UI 控件和组件,一套 C# 和 XAML 代码适用于 Windows、Linux 和 macOS。
适用于 Avalonia 12 的原生 Avalonia UI 控件和组件,一套 C# 和 XAML 代码适用于 Windows、Linux 和 macOS。
这些控件各有自己的页面,介绍功能、编译后的 AXAML 和 C# 代码,以及要添加的 NuGet 包。
sgcGrid 的 TsgcAvaloniaGrid:在 AXAML 中定义列、编译绑定、来自任意线程的实时行、带合计的分组、筛选、虚拟模式和 Excel 导出。
sgcPivotGrid 的 TsgcAvaloniaPivotGrid:拖放字段列表、XAML 中的 ItemsSource 绑定、Top N、值显示方式、数据透视图和 XLSX 导出。
sgcNavigation 的 TsgcAvaloniaDockManager:停靠的工具面板、选项卡文档、停靠引导、自动隐藏、浮动窗口和 JSON 布局。
网格、数据透视网格、图表、仪表板、仪表、规划器、图表绘制、地图、PDF 查看器和报表,以及围绕它们的编辑器、导航、工具栏和向导。每个产品都使用共享的 sgcUICore 运行时绘制,因此这些控件看起来就像一个统一的应用程序。
项目组合总览:KPI 卡片、仪表、气泡图、地图和树状图。
sgcDashboard →
交易台:实时自选股、带指标的 K 线、行业树状图和风险仪表。
sgcCharts →
与数据透视表关联的数据透视图,附带按区域和季度显示的热力图。
Avalonia 数据透视网格 →
同样的任务呈现在看板、甘特图和日程表上。
Avalonia 日程表 →
工具面板、选项卡文档、自动隐藏和停靠引导。
Avalonia 停靠 →
带工艺流程、OEE 卡片、指示板和仪表的操作员界面。
sgcGauges →这些截图来自 sgcUI 套件演示。
Avalonia 控件带有 TsgcAvalonia 前缀,每个产品一个 NuGet 包。每个产品可单独购买,也可包含在 sgcUI .NET 版本中。
| 产品 | 为 Avalonia 应用带来什么 | 主要 Avalonia 控件 | 免费 Community 包 |
|---|---|---|---|
| sgcGrid | 实时数据网格,支持分组、汇总、筛选、虚拟模式和 Excel 导出。请参阅 Avalonia DataGrid。 | TsgcAvaloniaGrid, TsgcAvaloniaFilterBuilder | esegece.sgcGrid.Avalonia.Community |
| sgcPivotGrid | 数据透视表网格,带拖放字段列表和数据透视图。请参阅 Avalonia 数据透视网格。 | TsgcAvaloniaPivotGrid, TsgcAvaloniaPivotFieldList | esegece.sgcPivotGrid.Avalonia.Community |
| sgcCharts | 折线、面积、柱状、散点、K 线、OHLC、饼图、雷达图、漏斗图和树状图系列,在 XAML 中声明并绑定到集合。 | TsgcAvaloniaChart, TsgcAvaloniaSparkline | esegece.sgcCharts.Avalonia.Community |
| sgcDashboard | 带磁贴和 KPI 卡片的仪表板,磁贴可承载图表、仪表、网格、透视表和地图。 | TsgcAvaloniaDashboard, TsgcAvaloniaDashboardTile, TsgcAvaloniaKPICard | esegece.sgcDashboard.Avalonia.Community |
| sgcGauges | 径向、旋钮、水箱、滑块、LED、数字和 VU 表仪表。 | TsgcAvaloniaRadialGauge, TsgcAvaloniaTankGauge, TsgcAvaloniaLEDGauge | esegece.sgcGauges.Avalonia.Community |
| sgcPlanner | 日程表、甘特图和看板共用一个数据模型。请参阅 Avalonia 日程表。 | TsgcAvaloniaScheduler, TsgcAvaloniaGantt, TsgcAvaloniaKanban | esegece.sgcPlanner.Avalonia.Community |
| sgcDiagram | 由用户绘制的流程图、组织结构图和节点图,带面板和小地图。 | TsgcAvaloniaDiagramView, TsgcAvaloniaDiagramPalette | esegece.sgcDiagram.Avalonia.Community |
| sgcMaps | Avalonia 地图控件,支持 ItemsSource 和 SelectedItem、打印、打印预览和 PDF 导出。 | TsgcAvaloniaMap | esegece.sgcMaps.Avalonia.Community |
| sgcPDF | Avalonia PDF 查看器,带缩略图和大纲视图、签名板和条形码控件。 | TsgcAvaloniaPDFViewer, TsgcAvaloniaPDFThumbnailView | esegece.sgcPDF.Avalonia.Community |
| sgcReports | 适用于 Avalonia 窗口的报表预览和报表设计器。 | TsgcAvaloniaReportPreview, TsgcAvaloniaReportDesigner | esegece.sgcReports.Avalonia.Community |
| sgcEditors | 表单输入控件,从日期和时间选择器、范围滑块到查找、掩码、货币和令牌编辑框,以及数据表单。 | TsgcAvaloniaDatePicker, TsgcAvaloniaLookupEdit, TsgcAvaloniaDataForm | esegece.sgcEditors.Avalonia.Community |
| sgcNavigation | 导航栏、选项卡、选项卡式窗口、弹出提示和通知收件箱,以及 Avalonia 停靠管理器。 | TsgcAvaloniaNavigationBar, TsgcAvaloniaDockManager, TsgcAvaloniaToastManager | esegece.sgcNavigation.Avalonia.Community |
| sgcToolbar | 工具栏、状态栏和功能区,带功能区窗口。 | TsgcAvaloniaToolbar, TsgcAvaloniaStatusBar, TsgcAvaloniaRibbon | esegece.sgcToolbar.Avalonia.Community |
| sgcWizard | 多页向导和独立步骤条。 | TsgcAvaloniaWizard, TsgcAvaloniaStepper | esegece.sgcWizard.Avalonia.Community |
| sgcRichEdit | 富文本文档编辑器和代码编辑器。 | TsgcAvaloniaRichEdit, TsgcAvaloniaCodeEdit | 仅 Registered |
| sgcSpreadsheet | 带公式栏的 Excel 风格电子表格。 | TsgcAvaloniaSpreadsheet, TsgcAvaloniaSpreadsheetFormulaBar | 仅 Registered |
| sgcChat | AI 助手和团队聊天控件,带 Markdown 查看器。 | TsgcAvaloniaChatView, TsgcAvaloniaChatPanel, TsgcAvaloniaMarkdownViewer | 仅 Registered |
每个产品的 Registered 包去掉 .Community 后缀,例如 esegece.sgcGrid.Avalonia。完整列表见 .NET 下载,所有功能见功能矩阵。
Avalonia 包基于 Avalonia 12 构建:需要 Avalonia 12.0 或更高版本,已使用 12.1.4 测试,面向 net8.0、net9.0 和 net10.0。您在 Windows 上构建的窗口可以在 Linux 和 macOS 上运行。
xmlns:sgc="https://www.esegece.com/sgcui" 映射每个 sgcUI 产品的控件。列、字段、系列和磁贴在控件元素内部声明。
ItemsSource 接受任意 IEnumerable,例如 ObservableCollection。样式化属性支持绑定和样式,带 x:DataType 的编译绑定也照常工作。
添加、移除和移动只更新相关的行,INotifyPropertyChanged 会重绘变化的值,在工作线程上触发的更改会在 UI 线程上应用。
空的 sgcGrid、sgcPivotGrid、sgcCharts、sgcPlanner 或 sgcDiagram 会在 Avalonia 预览器中显示示例行、示例透视表、示例折线、示例任务或示例流程,因此可以在绑定数据之前检查布局。
TsgcAvaloniaValidator 会检查窗体上的 sgcEditors 控件以及标准的编辑框、组合框、复选框和日期控件,而 Smart Paste 可根据粘贴的文本(例如一段地址)填充表单。
TsgcAvaloniaAIQueryBar 可将一个自然语言问题转换为网格上的筛选、排序和高亮,并采用宿主的浅色或深色主题。
sgcUI 控件的颜色取自您的 Avalonia 应用程序,因此它们可以与 Fluent 控件并排放置,无需单独的皮肤。
Theme 为 utDefault 的控件会跟随 Avalonia 的 ActualThemeVariant 及平台强调色,并在应用运行时切换。此功能默认开启。
在 Classic 以外的预设下,当 ThemeFollow 为 utfHost 时,带 FluentTheme 的 Avalonia 12 会为控件提供背景、边框、文本和填充。
sgcUIApplication.SetTheme 会为整个应用程序固定一个主题,将 Theme 设为 utLight 或 utDark 则固定单个控件。
两个 sgcUI 产品共用一个 XAML 命名空间,绑定到同一个视图模型,使用 FluentTheme 和 Fluent 预设。该示例基于 nuget.org 上的 Community 包即可编译。
从带有 Avalonia 12 的 Avalonia.Desktop 和 Avalonia.Themes.Fluent 包的 net8.0、net9.0 或 net10.0 Avalonia 桌面项目开始,然后为每个 sgcUI 产品添加一个包:
dotnet add package esegece.sgcGrid.Avalonia.Community
dotnet add package esegece.sgcCharts.Avalonia.Community去掉 .Community 后缀的 Registered 包来自您的账户,而不是 nuget.org。每个产品引用二者之一,不能同时引用。
<Window xmlns="https://github.com/avaloniaui"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:SalesApp"
xmlns:sgc="https://www.esegece.com/sgcui"
x:Class="SalesApp.SalesWindow"
x:DataType="local:SalesViewModel"
Title="Sales" Width="1000" Height="480">
<Window.DataContext>
<local:SalesViewModel />
</Window.DataContext>
<Grid ColumnDefinitions="*,*">
<sgc:TsgcAvaloniaGrid ItemsSource="{Binding Sales}" ShowFooter="True">
<sgc:TsgcAvaloniaGridColumn FieldName="Region" Width="160" />
<sgc:TsgcAvaloniaGridColumn FieldName="Amount" DataType="gdtCurrency" DisplayFormat="#,##0.00"
SummaryType="gsuSum" />
</sgc:TsgcAvaloniaGrid>
<sgc:TsgcAvaloniaChart Grid.Column="1">
<sgc:TsgcAvaloniaChartSeries ItemsSource="{Binding Sales}" SeriesKind="cskBar" Title="Sales"
LabelMember="Region" YMember="Amount" />
</sgc:TsgcAvaloniaChart>
</Grid>
</Window>网格显示各区域并在页脚显示合计,图表则基于同一个集合为每个区域绘制一根柱。枚举值使用值名称,例如 gdtCurrency、gsuSum 或 cskBar。
using System;
using System.Collections.ObjectModel;
using Avalonia;
using Avalonia.Controls;
using Avalonia.Controls.ApplicationLifetimes;
using Avalonia.Styling;
using Avalonia.Themes.Fluent;
using esegece.sgcUICore;
namespace SalesApp
{
public class TSale
{
public string Region { get; set; }
public decimal Amount { get; set; }
}
public class SalesViewModel
{
public ObservableCollection<TSale> Sales { get; } = new ObservableCollection<TSale>
{
new TSale { Region = "North", Amount = 12500m },
new TSale { Region = "South", Amount = 9800m },
new TSale { Region = "East", Amount = 7400m },
new TSale { Region = "West", Amount = 11200m }
};
}
public partial class SalesWindow : Window
{
public SalesWindow()
{
InitializeComponent();
}
}
public class App : Application
{
public override void Initialize()
{
Styles.Add(new FluentTheme());
// Default follows the operating system between light and dark
RequestedThemeVariant = ThemeVariant.Default;
// Fluent colours and corners for every sgcUI control
sgcUIApplication.ThemePreset = sgcUICore_Theme.CS_UI_THEME_FLUENT;
}
public override void OnFrameworkInitializationCompleted()
{
if (ApplicationLifetime is IClassicDesktopStyleApplicationLifetime oDesktop)
oDesktop.MainWindow = new SalesWindow();
base.OnFrameworkInitializationCompleted();
}
}
internal static class Program
{
[STAThread]
private static void Main(string[] args)
{
AppBuilder.Configure<App>().UsePlatformDetect().StartWithClassicDesktopLifetime(args);
}
}
}每个产品在 sgcUI .NET 帮助中都有 Avalonia 快速入门,所有产品共用的绑定规则见 .NET 中的数据绑定。
Registered .NET 版本和包包含适用于 WinForms、WPF 和 Avalonia 的完整 C# 源代码,以及 1 年更新。每个产品也可单独购买,请参阅 sgcUI .NET 价格。
nuget.org 上的 .Community 包,面向个人以及年总收入低于 100 万欧元且开发者不超过 5 人的组织。sgcRichEdit、sgcSpreadsheet 和 sgcChat 没有 Community 包。
€380 / 开发者:sgcGrid、sgcNavigation、sgcToolbar 和 sgcEditors,可免费再分发二进制文件。
购买 .NET Standard →€529 / 开发者:包含 Standard 的全部内容,另加 sgcCharts、sgcDashboard 和 sgcGauges。
购买 .NET Professional →€699 / 开发者:每个 sgcUI 产品,包括 sgcPivotGrid、sgcPlanner、sgcDiagram、sgcWizard、sgcMaps、sgcPDF、sgcReports、sgcRichEdit、sgcSpreadsheet、sgcChat 和 sgcDocs。
购买 .NET Enterprise →每个 sgcUI 产品都有一个对宿主一无所知的模型。WinForms、WPF 和 Avalonia 控件是其上的轻量视图,C# 类名相同。
迁移套件列出了每个产品的宿主控件、移植时会变化的成员、每个界面的八个步骤以及无法一一对应的内容,并附带一个可在三种宿主上运行的示例的已编译 C# 代码。
从 WinForms 和 WPF 迁移到 Avalonia →面向 Avalonia 团队的逐控件指南:日程表、看板、数据透视网格、图表绘制和仪表板,可在您的 Avalonia 12 应用中与 Fluent 控件并排运行。
面向现有 Avalonia 团队的 sgcUI →相同的产品也提供 WPF 和 WinForms 版本,请参阅 WPF DataGrid。它们还提供适用于 Delphi 和 C++Builder 的 VCL 组件和 FireMonkey 组件。
sgcUI 套件 →业务应用通常需要数据网格、图表、仪表板、日程表以及围绕它们的表单。sgcUI 以原生 Avalonia 控件的形式提供这些:TsgcAvaloniaGrid、TsgcAvaloniaPivotGrid、TsgcAvaloniaChart、TsgcAvaloniaDashboard、仪表、sgcPlanner 的日程表、甘特图和看板、地图、PDF 查看器、报表以及 sgcEditors 输入控件。它们共用一个主题和一个 XAML 命名空间,因此界面看起来就像一个统一的应用程序。可使用免费的 Community 包试用。
可以。Avalonia 包面向 Avalonia 12 上的 net8.0、net9.0 和 net10.0(12.0 或更高版本,已使用 12.1.4 测试),控件可运行于 Windows、Linux 和 macOS。在 macOS 上,网格用 Cmd 代替 Ctrl,在触摸屏上,触点可平移网格。
会。当 Theme 为默认的 utDefault 时,控件会跟随 Avalonia 的 ActualThemeVariant 和平台强调色,并在应用运行时切换。使用 sgcUIApplication.ThemePreset = sgcUICore_Theme.CS_UI_THEME_FLUENT 选择 Fluent 预设,并在 Application.Styles 中保留 FluentTheme,控件就会采用框架主题的背景、边框、文本和填充。
有,其中 14 个产品提供,例如 nuget.org 上的 esegece.sgcGrid.Avalonia.Community 和 esegece.sgcCharts.Avalonia.Community。Community 包对个人以及年总收入低于 100 万欧元且开发者不超过 5 人的组织免费。sgcRichEdit、sgcSpreadsheet 和 sgcChat 仅提供 Registered 版本,Registered 包增加了全部功能、完整的 C# 源代码和商业许可证。
可以,一次一个界面。适用于 WinForms、WPF 和 Avalonia 的 sgcUI 控件是每个产品共享一个模型之上的轻量宿主,C# 类名相同,因此界面的数据和逻辑保持不变,只有宿主相关的几行会变化。从 WinForms 和 WPF 迁移到 Avalonia 套件列出了每个产品的宿主控件、每个界面的步骤和已知差异。
不会。Avalonia 包不添加工具箱条目,您需要在 xmlns:sgc="https://www.esegece.com/sgcui" 下于 AXAML 中声明控件。在 Avalonia 预览器中,空的网格、数据透视网格、图表、规划器或图表绘制控件会显示示例数据,因此可以在绑定数据之前检查布局。WinForms 和 WPF 包则会把控件添加到工具箱。