WPF-UI-besturingselementen voor C# en XAML
Grafieken, datumkiezers, wizards, een lint, docking en een PDF-viewer voor je WPF-app, in Fluent licht en donker.
Grafieken, datumkiezers, wizards, een lint, docking en een PDF-viewer voor je WPF-app, in Fluent licht en donker.
Elk sgcUI-besturingselement tekent via sgcUICore, de gedeelde canvas- en themaruntime, zodat een grafiek, een wizard of een planner er in een WPF-venster hetzelfde uitziet als in de andere hosts van de suite.
De Realtime-demo op WPF: aanwezigheid, een activiteitenfeed, een meldingeninbox en een live loggrid.
sgcNavigation →
De Fluent-preset in donker: tabbladen, een grid, een KPI-kaart, een grafiek, editors, een meter en een Kanban-bord.
Fluent en donkere modus →
Een wizard met vier stappen en een stepper, in het donkere thema.
sgcWizard →
De planner in weekweergave, met evenementen van een hele dag en elkaar overlappende afspraken naast elkaar.
sgcPlanner →sgcUI voor .NET is een beheerde C#-port met dezelfde klassenamen als de Delphi-suite. De WPF-besturingselementen dragen het voorvoegsel TsgcWpf, worden geleverd in één NuGet-package per product en delen de XAML-naamruimte https://www.esegece.com/sgcui.
TsgcWpfChart van sgcCharts tekent een TsgcChart-model met eenentwintig seriestypen, van lijn, staaf en kandelaar tot cirkel, radar en treemap. Series worden in XAML gedeclareerd en in elke editie gekoppeld aan verzamelingen van je viewmodel, en de grafiek kan veilig vanuit een achtergrondthread worden gevoed. SaveToPNG en SaveToSVG exporteren wat de gebruiker ziet. Bekijk het XAML-voorbeeld.
sgcEditors voegt TsgcWpfDatePicker, TsgcWpfTimePicker, TsgcWpfDateTimePicker en TsgcWpfMonthCalendar toe, naast masker-, valuta-, opzoek- en tokenvelden. De kalender kent echte boekingsregels, de editors behouden native tekstinvoer met IME en klembord, en formuliervalidatie maakt deel uit van elke editie, het gratis Community-package inbegrepen.
TsgcWpfWizard van sgcWizard neemt per stap één TsgcWpfWizardPage als kind in XAML, en de Caption en Description van elke pagina worden de stap die in de stepper wordt getoond. Een pagina kan Next weigeren zolang de gegevens niet geldig zijn, en TsgcWpfStepper toont de voortgang zelfstandig. Elke functie zit in het gratis .NET Community-package.
TsgcWpfDashboard van sgcDashboard legt tegels uit op een grid met 12 kolommen dat meebeweegt met de venstergrootte en schaalt met de monitor-DPI. Tegels bevatten KPI-kaarten (TsgcWpfKPICard), grafieken, grids, meters, kaarten en draaitabellen, en de gebruiker sleept ze en wijzigt hun formaat tot een indeling die je opslaat en herstelt.
TsgcWpfToastManager van sgcNavigation stapelt korte kaarten in een hoek van het venster, elk met een ernstpictogram, een titel, maximaal drie regels tekst en maximaal twee actieknoppen, en sluit ze na een aftelling. TsgcWpfNotificationInbox toont de meldingen met een teller voor ongelezen berichten, en met TsgcWpfNotificationPrefsEditor kiest de gebruiker de kanalen per categorie. De Delphi-kant wordt beschreven in meldingen voor Delphi.
sgcToolbar brengt TsgcWpfRibbon met tabbladen, galerijen, KeyTips en een backstage, en TsgcWpfRibbonWindow voor een lintformulier. TsgcWpfToolbar en TsgcWpfStatusBar maken de shell compleet. De panelen van de statusbalk worden vanuit elke thread bijgewerkt, en de opdrachten worden gekoppeld aan ICommand en in XAML gedeclareerd.
Het package esegece.sgcPDF.Wpf van sgcPDF voegt TsgcWpfPDFViewer, TsgcWpfPDFThumbnailView en TsgcWpfPDFOutlineView toe voor een compleet leesvenster, plus het streepjescodebesturingselement TsgcWpfPDFBarcodeControl. Daarachter zit de sgcPDF-bibliotheek voor .NET, die ook documenten maakt, bewerkt en ondertekent.
TsgcWpfDockManager van sgcNavigation verandert een venster in een werkruimte in IDE-stijl: gereedschapspanelen aan de zijkanten, documenten met tabbladen in het midden, neerzetgeleiders, automatisch verbergen en zwevende vensters. Hij draait op hetzelfde TsgcDockManagerModel als de dockmanagers voor WinForms, Avalonia en Delphi, dus de JSON-indeling wordt gedeeld. Zie docking op Avalonia voor een volledige uitleg.
TsgcWpfMap van sgcMaps tekent de kaart zelf, zonder browserbesturingselement en zonder JavaScript. Het toont markeringen, routes en offline tegels, en dezelfde engine rendert kaarten naar PNG-bestanden vanuit een console of een service.
sgcPlanner toont één planning op drie manieren: TsgcWpfScheduler als kalender, TsgcWpfGantt als Gantt-diagram en TsgcWpfKanban als bord, allemaal via ItemsSource gekoppeld aan één gegevensobject. Verplaats een kaart naar Done en de Gantt-balk en de kalender volgen. Planningen worden geladen en opgeslagen als JSON, iCalendar en Microsoft Project XML.
TsgcWpfRichEdit van sgcRichEdit bewerkt documenten met stijlen, lijsten, tabellen, afbeeldingen en koppelingen. Het leest en schrijft JSON, HTML, Markdown en RTF, en exporteert DOCX, PDF en PNG-pagina's vanuit één documentmodel dat wordt gedeeld met de WinForms- en Avalonia-editors.
sgcGauges heeft zestien metertypen, waarvan twaalf in het .NET Community-package: radiaal, lineair, digitaal, LED, tank en meer, met onder meer TsgcWpfRadialGauge, TsgcWpfLinearGauge en TsgcWpfKnobGauge. Invoermeters zoals draaiknoppen, schuifregelaars en schakelaars reageren op de muis, het wiel en het toetsenbord, en elke meter rendert zonder venster naar PNG en SVG.
TsgcWpfSpreadsheet van sgcSpreadsheet neemt waarden en formules in zoals Excel en berekent 211 werkbladfuncties met dynamische matrices die overlopen. Het houdt meerdere bladen bij met gedefinieerde namen en vastgezette deelvensters, tekent grafieken op basis van celbereiken en laadt en slaat XLSX-bestanden op. TsgcWpfSpreadsheetFormulaBar voegt de formulebalk toe.
Op zoek naar een grid? TsgcWpfGrid heeft een eigen pagina: het WPF DataGrid-besturingselement met live updates, groepering, filters en Excel-export. Draaitabellen (TsgcWpfPivotGrid), diagrammen (TsgcWpfDiagramView), rapportvoorbeelden en chatweergaven maken de suite compleet, zie de tabel hieronder.
De sgcUI-besturingselementen tekenen zichzelf in licht, donker of hoog contrast, met een themapreset die hun kleuren, hoeken en lijndiktes bepaalt. Fluent is een van de drie ingebouwde presets.
Theme. Op de standaardwaarde volgt het besturingselement het toepassingsthema, dat je vastlegt met sgcUIApplication.SetTheme.Application.ThemeMode, dus Light, Dark en System schakelen ze om, en ze tekenen zich opnieuw wanneer het thema of de accentkleur van Windows verandert. Op .NET Framework 4.7.2 en .NET 8 meldt de host licht, dus leg het thema vast op donker als je dat wilt.sgcUIApplyThemeToWindow van sgcUICore_Theme_Wpf stelt de achtergrond en de lettertypekleur van een venster en zijn onderliggende besturingselementen in, zodat de rest van het venster bij het thema past.Help: Applicatiethema, Themapresets en High DPI.
Voeg het Community-package van sgcCharts toe aan een WPF-project net8.0-windows, declareer de grafiek en een serie in XAML en koppel de serie aan een 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);
}
}
}
Elke toevoeging of verwijdering in de verzameling werkt de serie bij, en de grafiek tekent zich hoogstens Chart.MaxFPS keer per seconde opnieuw. Items die INotifyPropertyChanged implementeren mogen hun waarden ook vanuit een worker thread wijzigen. Dezelfde declaratie xmlns:sgc geeft in hetzelfde bestand toegang tot de besturingselementen van elk sgcUI-product. Zie de sgcUI-snelstart.
De WPF-packages richten zich op net472, net8.0-windows, net9.0-windows en net10.0-windows. Elk brengt zijn core- en renderingpackages mee als afhankelijkheden, dus één packageverwijzing is genoeg. Een project verwijst naar de Community- of de Registered-packages, nooit naar beide.
| Product | Belangrijkste WPF-besturingselementen | Gratis Community-package | Registered-package |
|---|---|---|---|
| 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 |
De Community-packages staan op nuget.org, gratis voor particulieren en organisaties met minder dan EUR 1 miljoen jaarlijkse bruto-omzet en niet meer dan 5 ontwikkelaars. De Registered-packages komen uit je account, met elke functie en de volledige C#-broncode. sgcUI .NET Standard omvat sgcGrid, sgcNavigation, sgcToolbar en sgcEditors vanaf €380, Professional voegt sgcCharts, sgcDashboard en sgcGauges toe, en Enterprise bevat elk product. Zie download en .NET-prijzen.
Ja. sgcEditors heeft TsgcWpfDatePicker, TsgcWpfTimePicker, TsgcWpfDateTimePicker en TsgcWpfMonthCalendar in het package esegece.sgcEditors.Wpf. Ze worden door sgcUICore getekend in licht, donker en hoog contrast, met de Fluent-preset als je die kiest, en ze behouden native tekstinvoer met IME en het klembord. Het gratis package esegece.sgcEditors.Wpf.Community bevat ze, en sgcUI .NET Standard bevat sgcEditors.
Voeg het package esegece.sgcWizard.Wpf, of zijn Community-tegenhanger, toe aan een WPF-project. Declareer in XAML een TsgcWpfWizard met per stap één TsgcWpfWizardPage en stel de Caption en Description van elke pagina in. Wijs de wizardgebeurtenissen toe in de code-behind: het zijn delegates, geen WPF routed events, dus ze worden niet als XAML-attributen ingesteld. Elke wizardfunctie zit in het gratis Community-package.
TsgcWpfChart van sgcCharts. Hij tekent in een persistente bitmap, gelimiteerd tot Chart.MaxFPS, en kan veilig met gegevens vanuit een achtergrondthread worden gevoed. Koppel een TsgcWpfChartSeries aan een ObservableCollection en elke toevoeging of verwijdering werkt de serie bij. In WPF gaan die verzamelingswijzigingen via de UI-thread, terwijl wijzigingen van itemeigenschappen vanuit elke thread kunnen komen. Het voorbeeld hierboven voegt vier keer per seconde een punt toe.
Ja. Elk sgcUI-besturingselement tekent in licht, donker of hoog contrast, met de preset Classic, Fluent of ISA101. Op .NET 9 en later volgen de besturingselementen Application.ThemeMode en tekenen ze zich opnieuw wanneer die of het Windows-thema verandert. Op .NET Framework 4.7.2 en .NET 8 meldt de WPF-host licht, dus kies je donker met de eigenschap Theme van een besturingselement of met sgcUIApplication.SetTheme voor de hele toepassing.
Ja, voor veertien producten: sgcGrid, sgcCharts, sgcDashboard, sgcGauges, sgcEditors, sgcWizard, sgcNavigation, sgcToolbar, sgcPlanner, sgcMaps, sgcPivotGrid, sgcDiagram, sgcPDF en sgcReports hebben elk een package .Wpf.Community op nuget.org. Ze zijn gratis voor particulieren en organisaties met minder dan EUR 1 miljoen jaarlijkse bruto-omzet en niet meer dan 5 ontwikkelaars. sgcRichEdit, sgcSpreadsheet en sgcChat zijn alleen als Registered-packages verkrijgbaar.
De WPF-packages richten zich op .NET Framework 4.7.2 (net472) en .NET 8, 9 en 10 (net8.0-windows, net9.0-windows, net10.0-windows). Dezelfde producten leveren WinForms- en Avalonia 12-besturingselementen met dezelfde klassenamen, dus een model of viewmodel dat je voor WPF schrijft, is herbruikbaar. Zie de Avalonia-besturingselementen en de kit WinForms en WPF naar Avalonia.
Ook beschikbaar voor Delphi en C++Builder: de Delphi VCL-componenten en de Delphi FireMonkey-componenten, met dezelfde namen en modellen. Gerelateerd: de WPF DataGrid en de sgcUI-suite.