sgcToolbar : barre d'outils et barre d'état pour Delphi, C++ Builder et .NET

Barre d'outils et barre d'étatSix types d'éléments en haut, des panneaux de texte, de progression et d'indicateur en bas.
État thread-safeDéfinis le texte, la progression et les indicateurs des panneaux depuis des threads de travail, sans Synchronize.
Ribbon, sur tous les frameworksOnglets, galeries, KeyTips et backstage sur VCL, FireMonkey, WinForms, WPF et Avalonia.
Rendu sans interfaceGénère les deux barres en PNG ou en SVG sans fenêtre, Linux64 compris.

FONCTIONNALITÉS CLÉS

Une barre de commandes et d'état complète

Quatorze fonctionnalités pour les barres dont toute application de bureau a besoin, d'un Ribbon complet et des groupes radio à la progression en direct depuis un thread de travail.

Ribbon

Un Ribbon de style Office pour les applications qui ont plus de commandes qu'une barre d'outils ne peut en contenir, sur tous les frameworks sgcUI.

Ribbon Enregistrée uniquement

Un Ribbon qui s'adapte, avec KeyTips et vue backstage

Tes utilisateurs ouvrent un éditeur de rapports sur un portable, ancrent la fenêtre sur la moitié de l'écran et attendent toujours de pouvoir atteindre chaque commande. Le Ribbon le permet. Les commandes vivent dans des onglets et des groupes, et quand la fenêtre se rétrécit chaque groupe passe de grands boutons à des boutons moyens puis petits, et finit réduit à un seul bouton, selon la priorité que tu définis. Le Ribbon défile quand tout est réduit. Les galeries passent de lignes complètes à moins de colonnes puis à une liste déroulante. Appuie sur Alt et les KeyTips apparaissent, tape l'onglet et la commande, et Échap revient d'un pas. Le bouton d'application ouvre une vue backstage avec des commandes et des pages qui contiennent tes propres contrôles. Une barre d'accès rapide se place au-dessus ou en dessous du Ribbon, et les utilisateurs la personnalisent depuis un menu ou par clic droit.

Onglets, groupes et onglets contextuels avec une bande de couleur, plus des lanceurs de boîte de dialogue
Grands et petits boutons, boutons fractionnés, listes déroulantes, bascules, cases à cocher, listes modifiables et zones de saisie
Double clic sur un onglet ou Ctrl+F1 pour réduire le Ribbon
Thèmes clair, sombre et à contraste élevé qui suivent le thème de l'application
De droite à gauche, haute résolution (DPI) et UI Automation pour les lecteurs d'écran
Liaison d'actions sous Delphi, ICommand sous .NET et déclaration XAML sous WPF et Avalonia
SaveLayout et LoadLayout conservent en JSON la barre d'accès rapide de chaque utilisateur et l'état réduit

Édition enregistrée sur VCL, FireMonkey, WinForms, WPF et Avalonia, Delphi 7 à 13 et C++ Builder. Community ne comprend pas le Ribbon. Les KeyTips fonctionnent sur le bureau Windows. La barre d'accès rapide a sa propre ligne, ou le formulaire Ribbon la dessine dans la barre de titre de la fenêtre.

Présentation du Ribbon
Disposition adaptative
Galeries
KeyTips
Vue backstage
Barre d'accès rapide

Ribbon Enregistrée uniquement

Un formulaire Ribbon avec la barre d'accès rapide dans la barre de titre

Une application Office n'a pas de barre de titre Windows grise au-dessus de son Ribbon. La barre d'accès rapide et le nom du document se trouvent dans la barre de titre, et la barre de titre et le Ribbon forment une seule surface. Le formulaire Ribbon donne le même cadre à votre fenêtre. Déposez-le sur le formulaire et choisissez le Ribbon : sgcUI supprime la barre de titre native et dessine une barre de titre thématisée avec l'icône de la fenêtre, la barre d'accès rapide, le titre centré sur la fenêtre et les boutons Réduire, Agrandir et Fermer, dans la couleur de la ligne d'onglets du thème du Ribbon, Classic ou Fluent, clair ou sombre. Le Ribbon se place juste en dessous et compte une ligne de moins. La fenêtre conserve son ombre, ses bords de redimensionnement et son comportement une fois agrandie, Windows 11 affiche les dispositions Snap sur le bouton Agrandir, et l'espace vide de la barre de titre déplace la fenêtre.

TsgcVCLRibbonForm et TsgcFMXRibbonForm en Delphi et C++ Builder, TsgcWinFormsRibbonForm, TsgcWpfRibbonWindow et TsgcAvaloniaRibbonWindow en .NET
La barre d'accès rapide de la barre de titre est celle du Ribbon : mêmes clics, mêmes Actions, mêmes info-bulles, mêmes KeyTips et même menu de personnalisation
Avec QATPosition sur rqpBelow ou ShowQAT désactivé, la barre de titre n'affiche que le titre, et Afficher au-dessus du Ribbon remonte la barre
CaptionAlignment centre le titre ou le place après l'icône, et TitleBarHeight fixe la hauteur
En WPF et Avalonia, la propriété attachée Ribbon de la fenêtre la configure depuis XAML

Édition enregistrée, comme le Ribbon : Community ne comprend pas le formulaire Ribbon. Le cadre thématisé exige Windows avec la composition du bureau, et sous FireMonkey il n'est appliqué que sur Windows. Sans lui, le Ribbon affiche sa propre ligne de barre d'accès rapide.

Lire la rubrique d'aide
Formulaire Ribbon .NET

Commandes

Tous les éléments dont une barre de commandes a besoin, avec le regroupement, les menus et le débordement gérés par le contrôle.

Commandes

Tous les types d'éléments de barre d'outils dans un seul contrôle

Une vraie barre d'outils d'application mélange des boutons simples, des boutons qui restent enfoncés, des boutons avec un menu, des séparateurs et un peu de texte. Avec sgcToolbar, chacun est un élément de la même collection, et Kind décide de la façon dont il est dessiné et dont il réagit. Les éléments sont disposés de gauche à droite avec Spacing entre eux, et un espaceur prend la largeur libre, ce qui permet de repousser Aide ou un nom d'utilisateur au bord droit sans code de mise en page. Width fixe un élément quand tu as besoin d'une taille stable. Les infobulles, les états désactivés et le survol sont dessinés pour chaque type.

tikButton, tikToggle et tikDropdown pour les commandes
tikSeparator dessine un fin trait vertical
tikSpacer repousse les éléments suivants vers la droite
tikLabel affiche du texte dans la barre

Lire la rubrique d'aide

Commandes

Des groupes radio sans code

L'alignement du texte, les modes d'affichage et les outils de dessin sont des choix classiques parmi plusieurs. Donne le même GroupIndex à plusieurs bascules et elles forment un groupe radio : mettre Down sur l'une d'elles, par un clic ou depuis le code, relâche les autres, et un clic sur l'élément déjà enfoncé le laisse enfoncé, donc un choix reste toujours sélectionné. Une bascule avec GroupIndex 0 est un simple interrupteur comme Gras ou Retour à la ligne. Le clic inverse Down avant le déclenchement de OnItemClick, donc ton gestionnaire lit le nouvel état. Aucun câblage d'événement n'est nécessaire pour garder le groupe cohérent.

GroupIndex supérieur à 0 crée un groupe radio
Down lit ou définit l'état depuis le code
L'état enfoncé est dessiné avec une teinte d'accentuation
Une action liée pilote Down via son Checked

Lire la rubrique d'aide

Commandes Enregistrée uniquement

Les utilisateurs redimensionnent les fenêtres, et une barre d'outils qui coupe simplement ses derniers boutons cache des commandes dont ils ont besoin. Quand les éléments ne tiennent pas, sgcToolbar déplace les derniers dans une liste de débordement et dessine un bouton à double chevron à l'extrémité droite. Un clic affiche OverflowMenu, construit à l'exécution avec une entrée par élément masqué, et choisir une entrée agit exactement comme un clic : une bascule s'inverse, OnItemClick se déclenche et une liste déroulante affiche son menu. Le modèle te dit ce qui est masqué. Quand la fenêtre s'agrandit de nouveau, les éléments reviennent dans la barre d'eux-mêmes.

OverflowMenu est construit pour toi à l'exécution
HasOverflow, OverflowCount et InOverflow par élément
ItemAtPos signale un clic sur le bouton de débordement
Compilé sous SGC_TOOLBAR_ADVANCED

Community : les éléments qui ne tiennent pas sont coupés, il n'y a pas de bouton de débordement.

Lire la rubrique d'aide

Commandes Enregistrée uniquement

Réutilise tes TAction

Si tes commandes vivent déjà dans une TActionList, la barre d'outils ne doit pas les dupliquer. Relie un élément à n'importe quelle TAction VCL ou FireMonkey via sa propriété Action et il suit les Caption, Enabled, Visible, Hint, ImageIndex et Checked de l'action. Un clic exécute l'action avec la barre comme ActionComponent, sauf si l'élément a un gestionnaire OnClick. Les barres appellent InitiateAction en temps libre, donc une action désactivée désactive son bouton sans code supplémentaire. En .NET, l'élément a Command et CommandParameter pour ICommand. Une seule TActionList peut piloter ensemble la barre d'outils, le menu principal et la barre de navigation.

Action relie un élément à n'importe quelle TBasicAction
Le Checked de l'action pilote le Down d'une bascule
Le OnUpdate des actions s'exécute en temps libre
.NET : Command et CommandParameter

Community : gère le OnClick de l'élément ou le OnItemClick de la barre à la place d'une action.

Lire la rubrique d'aide

Barre d'état

Une barre d'état qui se dispose toute seule, affiche la progression et l'état, et accepte les mises à jour depuis n'importe quel thread.

Barre d'état

Des panneaux d'état qui se disposent d'eux-mêmes

Ligne et colonne, un nom de fichier, l'état d'enregistrement et un message principal se disputent le bord inférieur de la fenêtre. TsgcVCLStatusBar dispose ses Panels de gauche à droite en trois passes : les panneaux fixes prennent leur Width, les panneaux AutoSize prennent la largeur de leur texte et les panneaux Spring se partagent ce qui reste. Utilise un panneau Spring pour le message principal et la barre reste propre à toutes les tailles de fenêtre. Un fin trait sépare les panneaux, et OnPanelClick t'indique lequel a reçu le clic. Les panneaux forment une collection, donc tu peux les ajouter et les modifier dans l'inspecteur d'objets à la conception.

Panneaux spkText avec Alignment et Hint
Les panneaux Spring se partagent la largeur libre
Les panneaux AutoSize s'adaptent à leur texte
OnPanelClick signale un clic sur un panneau

Lire la rubrique d'aide

Barre d'état

Barres de progression et indicateurs d'état

Les opérations longues ont besoin d'une barre de progression, et les connexions actives d'un voyant qui dit si tout va bien. Un panneau peut être une barre de progression remplie à Progress pour cent dans la couleur d'accentuation, ou un indicateur : un point coloré suivi du texte du panneau. IndicatorState choisit éteint, ok, avertissement ou erreur, avec un vert, un ambre et un rouge réglés séparément pour le thème clair et le thème sombre. Il convient à l'état d'une connexion à une base de données, d'un flux de données ou d'une synchronisation en arrière-plan. Définis Progress ou IndicatorState et le panneau se redessine, il n'y a aucun code de dessin à écrire.

spkProgress avec Progress de 0 à 100
spkIndicator avec IndicatorState
sisOff, sisOk, sisWarning, sisError
GetIndicatorColor renvoie la couleur pour le thème

Lire la rubrique d'aide

Barre d'état

Mets à jour la barre d'état depuis un thread de travail

Les téléchargements, les flux et les longs calculs tournent dans des threads de travail, et renvoyer chaque mise à jour d'état vers le thread principal est fastidieux et facile à mal faire. SetPanelText, SetProgress et SetIndicator peuvent être appelés depuis n'importe quel thread sans Synchronize ni Queue. Le modèle protège les valeurs par un verrou et ne déclenche OnChange que lorsqu'une valeur a vraiment changé, donc répéter la même valeur ne coûte rien. La barre VCL poste alors un message à sa fenêtre et la barre FireMonkey met le redessin en file, donc l'interface n'est jamais touchée hors du thread principal. Un thread qui survit à un panneau est lui aussi sans danger.

SetPanelText, SetProgress, SetIndicator depuis n'importe quel thread
Aucun Synchronize ni Queue dans ton code
Les valeurs inchangées ne coûtent rien
Un index hors limites est ignoré, jamais levé en erreur

Lire la rubrique d'aide

Aspect, clavier et rendu

Icônes, thèmes et prise en charge du clavier cohérents avec le reste de sgcUI, plus des images des barres pour ta documentation.

Aspect, clavier et rendu

Icônes ou lettres de glyphe, libellés facultatifs

Chaque élément cliquable a un emplacement d'icône de 16 pixels logiques. Il affiche l'image à ImageIndex de la liste Images de la barre ou, quand un élément n'a pas d'image, son Glyph : une lettre ou un court symbole qui n'a besoin d'aucune liste d'images. Désactive ShowCaptions pour une barre compacte avec les seules icônes, et le libellé devient l'infobulle, donc rien n'est perdu. Les listes d'images VCL sont converties une seule fois en ARGB direct avec l'alpha récupéré et mises en cache jusqu'à ce que la liste change, donc les listes masquées et 32 bits s'affichent bien. Mélange les deux librement tant que les icônes sont en cours de conception.

Images et ImageIndex pour les listes d'images
Glyph quand il n'y a pas d'image
ShowCaptions à False pour les icônes seules
Listes d'images FireMonkey à partir de Delphi XE8
De droite à gauche pour l'arabe et l'hébreu : les éléments s'écoulent depuis la droite, et MirrorGlyph retourne les icônes directionnelles comme précédent, suivant, annuler et rétablir

Lire la rubrique d'aide

Aspect, clavier et rendu

Clair, sombre et ta couleur d'accentuation

Les barres prennent leurs couleurs dans les jetons de thème de sgcUICore, les mêmes que ceux de tous les produits de la suite, donc une barre d'outils au-dessus d'un sgcGrid et à côté d'une barre sgcNavigation ressemble à une seule application. Theme choisit utLight ou utDark, et AccentColor remplace l'accentuation utilisée par l'anneau de focus, la teinte enfoncée des bascules et les barres de progression. Les états survol, appui, enfoncé, focus et désactivé sont tous dérivés pour toi. Chaque barre a son propre Theme, donc définis-le sur la barre d'outils et sur la barre d'état. Changer à l'exécution redessine les deux barres d'un coup.

Theme : utDefault (par défaut, suit le thème de l'application), utLight ou utDark
AccentColor comme $AARRGGBB, 0 conserve l'accentuation du thème
Les couleurs des indicateurs suivent le thème
Change à l'exécution pour un interrupteur de mode sombre

Lire la rubrique d'aide

Aspect, clavier et rendu

Accès au clavier et poignée de redimensionnement fonctionnelle

La barre d'outils peut entrer dans l'ordre de tabulation quand tes utilisateurs en ont besoin : active TabStop et le bouton qui a le focus affiche un anneau de focus, Gauche et Droite passent d'un bouton activé à l'autre, Début et Fin sautent, Entrée ou Espace active. C'est désactivé par défaut, donc la barre d'outils ne prend jamais le focus à l'éditeur situé dessous. ClickItem active un élément depuis le code, par exemple depuis un raccourci de la fiche. Sur la barre d'état, SizeGrip dessine les points de la poignée, et en VCL les faire glisser redimensionne une fiche redimensionnable. En FireMonkey la poignée est dessinée mais ne redimensionne pas la fiche, donc désactive SizeGrip quand la fiche n'est pas redimensionnable.

TabStop en VCL, CanFocus en FireMonkey
ClickItem exécute un élément depuis le code
SizeGrip et GripRect sur la barre d'état
La poignée ne redimensionne la fiche que si elle est redimensionnable

Lire la rubrique d'aide

Aspect, clavier et rendu

Dessine les deux barres sans fenêtre

Les captures d'écran d'une barre d'outils dans un manuel se périment à chaque version. Le moteur de rendu de sgcToolbar_Render dessine un TsgcToolbarModel ou un TsgcStatusBarModel sans fenêtre et sans VCL ni FireMonkey, donc un programme console, un test ou un serveur web peut produire les mêmes barres sous forme d'image. SaveToPNG et SaveToSVG prennent une taille en pixels logiques et une échelle, donc 560 par 44 à l'échelle 2 donne une image nette de 1120 par 88. Les unités se compilent sur toutes les plateformes, Linux64 compris. Passe tes propres images via OnGetImage et l'image correspond à l'application en cours d'exécution.

SaveToPNG écrit un fichier ou un flux PNG
SaveToSVG écrit la même barre en SVG
Fonctionne sur TsgcToolbarModel et TsgcStatusBarModel
OnGetImage fournit les icônes au rendu sans interface

Lire la rubrique d'aide

EN ACTION

Découvre sgcToolbar en action

sgcToolbar dans les démos de la suite sgcUI : des applications complètes qui fonctionnent hors ligne avec des données simulées intégrées.

Une barre supérieure avec Inject event, boutons de vitesse et sélecteur de thème, barre d'état en dessous.
Altamira Fleet →

La barre supérieure de l'ERP avec recherche, Nouveau, notifications et menu utilisateur.
Altamira ERP →

La barre supérieure du PMO avec Reset what-if et le sélecteur de thème.
Altamira PMO →

La barre supérieure de l'usine avec Inject fault, Acknowledge all et commandes de vitesse.
Altamira Plant →

Voir toutes les démos de la suite

CAPTURES D'ÉCRAN

sgcToolbar en action

Theme = utLight ou utDark restyle la barre d'outils et la barre d'état, poignée de redimensionnement comprise.

Panneaux spkText, spkProgress et spkIndicator : position du curseur, progression à 64 pour cent et indicateur sisWarning.

ShowCaptions = True affiche le texte à côté de chaque glyphe ; False garde une barre compacte avec les seuls glyphes.

CAS D'USAGE

Qui construit avec sgcToolbar

Éditeurs de documents et de code

Un éditeur a besoin de bascules Gras et Italique, d'un groupe radio d'alignement, d'un menu Zoom et d'une barre d'état avec la ligne, la colonne et l'état d'enregistrement. sgcToolbar couvre tout cela avec une seule collection d'éléments et une seule collection de panneaux, reliées à la TActionList que tu as déjà. Quand la fenêtre se rétrécit, le menu de débordement garde chaque commande accessible. La démo EditorShell construit exactement cela autour d'un TMemo.

Types d'éléments
Groupes radio
Menu de débordement

Lance la démo EditorShell

Outils de longue durée et flux en direct

Les outils d'import, les clients de synchronisation et les applications de supervision travaillent dans des threads d'arrière-plan et doivent le signaler. Appelle SetProgress, SetIndicator et SetPanelText directement depuis le thread de travail, et la barre d'état se redessine dans le thread principal sans Synchronize dans ton code. L'indicateur passe au vert, à l'ambre ou au rouge selon l'état de la tâche. La démo LiveStatus simule un téléchargement qui fait exactement cela.

Mises à jour thread-safe
Panneaux de progression
Indicateurs

Lance la démo LiveStatus

Une seule barre de commandes sur toutes les plateformes

Une application FireMonkey livrée sous Windows, macOS et mobile mérite la même barre d'outils partout. TsgcFMXToolbar et TsgcFMXStatusBar ont les mêmes éléments, panneaux et événements que les barres VCL, et les barres .NET pour WinForms, WPF et Avalonia suivent les mêmes noms. EditorShellFMX est la version FireMonkey de la structure d'éditeur, avec les mêmes éléments, le même menu de débordement et les mêmes panneaux d'état.

Barres FireMonkey
Thèmes
Panneaux d'état

Lance la démo EditorShellFMX

DÉMARRAGE RAPIDE

Une barre d'outils et une barre d'état en quelques lignes

La même API en Delphi, C++ Builder et C# : une bascule, un groupe radio, une liste déroulante et une barre d'état mise à jour depuis le gestionnaire de clic.

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;

Une fenêtre de style Office : TsgcVCLRibbonForm déplace la barre d'accès rapide et le titre centré dans une barre de titre thématisée.

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.WinForms

Télécharger l'essai

DÉMOS

Lance les démos de sgcToolbar

Les démos EditorShell et LiveStatus sont fournies pour VCL et C++ Builder, avec en plus une version FireMonkey pour Delphi, et dans l'édition .NET sous forme de projets WinForms, WPF et Avalonia. L'édition enregistrée ajoute les démos du Ribbon, RibbonShell, RibbonForm et RibbonSuite.

Enregistrée uniquement EditorShell

Une structure d'éditeur TMemo avec des bascules, un groupe radio Gauche, Centre et Droite, une liste déroulante Zoom, des liens TActionList, le menu de débordement, des panneaux ligne et colonne et une bascule Dark. Elle utilise le débordement et les actions, donc elle demande l'édition Enregistrée ou l'essai.

LiveStatus

Un thread de travail simule un téléchargement et alimente un panneau de texte, un panneau de progression et un indicateur qui passe au vert, à l'ambre ou au rouge, avec des boutons Start et Stop. Elle se compile avec l'édition Community.

Enregistrée uniquement EditorShellFMX

La démo EditorShell avec un TsgcFMXToolbar et un TsgcFMXStatusBar autour d'un TMemo FireMonkey, pour Delphi uniquement : les mêmes éléments, liens d'action, menu de débordement et panneaux d'état.

Enregistrée uniquement RibbonShell

Un shell de document autour d'un Ribbon avec onglets, groupes, une galerie, un onglet contextuel, la barre d'accès rapide, les KeyTips et une vue backstage. RibbonShell est la démo VCL et RibbonShellFMX celle de FireMonkey, toutes deux avec leurs jumelles C++ Builder. RibbonShell, RibbonShellWpf et RibbonShellAvalonia sont les projets .NET.

Enregistrée uniquement RibbonForm et RibbonFormFMX

Une fenêtre d'éditeur de style Office, pour la VCL et pour FireMonkey, avec des jumeaux C++ Builder : la barre d'accès rapide avec Enregistrer, Annuler et Rétablir dans la barre de titre à côté de l'icône de la fenêtre, le titre centré, et un Ribbon avec le bouton Fichier et les onglets Accueil, Insertion et Affichage juste en dessous. Une case à cocher place la barre d'accès rapide sous le Ribbon, une autre désactive le cadre thématisé, et le sélecteur de thème bascule entre Clair, Sombre et Fluent. Dans l'édition .NET, la démo est fournie sous les noms RibbonForm pour WinForms, RibbonFormWpf et RibbonFormAvalonia.

Enregistrée uniquement RibbonSuite

Un seul Ribbon qui pilote plusieurs produits sgcUI depuis un même formulaire : ses commandes agissent sur les autres contrôles sgcUI de la suite.

Démos compilées

Des exécutables prêts à lancer pour chaque produit sgcUI, rien à installer.

Télécharger sgcUI_bin.zip →

Guide Getting Started

Cinq démos QuickStart pour Delphi (VCL) sont livrées dans Demos\Toolbar\Delphi\00.QuickStart. Le guide PDF les parcourt pas à pas : une première barre d'outils, chaque type d'élément, les actions et une barre d'état, les thèmes, et un petit éditeur de texte.

Télécharger le guide (PDF, en anglais) →

ÉDITIONS

Où sgcToolbar est inclus

sgcToolbar est dans toutes les éditions sgcUI, à partir de Standard, et il est aussi vendu seul. sgcToolbar est également inclus dans le pack All-Access.

sgcToolbar, package seul

€149 / développeur, code source complet, 1 an de mises à jour.

Acheter sgcToolbar → Voir les tarifs →

sgcUI Standard

sgcToolbar, sgcGrid, sgcNavigation et sgcEditors, à partir de €380.

Voir Standard →

sgcUI Professional

Standard plus sgcCharts, sgcDashboard et sgcGauges, à partir de €529.

Voir Professional →

sgcUI Enterprise

Les 17 produits sgcUI, à partir de €699.

Voir Enterprise →

L'édition Community gratuite (esegece.sgcToolbar.Community sur NuGet) ne comprend ni le Ribbon ni le formulaire Ribbon, ni le menu de débordement, ni les liens d'action.

Fonctionnalité	Community (gratuite)	Enregistrée
Tous les types d'éléments, bascules, groupes radio et menus déroulants	✓	✓
Panneaux de texte, de progression et d'indicateur	✓	✓
Mises à jour d'état thread-safe	✓	✓
Icônes, glyphes, thèmes, clavier et poignée de redimensionnement	✓	✓
Rendu PNG et SVG sans interface	✓	✓
Ribbon avec KeyTips, galeries, barre d'accès rapide et vue backstage	−	✓
Formulaire Ribbon : barre d'accès rapide et titre dans une barre de titre thématisée	−	✓
Menu de débordement	−	✓
Liens d'action (Delphi) et Command (.NET)	−	✓

PLATEFORMES

Frameworks et plateformes pris en charge

Composants de sgcToolbar

Composant	Cible
TsgcVCLToolbar, TsgcVCLStatusBar	Delphi et C++ Builder, VCL (sgcToolbar_VCL)
TsgcFMXToolbar, TsgcFMXStatusBar	Delphi et C++ Builder, FireMonkey (sgcToolbar_FMX)
Le Ribbon	Édition enregistrée : VCL, FireMonkey, WinForms, WPF et Avalonia
TsgcVCLRibbonForm, TsgcFMXRibbonForm	Édition enregistrée : Delphi et C++ Builder, VCL et FireMonkey (sgcToolbar_RibbonForm_VCL, sgcToolbar_RibbonForm_FMX), la barre de titre thématisée sous Windows
TsgcWinFormsRibbonForm, TsgcWpfRibbonWindow, TsgcAvaloniaRibbonWindow	Édition enregistrée : .NET, WinForms, WPF et Avalonia
TsgcToolbarItem, TsgcStatusBarPanel, TsgcToolbarModel, TsgcStatusBarModel	Modèles indépendants du framework (sgcToolbar_Model)
TsgcWinFormsToolbar, TsgcWinFormsStatusBar	.NET, WinForms
TsgcWpfToolbar, TsgcWpfStatusBar	.NET, WPF
TsgcAvaloniaToolbar, TsgcAvaloniaStatusBar	.NET, Avalonia

Cible	Composant	Plateformes
Delphi 7 à 13, VCL	TsgcVCLToolbar, TsgcVCLStatusBar	Win32 et Win64
Delphi XE6 à 13, FireMonkey	TsgcFMXToolbar, TsgcFMXStatusBar	Windows, macOS, iOS, Android et Linux (FMXLinux)
C++ Builder 2007 à 13	Barres VCL et FireMonkey	En-têtes .hpp générés et bibliothèques statiques
Delphi 10.2 à 13, indépendant du framework	Modèles et moteur de rendu PNG et SVG sans interface	Linux64, par exemple pour dessiner une barre d'outils sur un serveur
.NET Framework 4.7.2, .NET 8, 9 et 10	TsgcWinFormsToolbar, barres WPF et Avalonia	WinForms, WPF et Avalonia

FAQ

Foire aux questions

Oui. SetPanelText, SetProgress et SetIndicator peuvent être appelés depuis n'importe quel thread sans Synchronize ni Queue. Le modèle protège les valeurs par un verrou et la barre se redessine dans le thread principal. Toutes les autres propriétés se définissent depuis le thread principal. Voir Mises à jour thread-safe.

Elle couvre les mêmes tâches : boutons, bascules, boutons déroulants, séparateurs et étiquettes en haut, panneaux de texte en bas. Elle ajoute un élément espaceur, des panneaux de progression et d'indicateur, des accesseurs thread-safe, des thèmes et le rendu sans interface. Tes composants TActionList et TPopupMenu existants se branchent via Action et DropdownMenu.

Le Ribbon et le formulaire Ribbon, le menu de débordement et les liens d'action des éléments, qui sont Command et CommandParameter en .NET. Dans Community, les éléments qui ne tiennent pas sont coupés. Toutes les autres fonctionnalités, dont les mises à jour d'état thread-safe, les panneaux de progression et d'indicateur et le rendu sans interface, sont dans Community.

Oui. C++ Builder 2007 à 13 utilisent les mêmes barres VCL et FireMonkey via des en-têtes et des bibliothèques générés, et les démos EditorShell et LiveStatus sont aussi fournies comme projets C++ Builder. L'onglet de code de cette page montre la même barre d'outils en Delphi, C++ Builder et C#.

Oui. Toutes les tailles sont des pixels logiques multipliés par l'échelle du moniteur, et l'emplacement d'icône fait 16 pixels logiques, donc les boutons, les glyphes, les barres de progression et les points d'indicateur restent nets à toute densité. FireMonkey prend les images de la liste d'images à la taille de périphérique du cadre.

Oui. SaveToSVG et SaveToPNG de TsgcToolbarModel et TsgcStatusBarModel dessinent les barres sans fenêtre, y compris sous Linux64 à partir de Delphi 10.2, donc une étape de compilation peut régénérer les images de ton manuel à chaque version. Un paramètre d'échelle donne des images nettes pour les écrans haute densité et l'impression.

DOCUMENTATION

Aide de sgcToolbar

Manuels PDF

Delphi, C++ Builder et .NET, couvrant tous les produits sgcUI.

ASSOCIÉS

Fonctionne bien avec

sgcNavigation

Ajoute une barre latérale ou un accordéon avec les mêmes jetons de thème et la barre d'outils, la barre d'état et le menu forment une seule structure d'application.

Explorer sgcNavigation →

sgcEditors

Place des sélecteurs de date, des curseurs et des champs à jetons dans les fiches sous la barre d'outils, avec le même thème et la même couleur d'accentuation.

Explorer sgcEditors →

sgcGrid

Associe la barre d'état à une grille de données en direct et affiche le nombre de lignes, le filtre et l'état du flux sous forme de panneaux.

Explorer sgcGrid →

sgcToolbar, la barre d'outils et la barre d'état pour Delphi, C++ Builder & .NET

Une barre de commandes et d'état complète

Ribbon

Un Ribbon qui s'adapte, avec KeyTips et vue backstage

Un formulaire Ribbon avec la barre d'accès rapide dans la barre de titre

Commandes

Tous les types d'éléments de barre d'outils dans un seul contrôle

Des groupes radio sans code

Des menus déroulants depuis ton menu contextuel

Les éléments qui ne tiennent pas passent dans un menu de débordement

Réutilise tes TAction

Barre d'état

Des panneaux d'état qui se disposent d'eux-mêmes

Barres de progression et indicateurs d'état

Mets à jour la barre d'état depuis un thread de travail

Aspect, clavier et rendu

Icônes ou lettres de glyphe, libellés facultatifs

Clair, sombre et ta couleur d'accentuation

Accès au clavier et poignée de redimensionnement fonctionnelle

Dessine les deux barres sans fenêtre

Découvre sgcToolbar en action

sgcToolbar en action

Qui construit avec sgcToolbar

Éditeurs de documents et de code

Outils de longue durée et flux en direct

Une seule barre de commandes sur toutes les plateformes

Une barre d'outils et une barre d'état en quelques lignes

Lance les démos de sgcToolbar

Enregistrée uniquement EditorShell

LiveStatus

Enregistrée uniquement EditorShellFMX

Enregistrée uniquement RibbonShell

Enregistrée uniquement RibbonForm et RibbonFormFMX

Enregistrée uniquement RibbonSuite

Démos compilées

Guide Getting Started

Où sgcToolbar est inclus

sgcToolbar, package seul

sgcUI Standard

sgcUI Professional

sgcUI Enterprise

Frameworks et plateformes pris en charge

Composants de sgcToolbar

Foire aux questions

Aide de sgcToolbar

Delphi

C++ Builder

.NET

Manuels PDF

Fonctionne bien avec

sgcNavigation

sgcEditors

sgcGrid

Essaie sgcToolbar dès aujourd'hui