Bouw het raamwerk van een desktopapplicatie met besturingselementen die op elke UI hetzelfde eruitzien. Een werkbalk met knoppen, schakelaars, radiogroepen en dropdowns, een Ribbon met tabbladen, galerijen, KeyTips en backstage-weergave voor applicaties die uit een werkbalk groeien, met zijn werkbalk Snelle toegang in een titelbalk met thema, en een echte statusbalk met voortgangs- en indicatorpanelen die een workerthread rechtstreeks kan bijwerken.
Veertien functies voor de balken die elke desktopapplicatie nodig heeft, van een volledige Ribbon en radiogroepen tot live voortgang vanuit een workerthread.
Een Ribbon in Office-stijl voor applicaties met meer commando's dan een werkbalk kan bevatten, op elk sgcUI-framework.
Ribbon Alleen geregistreerd
Je gebruikers openen een rapporteditor op een laptop, snappen het venster naar de helft van het scherm en verwachten toch elk commando te kunnen bereiken. De Ribbon maakt dat mogelijk. Commando's staan in tabbladen en groepen, en als het venster smaller wordt, zakt elke groep van grote naar middelgrote en kleine knoppen en klapt ten slotte in tot één knop, volgens de prioriteit die je instelt. De Ribbon scrolt zodra alles is ingeklapt. Galerijen krimpen van volledige rijen naar minder kolommen naar een dropdown. Druk op Alt en de KeyTips verschijnen, typ het tabblad en het commando, en Esc gaat een stap terug. De toepassingsknop opent een backstage-weergave met commando's en met pagina's die je eigen besturingselementen bevatten. Een werkbalk Snelle toegang staat boven of onder de Ribbon, en gebruikers passen hem aan via een menu of met een rechtsklik.
ICommand in .NET en XAML-declaratie in WPF en AvaloniaSaveLayout en LoadLayout bewaren de werkbalk Snelle toegang van elke gebruiker en de geminimaliseerde status als JSONGeregistreerde editie op VCL, FireMonkey, WinForms, WPF en Avalonia, Delphi 7 tot 13 en C++ Builder. Community bevat de Ribbon niet. KeyTips werken op het Windows-bureaublad. De werkbalk Snelle toegang heeft een eigen rij, of het Ribbon-formulier tekent hem in de titelbalk van het venster.
Overzicht van de RibbonRibbon Alleen geregistreerd
Een Office-applicatie heeft geen grijze Windows-titel boven de Ribbon. De werkbalk Snelle toegang en de documentnaam staan in de titelbalk, en de titelbalk en de Ribbon zien eruit als één oppervlak. Het Ribbon-formulier geeft je venster hetzelfde kader. Plaats het op het formulier en kies de Ribbon: sgcUI verwijdert de native titel en tekent een titelbalk met thema, met het venstericoon, de werkbalk Snelle toegang, de titel gecentreerd op het venster en de knoppen minimaliseren, maximaliseren en sluiten, in de kleur van de tabrij van het Ribbon-thema, Classic of Fluent, licht of donker. De Ribbon staat er direct onder en is één rij korter. Het venster behoudt zijn schaduw, zijn randen om het formaat te wijzigen en zijn gedrag bij maximaliseren, Windows 11 toont de snaplayouts op de knop Maximaliseren, en de lege ruimte van de titelbalk sleept het venster.
TsgcVCLRibbonForm en TsgcFMXRibbonForm in Delphi en C++ Builder, TsgcWinFormsRibbonForm, TsgcWpfRibbonWindow en TsgcAvaloniaRibbonWindow in .NETQATPosition op rqpBelow of ShowQAT uit toont de titelbalk alleen de titel, en Show above the Ribbon zet de werkbalk weer bovenCaptionAlignment centreert de titel of zet hem na het pictogram, en TitleBarHeight stelt de hoogte inRibbon op het venster het formulier in vanuit XAMLEditie Registered, net als de Ribbon: Community bevat het Ribbon-formulier niet. Het kader met thema vereist Windows met desktopcompositie en wordt in FireMonkey alleen op Windows toegepast. Zonder dat toont de Ribbon zijn eigen rij voor de werkbalk Snelle toegang.
Het helponderwerp lezenElk item dat een commandobalk nodig heeft, waarbij het besturingselement de groepering, menu's en overflow afhandelt.
Commando's
Een echte applicatiewerkbalk combineert gewone knoppen, knoppen die ingedrukt blijven, knoppen met een menu, scheidingslijnen en een stukje tekst. Bij sgcToolbar is elk daarvan één item van dezelfde collectie, en Kind bepaalt hoe het wordt getekend en hoe het reageert. Items worden van links naar rechts neergezet met Spacing ertussen, en een spacer neemt de vrije breedte in, zodat je Help of een gebruikersnaam naar de rechterrand kunt duwen zonder indelingscode. Width legt een item vast wanneer je een stabiele grootte nodig hebt. Hints, uitgeschakelde statussen en hot tracking worden voor elke soort getekend.
tikButton, tikToggle en tikDropdown voor commando'stikSeparator tekent een dunne verticale lijntikSpacer duwt de volgende items naar rechtstikLabel toont tekst in de balk
Commando's
Tekstuitlijning, weergavemodi en tekengereedschappen zijn klassieke keuzes uit meerdere opties. Geef meerdere schakelitems dezelfde GroupIndex en ze vormen een radiogroep: Down zetten op één ervan, met een klik of vanuit code, geeft de andere vrij, en een klik op het item dat al ingedrukt is laat het ingedrukt, zodat er altijd één keuze geselecteerd blijft. Een schakelaar met GroupIndex 0 is een eenvoudige aan-uitschakelaar zoals Vet of Regelafbreking. De klik zet Down om voordat OnItemClick wordt geactiveerd, zodat je handler de nieuwe status leest. Er is geen gebeurtenisbedrading nodig om de groep consistent te houden.
GroupIndex boven 0 maakt een radiogroepDown leest of zet de status vanuit codeDown aan via zijn CheckedCommando's
Zoomniveaus, exportformaten en recente bestanden horen in een menu onder een knop, niet in tien extra knoppen. Een tikDropdown-item tekent een klein pijltje achter zijn bijschrift en toont het popupmenu dat je aan DropdownMenu toewijst direct onder de knop: een TPopupMenu in VCL en FireMonkey, een ContextMenuStrip in WinForms. OnItemClick en de OnClick van het item worden geactiveerd voordat het menu opent, zodat je de items eerst kunt vullen of aanvinken. Als het menu wordt vrijgegeven, wist de balk de verwijzing voor je. Eén klikdoel, één menu en een werkbalk die kort blijft, ook als de commando's toenemen.
DropdownMenu neemt de popup van jouw frameworkOnItemClickCommando's Alleen geregistreerd
Gebruikers wijzigen de venstergrootte, en een werkbalk die zijn laatste knoppen simpelweg afknipt, verbergt commando's die ze nodig hebben. Als de items niet passen, verplaatst sgcToolbar de laatste naar een overflowlijst en tekent een knop met een dubbele chevron aan het rechteruiteinde. Erop drukken toont OverflowMenu, tijdens runtime opgebouwd met één item per verborgen item, en een item kiezen werkt precies als een klik: een schakelaar wisselt om, OnItemClick wordt geactiveerd en een dropdown toont zijn menu. Het model vertelt je wat verborgen is. Wordt het venster weer groter, dan keren de items zelf terug in de balk.
OverflowMenu wordt tijdens runtime voor je opgebouwdHasOverflow, OverflowCount en InOverflow per itemItemAtPos meldt een treffer op de overflowknopSGC_TOOLBAR_ADVANCEDCommunity: de items die niet passen worden afgeknipt, er is geen overflowknop.
Het helponderwerp lezenCommando's Alleen geregistreerd
Als je commando's al in een TActionList staan, hoeft de werkbalk ze niet te dupliceren. Koppel een item via de eigenschap Action aan een willekeurige VCL- of FireMonkey-TAction en het volgt Caption, Enabled, Visible, Hint, ImageIndex en Checked van de actie. Een klik voert de actie uit met de balk als ActionComponent, tenzij het item een OnClick-handler heeft. De balken roepen bij inactiviteit InitiateAction aan, zodat een uitgeschakelde actie zijn knop uitschakelt zonder extra code. In .NET heeft het item Command en CommandParameter voor ICommand. Eén TActionList kan de werkbalk, het hoofdmenu en de navigatiebalk samen aansturen.
Action koppelt een item aan een willekeurige TBasicActionDown van een schakelaar aanCommand en CommandParameterCommunity: handel de OnClick van het item of de OnItemClick van de balk af in plaats van een actie.
Het helponderwerp lezenEen statusbalk die zichzelf indeelt, voortgang en status toont en updates uit elke thread accepteert.
Statusbalk
Regel en kolom, een bestandsnaam, de opslagstatus en een hoofdbericht strijden allemaal om de onderrand van het venster. TsgcVCLStatusBar deelt zijn Panels van links naar rechts in drie stappen in: vaste panelen nemen hun Width, AutoSize-panelen nemen de breedte van hun tekst en Spring-panelen delen wat er overblijft. Gebruik één springpaneel voor het hoofdbericht en de balk blijft netjes bij elke venstergrootte. Een dunne lijn scheidt de panelen en OnPanelClick vertelt je op welke is geklikt. Panelen zijn een collectie, dus je kunt ze tijdens ontwerptijd toevoegen en bewerken in de Object Inspector.
spkText-panelen met Alignment en HintSpring-panelen delen de vrije breedteAutoSize-panelen passen zich aan hun tekst aanOnPanelClick meldt een klik op een paneel
Statusbalk
Lange bewerkingen hebben een voortgangsbalk nodig, en live verbindingen een lampje dat laat zien of alles goed gaat. Een paneel kan een voortgangsbalk zijn die tot Progress procent in de accentkleur is gevuld, of een indicator: een gekleurde stip gevolgd door de tekst van het paneel. IndicatorState kiest uit, ok, waarschuwing of fout, met groen, oranje en rood apart afgestemd op het lichte en het donkere thema. Het past bij de status van een databaseverbinding, een datafeed of een achtergrondsynchronisatie. Zet Progress of IndicatorState en het paneel tekent zichzelf opnieuw, er is geen tekencode om te schrijven.
spkProgress met Progress van 0 tot 100spkIndicator met IndicatorStatesisOff, sisOk, sisWarning, sisErrorGetIndicatorColor geeft de kleur voor het thema terugStatusbalk
Downloads, feeds en lange berekeningen draaien in workerthreads, en elke statusupdate terugsturen naar de hoofdthread is vervelend en gemakkelijk fout te doen. SetPanelText, SetProgress en SetIndicator mogen vanuit elke thread worden aangeroepen, zonder Synchronize of Queue. Het model beschermt de waarden met een lock en activeert OnChange alleen wanneer een waarde echt veranderd is, zodat dezelfde waarde herhalen niets kost. De VCL-balk post daarna een bericht naar zijn venster en de FireMonkey-balk zet het hertekenen in de wachtrij, zodat de UI nooit buiten de hoofdthread wordt aangeraakt. Een thread die een paneel overleeft, is ook veilig.
SetPanelText, SetProgress, SetIndicator vanuit elke threadSynchronize of Queue in je codePictogrammen, thema's en toetsenbordondersteuning die passen bij de rest van sgcUI, plus afbeeldingen van de balken voor je documentatie.
Uiterlijk, toetsenbord en uitvoer
Elk klikbaar item heeft een pictogramplek van 16 logische pixels. Die toont de afbeelding op ImageIndex van de Images-lijst van de balk of, als een item geen afbeelding heeft, zijn Glyph: een letter of kort symbool waarvoor helemaal geen afbeeldingenlijst nodig is. Zet ShowCaptions uit voor een compacte balk met alleen pictogrammen, en het bijschrift wordt de hint, zodat er niets verloren gaat. VCL-afbeeldingenlijsten worden één keer geconverteerd naar straight ARGB met herstelde alfa en gecachet tot de lijst verandert, zodat lijsten met masker en van 32 bit er allebei goed uitzien. Combineer beide vrij zolang de pictogrammen nog worden ontworpen.
Images en ImageIndex voor afbeeldingenlijstenGlyph wanneer er geen afbeelding isShowCaptions False voor alleen pictogrammenMirrorGlyph spiegelt richtingsgebonden pictogrammen zoals terug, vooruit, ongedaan maken en opnieuw uitvoeren
Uiterlijk, toetsenbord en uitvoer
De balken nemen hun kleuren uit de sgcUICore-thematokens, dezelfde die elk product van de suite gebruikt, zodat een werkbalk boven een sgcGrid en naast een sgcNavigation-balk eruitziet als één applicatie. Theme kiest utLight of utDark, en AccentColor vervangt het accent dat de focusring, de ingedrukte tint van schakelaars en de voortgangsbalken gebruiken. Hot-, pressed-, down-, focused- en disabled-statussen worden allemaal voor je afgeleid. Elke balk heeft zijn eigen Theme, dus zet het op de werkbalk en op de statusbalk. Tijdens runtime wisselen tekent beide balken tegelijk opnieuw.
Theme: utDefault (standaard, volgt het applicatiethema), utLight of utDarkAccentColor als $AARRGGBB, 0 behoudt het themaaccentUiterlijk, toetsenbord en uitvoer
De werkbalk kan deel uitmaken van de tabvolgorde wanneer je gebruikers dat nodig hebben: zet TabStop en de knop met focus toont een focusring, Links en Rechts verplaatsen tussen ingeschakelde knoppen, Home en End springen, Enter of Spatie activeert. Standaard staat het uit, zodat de werkbalk nooit de focus steelt van de editor eronder. ClickItem activeert een item vanuit code, bijvoorbeeld vanuit een formuliersneltoets. Op de statusbalk tekent SizeGrip greeppunten, en onder VCL verandert slepen ervan de grootte van een formulier waarvan het formaat kan worden gewijzigd. Onder FireMonkey wordt de greep getekend maar verandert hij het formaat van het formulier niet, dus zet SizeGrip daar uit wanneer het formulier niet vergroot kan worden.
TabStop onder VCL, CanFocus onder FireMonkeyClickItem voert een item uit vanuit codeSizeGrip en GripRect op de statusbalkUiterlijk, toetsenbord en uitvoer
Schermafbeeldingen van een werkbalk in een handleiding zijn bij elke release verouderd. De renderer in sgcToolbar_Render tekent een TsgcToolbarModel of een TsgcStatusBarModel zonder venster en zonder VCL of FireMonkey, zodat een consoleprogramma, een test of een webserver dezelfde balken als afbeelding kan maken. SaveToPNG en SaveToSVG nemen een grootte in logische pixels en een schaal, dus 560 bij 44 op schaal 2 geeft een scherpe afbeelding van 1120 bij 88. De units bouwen op elk platform, Linux64 inbegrepen. Geef je eigen afbeeldingen door via OnGetImage en de afbeelding komt overeen met de draaiende applicatie.
SaveToPNG schrijft een PNG-bestand of -streamSaveToSVG schrijft dezelfde balk als SVGTsgcToolbarModel en TsgcStatusBarModelOnGetImage levert pictogrammen aan de headless uitvoersgcToolbar in de sgcUI suite-demo's: complete applicaties die offline draaien met ingebouwde gesimuleerde gegevens.
Een bovenbalk met Inject event, snelknoppen en de themaschakelaar, statusbalk eronder.
Altamira Fleet →
De ERP-bovenbalk met zoeken, Nieuw, meldingen en het gebruikersmenu.
Altamira ERP →
De PMO-bovenbalk met Reset what-if en de themaschakelaar.
Altamira PMO →
De fabrieksbovenbalk met Inject fault, Acknowledge all en snelheidsknoppen.
Altamira Plant →
Een editor heeft schakelaars voor Vet en Cursief nodig, een radiogroep voor uitlijning, een Zoom-menu en een statusbalk met de regel, de kolom en de opslagstatus. sgcToolbar dekt dat allemaal met één itemcollectie en één paneelcollectie, gekoppeld aan de TActionList die je al hebt. Wanneer het venster smaller wordt, houdt het overflowmenu elk commando bereikbaar. De EditorShell-demo bouwt precies dit rond een TMemo.
Importtools, synchronisatieclients en monitoringapps doen hun werk in achtergrondthreads en moeten dat rapporteren. Roep SetProgress, SetIndicator en SetPanelText rechtstreeks aan vanuit de workerthread en de statusbalk tekent opnieuw op de hoofdthread zonder Synchronize in je code. De indicator wordt groen, oranje of rood met de status van de taak. De LiveStatus-demo simuleert een download die precies dat doet.
Een FireMonkey-applicatie die op Windows, macOS en mobiel wordt geleverd, verdient overal dezelfde werkbalk. TsgcFMXToolbar en TsgcFMXStatusBar hebben dezelfde items, panelen en gebeurtenissen als de VCL-balken, en de .NET-balken voor WinForms, WPF en Avalonia volgen dezelfde namen. EditorShellFMX is de FireMonkey-versie van de editorschil, met dezelfde items, hetzelfde overflowmenu en dezelfde statuspanelen.
Dezelfde API in Delphi, C++ Builder en C#: een schakelaar, een radiogroep, een dropdown en een statusbalk die wordt bijgewerkt vanuit de klikhandler.
procedure TMainForm.CreateBars;
var
oItem: TsgcToolbarItem;
oPanel: TsgcStatusBarPanel;
begin
// a toolbar with a toggle, a Left/Center radio group and a dropdown
FToolbar := TsgcVCLToolbar.Create(Self);
FToolbar.Parent := Self;
FToolbar.ShowCaptions := True;
FToolbar.ShowHint := True;
FToolbar.OnItemClick := ToolbarItemClick;
oItem := FToolbar.Items.Add;
oItem.Caption := 'Save';
oItem.Glyph := 'S';
oItem.Hint := 'Save the document';
FToolbar.Items.Add.Kind := tikSeparator;
oItem := FToolbar.Items.Add;
oItem.Kind := tikToggle;
oItem.Caption := 'Bold';
oItem.Glyph := 'B';
oItem := FToolbar.Items.Add;
oItem.Kind := tikToggle;
oItem.GroupIndex := 1;
oItem.Down := True;
oItem.Caption := 'Left';
oItem := FToolbar.Items.Add;
oItem.Kind := tikToggle;
oItem.GroupIndex := 1;
oItem.Caption := 'Center';
oItem := FToolbar.Items.Add;
oItem.Kind := tikDropdown;
oItem.Caption := 'Zoom';
oItem.DropdownMenu := FZoomMenu;
// a status bar: a spring text panel, a progress bar and an indicator
FStatusBar := TsgcVCLStatusBar.Create(Self);
FStatusBar.Parent := Self;
oPanel := FStatusBar.Panels.Add;
oPanel.Spring := True;
oPanel.Text := 'Ready';
FStatusBar.Panels.Add.Kind := spkProgress;
oPanel := FStatusBar.Panels.Add;
oPanel.Kind := spkIndicator;
oPanel.AutoSize := True;
oPanel.Text := 'Saved';
oPanel.IndicatorState := sisOk;
end;
procedure TMainForm.ToolbarItemClick(Sender: TObject; aItem: TsgcToolbarItem);
begin
// the setters are thread safe, a worker thread can call them directly
FStatusBar.SetPanelText(0, aItem.Caption + ' clicked');
FStatusBar.SetProgress(1, 60);
FStatusBar.SetIndicator(2, sisWarning);
end;Een venster in Office-stijl: TsgcVCLRibbonForm verplaatst de werkbalk Snelle toegang en de gecentreerde titel naar een titelbalk met thema.
uses
Classes, SysUtils, Controls, Forms,
sgcToolbar_Ribbon_Model, sgcToolbar_Ribbon_VCL, sgcToolbar_RibbonForm_VCL;
procedure TMainForm.FormCreate(Sender: TObject);
var
oGroup: TsgcRibbonGroup;
oItem: TsgcRibbonItem;
begin
Caption := 'Document1';
// the ribbon, aligned to the top, with Save in the Quick Access Toolbar
Ribbon := TsgcVCLRibbon.Create(Self);
Ribbon.Parent := Self;
oGroup := Ribbon.Tabs.Add.Groups.Add;
oGroup.Caption := 'File';
oItem := oGroup.Items.Add;
oItem.Name := 'Save';
oItem.Caption := 'Save';
Ribbon.QuickAccess.Add.ItemName := 'Save';
// the window frame: the QAT and the centred caption go in the title bar
RibbonForm := TsgcVCLRibbonForm.Create(Self);
RibbonForm.Ribbon := Ribbon;
end;#include <vcl.h>
#include <Vcl.Menus.hpp>
#include "sgcUICore_Theme.hpp"
#include "sgcToolbar_Model.hpp"
#include "sgcToolbar_VCL.hpp"
class TBarHandler : public TObject
{
public:
TsgcVCLStatusBar *StatusBar;
void __fastcall ItemClick(TObject *Sender, TsgcToolbarItem *aItem);
};
void __fastcall TBarHandler::ItemClick(TObject *Sender, TsgcToolbarItem *aItem)
{
// the setters are thread safe, a worker thread can call them directly
StatusBar->SetPanelText(0, aItem->Caption + " clicked");
StatusBar->SetProgress(1, 60);
StatusBar->SetIndicator(2, sisWarning);
}
void __fastcall CreateBars(TForm *Form, TBarHandler *Handler, TPopupMenu *ZoomMenu)
{
// a toolbar with a toggle, a Left/Center radio group and a dropdown
TsgcVCLToolbar *Toolbar = new TsgcVCLToolbar(Form);
Toolbar->Parent = Form;
Toolbar->ShowCaptions = true;
Toolbar->OnItemClick = Handler->ItemClick;
TsgcToolbarItem *Item = Toolbar->Items->Add();
Item->Caption = "Save";
Item->Glyph = "S";
Item->Hint = "Save the document";
Toolbar->Items->Add()->Kind = tikSeparator;
Item = Toolbar->Items->Add();
Item->Kind = tikToggle;
Item->Caption = "Bold";
Item = Toolbar->Items->Add();
Item->Kind = tikToggle;
Item->GroupIndex = 1;
Item->Down = true;
Item->Caption = "Left";
Item = Toolbar->Items->Add();
Item->Kind = tikToggle;
Item->GroupIndex = 1;
Item->Caption = "Center";
Item = Toolbar->Items->Add();
Item->Kind = tikDropdown;
Item->Caption = "Zoom";
Item->DropdownMenu = ZoomMenu;
// a status bar: a spring text panel, a progress bar and an indicator
TsgcVCLStatusBar *StatusBar = new TsgcVCLStatusBar(Form);
StatusBar->Parent = Form;
TsgcStatusBarPanel *Panel = StatusBar->Panels->Add();
Panel->Spring = true;
Panel->Text = "Ready";
StatusBar->Panels->Add()->Kind = spkProgress;
Panel = StatusBar->Panels->Add();
Panel->Kind = spkIndicator;
Panel->AutoSize = true;
Panel->Text = "Saved";
Panel->IndicatorState = sisOk;
Handler->StatusBar = StatusBar;
}using System;
using System.Windows.Forms;
using esegece.sgcToolbar;
internal class MainForm : Form
{
private readonly TsgcWinFormsToolbar Toolbar = new TsgcWinFormsToolbar();
private readonly TsgcWinFormsStatusBar StatusBar = new TsgcWinFormsStatusBar();
public MainForm()
{
// a toolbar with a toggle, a Left/Center radio group and a dropdown
Toolbar.ShowCaptions = true;
Toolbar.OnItemClick = ToolbarItemClick;
TsgcToolbarItem oItem = Toolbar.Items.Add();
oItem.Caption = "Save";
oItem.Glyph = "S";
oItem.Hint = "Save the document";
Toolbar.Items.Add().Kind = TsgcToolbarItemKind.tikSeparator;
oItem = Toolbar.Items.Add();
oItem.Kind = TsgcToolbarItemKind.tikToggle;
oItem.Caption = "Bold";
oItem = Toolbar.Items.Add();
oItem.Kind = TsgcToolbarItemKind.tikToggle;
oItem.GroupIndex = 1;
oItem.Down = true;
oItem.Caption = "Left";
oItem = Toolbar.Items.Add();
oItem.Kind = TsgcToolbarItemKind.tikToggle;
oItem.GroupIndex = 1;
oItem.Caption = "Center";
ContextMenuStrip oZoom = new ContextMenuStrip();
oZoom.Items.Add("100%");
oZoom.Items.Add("200%");
oItem = Toolbar.Items.Add();
oItem.Kind = TsgcToolbarItemKind.tikDropdown;
oItem.Caption = "Zoom";
oItem.DropdownMenu = oZoom;
// a status bar: a spring text panel, a progress bar and an indicator
TsgcStatusBarPanel oPanel = StatusBar.Panels.Add();
oPanel.Spring = true;
oPanel.Text = "Ready";
StatusBar.Panels.Add().Kind = TsgcStatusPanelKind.spkProgress;
oPanel = StatusBar.Panels.Add();
oPanel.Kind = TsgcStatusPanelKind.spkIndicator;
oPanel.AutoSize = true;
oPanel.Text = "Saved";
oPanel.IndicatorState = TsgcStatusIndicatorState.sisOk;
Controls.Add(Toolbar);
Controls.Add(StatusBar);
}
private void ToolbarItemClick(object sender, TsgcToolbarItem aItem)
{
// the setters are thread safe, a worker thread can call them directly
StatusBar.SetPanelText(0, aItem.Caption + " clicked");
StatusBar.SetProgress(1, 60);
StatusBar.SetIndicator(2, TsgcStatusIndicatorState.sisWarning);
}
}dotnet add package esegece.sgcToolbar.WinFormsDe demo's EditorShell en LiveStatus worden meegeleverd voor VCL en C++ Builder, plus een FireMonkey-versie voor Delphi, en in de .NET-editie als WinForms-, WPF- en Avalonia-projecten. De geregistreerde editie voegt de Ribbon-demo's RibbonShell, RibbonForm en RibbonSuite toe.
Een TMemo-editorschil met schakelaars, een radiogroep Links, Midden en Rechts, een Zoom-dropdown, TActionList-koppelingen, het overflowmenu, panelen voor regel en kolom en een schakelaar Donker. Hij gebruikt overflow en acties, dus je hebt de editie Registered of de proefversie nodig.
Een workerthread simuleert een download en voedt een tekstpaneel, een voortgangspaneel en een indicator die groen, oranje of rood wordt, met knoppen Start en Stop. Hij bouwt met de Community-editie.
De EditorShell-demo met een TsgcFMXToolbar en een TsgcFMXStatusBar rond een FireMonkey-TMemo, alleen voor Delphi: dezelfde items, actielinks, hetzelfde overflowmenu en dezelfde statuspanelen.
Een documentschil rond een Ribbon met tabbladen, groepen, een galerij, een contextueel tabblad, de werkbalk Snelle toegang, KeyTips en een backstage-weergave. RibbonShell is de VCL-demo en RibbonShellFMX de FireMonkey-demo, beide met C++ Builder-tegenhangers. RibbonShell, RibbonShellWpf en RibbonShellAvalonia zijn de .NET-projecten.
Een editorvenster in Office-stijl, voor de VCL en voor FireMonkey, met C++ Builder-tegenhangers: de werkbalk Snelle toegang met Opslaan, Ongedaan maken en Opnieuw in de titelbalk naast het venstericoon, de titel gecentreerd, en direct eronder een Ribbon met de knop Bestand en de tabbladen Start, Invoegen en Beeld. Met een selectievakje verplaats je de werkbalk Snelle toegang onder de Ribbon, met een ander schakel je het kader met thema uit, en de themakiezer wisselt tussen Light, Dark en Fluent. In de .NET-editie wordt het meegeleverd als RibbonForm voor WinForms, RibbonFormWpf en RibbonFormAvalonia.
Eén Ribbon die meerdere sgcUI-producten vanuit één formulier aanstuurt: de commando's werken op de andere sgcUI-besturingselementen van de suite.
Direct uitvoerbare programma's van elk sgcUI-product, zonder installatie.
sgcUI_bin.zip downloaden →Vijf QuickStart-demo's voor Delphi (VCL) staan in Demos\Toolbar\Delphi\00.QuickStart. De PDF-gids (Engels) legt ze stap voor stap uit: een eerste werkbalk, alle soorten items, acties en een statusbalk, thema's en een kleine teksteditor.
sgcToolbar zit in elke sgcUI-editie, te beginnen met Standard, en wordt ook los verkocht. sgcToolbar zit ook in de All-Access-bundel.
€149 / ontwikkelaar, volledige broncode, 1 jaar updates.
sgcToolbar kopen → Prijzen bekijken →Standard plus sgcCharts, sgcDashboard en sgcGauges, vanaf €529.
Professional bekijken →De gratis Community-editie (esegece.sgcToolbar.Community op NuGet) laat de Ribbon en het Ribbon-formulier, het overflowmenu en de actielinks weg.
| Functie | Community (gratis) | Geregistreerd |
|---|---|---|
| Elke itemsoort, schakelaars, radiogroepen en dropdownmenu's | ✓ | ✓ |
| Tekst-, voortgangs- en indicatorpanelen | ✓ | ✓ |
| Threadveilige statusupdates | ✓ | ✓ |
| Pictogrammen, glyphs, thema's, toetsenbord en formaatgreep | ✓ | ✓ |
| Headless PNG- en SVG-uitvoer | ✓ | ✓ |
| Ribbon met KeyTips, galerijen, werkbalk Snelle toegang en backstage-weergave | − | ✓ |
| Ribbon-formulier: werkbalk Snelle toegang en titel in een titelbalk met thema | − | ✓ |
| Overflowmenu | − | ✓ |
| Actielinks (Delphi) en Command (.NET) | − | ✓ |
| Component | Doel |
|---|---|
| TsgcVCLToolbar, TsgcVCLStatusBar | Delphi en C++ Builder, VCL (sgcToolbar_VCL) |
| TsgcFMXToolbar, TsgcFMXStatusBar | Delphi en C++ Builder, FireMonkey (sgcToolbar_FMX) |
| De Ribbon | Geregistreerde editie: VCL, FireMonkey, WinForms, WPF en Avalonia |
| TsgcVCLRibbonForm, TsgcFMXRibbonForm | Geregistreerde editie: Delphi en C++ Builder, VCL en FireMonkey (sgcToolbar_RibbonForm_VCL, sgcToolbar_RibbonForm_FMX), de titelbalk met thema op Windows |
| TsgcWinFormsRibbonForm, TsgcWpfRibbonWindow, TsgcAvaloniaRibbonWindow | Geregistreerde editie: .NET, WinForms, WPF en Avalonia |
| TsgcToolbarItem, TsgcStatusBarPanel, TsgcToolbarModel, TsgcStatusBarModel | Frameworkneutrale modellen (sgcToolbar_Model) |
| TsgcWinFormsToolbar, TsgcWinFormsStatusBar | .NET, WinForms |
| TsgcWpfToolbar, TsgcWpfStatusBar | .NET, WPF |
| TsgcAvaloniaToolbar, TsgcAvaloniaStatusBar | .NET, Avalonia |
| Doel | Component | Platformen |
|---|---|---|
| Delphi 7 tot 13, VCL | TsgcVCLToolbar, TsgcVCLStatusBar | Win32 en Win64 |
| Delphi XE6 tot 13, FireMonkey | TsgcFMXToolbar, TsgcFMXStatusBar | Windows, macOS, iOS, Android en Linux (FMXLinux) |
| C++ Builder 2007 tot 13 | VCL- en FireMonkey-balken | Gegenereerde .hpp-headers en statische bibliotheken |
| Delphi 10.2 tot 13, frameworkneutraal | Modellen en headless PNG- en SVG-renderer | Linux64, bijvoorbeeld om een werkbalk op een server te renderen |
| .NET Framework 4.7.2, .NET 8, 9 en 10 | TsgcWinFormsToolbar, WPF- en Avalonia-balken | WinForms, WPF en Avalonia |
Ja. SetPanelText, SetProgress en SetIndicator mogen vanuit elke thread worden aangeroepen, zonder Synchronize of Queue. Het model beschermt de waarden met een lock en de balk tekent opnieuw op de hoofdthread. Elke andere eigenschap zet je vanuit de hoofdthread. Zie Threadveilige updates.
Het dekt dezelfde taken: knoppen, schakelaars, dropdownknoppen, scheidingslijnen en labels bovenaan, tekstpanelen onderaan. Het voegt een spacer-item, voortgangs- en indicatorpanelen, threadveilige setters, thema's en headless uitvoer toe. Je bestaande TActionList- en TPopupMenu-componenten sluiten aan via Action en DropdownMenu.
De Ribbon en het Ribbon-formulier, het overflowmenu en de actielinks van de items, die in .NET Command en CommandParameter zijn. In Community worden de items die niet passen afgeknipt. Alle andere functies, waaronder de threadveilige statusupdates, de voortgangs- en indicatorpanelen en de headless uitvoer, zitten in Community.
Ja. C++ Builder 2007 tot 13 gebruiken dezelfde VCL- en FireMonkey-balken via gegenereerde headers en bibliotheken, en de demo's EditorShell en LiveStatus worden ook als C++ Builder-projecten meegeleverd. Het tabblad Code op deze pagina toont dezelfde werkbalk in Delphi, C++ Builder en C#.
Ja. Alle afmetingen zijn logische pixels vermenigvuldigd met de schaal van de monitor, en de pictogramplek is 16 logische pixels, dus knoppen, glyphs, voortgangsbalken en indicatorstippen blijven bij elke DPI scherp. FireMonkey neemt afbeeldingen uit de afbeeldingenlijst op de apparaatgrootte van het frame.
Ja. SaveToSVG en SaveToPNG van TsgcToolbarModel en TsgcStatusBarModel tekenen de balken zonder venster, ook op Linux64 vanaf Delphi 10.2, zodat een buildstap de afbeeldingen van je handleiding voor elke release opnieuw kan genereren. Een schaalparameter geeft scherpe afbeeldingen voor high-DPI-schermen en afdrukken.
Introductie, Quick Start VCL, Quick Start FireMonkey, TsgcVCLToolbar, TsgcVCLStatusBar, Itemsoorten, Overzicht van de Ribbon, KeyTips van de Ribbon, Backstage van de Ribbon, Statuspanelen, Threadveilige updates, Edities, Platformen.
Introductie, Quick Start C++ Builder, TsgcVCLToolbar, TsgcVCLStatusBar, Demo's.
.NET-overzicht, Quick Start WinForms, Quick Start WPF, Quick Start Avalonia, Verschillen met Delphi.
Delphi, C++ Builder en .NET, voor elk sgcUI-product.
Voeg een zijbalk of accordeon met dezelfde thematokens toe en de werkbalk, statusbalk en het menu vormen één applicatieschil.
sgcNavigation ontdekken →
Zet datumkiezers, schuifregelaars en tokeninvoer in de formulieren onder de werkbalk, met hetzelfde thema en dezelfde accentkleur.
sgcEditors ontdekken →
Combineer de statusbalk met een live datagrid en toon het aantal rijen, het filter en de feedstatus als panelen.
sgcGrid ontdekken →