sgcToolbar: Barra de Ferramentas e Barra de Status para Delphi, C++ Builder e .NET

Barra de ferramentas e barra de statusSeis tipos de item no alto, painéis de texto, de progresso e de indicador embaixo.
Status thread-safeDefina texto, progresso e indicadores dos painéis a partir de threads de trabalho, sem Synchronize.
Ribbon, em todo frameworkAbas, galerias, KeyTips e backstage em VCL, FireMonkey, WinForms, WPF e Avalonia.
Saída headlessRenderize as duas barras em PNG ou SVG sem janela, inclusive no Linux64.

PRINCIPAIS RECURSOS

Uma Barra de Comandos e de Status Completa

Quatorze recursos para as barras de que toda aplicação desktop precisa, de um Ribbon completo e grupos de opção ao progresso ao vivo vindo de uma thread de trabalho.

Ribbon

Um Ribbon no estilo Office para aplicações com mais comandos do que uma barra de ferramentas comporta, em todos os frameworks do sgcUI.

Ribbon Somente Registrada

Um Ribbon que se adapta, com KeyTips e exibição backstage

Seus usuários abrem um editor de relatórios em um notebook, encaixam a janela em metade da tela e ainda esperam alcançar todos os comandos. O Ribbon mantém isso possível. Os comandos ficam em abas e grupos, e quando a janela estreita cada grupo passa de botões grandes para médios e pequenos e por fim se recolhe em um único botão, pela prioridade que você definir. O Ribbon rola quando tudo está recolhido. As galerias passam de linhas completas para menos colunas e depois para um menu suspenso. Pressione Alt e os KeyTips aparecem, digite a aba e o comando, e Esc volta um passo. O botão de aplicação abre uma exibição backstage com comandos e com páginas que guardam seus próprios controles. Uma barra de acesso rápido fica acima ou abaixo do Ribbon, e os usuários a personalizam por um menu ou com o botão direito.

Abas, grupos e abas contextuais com uma faixa de cor, além de iniciadores de caixa de diálogo
Botões grandes e pequenos, botões divididos, menus suspensos, botões de alternância, caixas de seleção, caixas de combinação e caixas de edição
Clique duas vezes em uma aba ou pressione Ctrl+F1 para minimizar o Ribbon
Temas claro, escuro e de alto contraste que acompanham o tema da aplicação
Da direita para a esquerda, DPI alto e UI Automation para leitores de tela
Vínculo de actions no Delphi, ICommand no .NET e declaração XAML no WPF e no Avalonia
SaveLayout e LoadLayout guardam em JSON a barra de acesso rápido de cada usuário e o estado minimizado

Edição Registrada em VCL, FireMonkey, WinForms, WPF e Avalonia, Delphi 7 a 13 e C++ Builder. A Community não inclui o Ribbon. Os KeyTips funcionam no desktop Windows. A barra de acesso rápido tem a sua própria linha, ou o formulário Ribbon a desenha na barra de título da janela.

Visão geral do Ribbon
Layout adaptativo
Galerias
KeyTips
Exibição backstage
Barra de acesso rápido

Ribbon Somente Registrada

Um formulário Ribbon com a barra de acesso rápido na barra de título

Uma aplicação Office não tem uma barra de título cinza do Windows acima do Ribbon. A barra de acesso rápido e o nome do documento ficam na barra de título, e a barra de título e o Ribbon parecem uma única superfície. O formulário Ribbon dá à sua janela a mesma moldura. Solte-o no formulário e escolha o Ribbon: o sgcUI remove a barra de título nativa e desenha uma barra de título com tema, com o ícone da janela, a barra de acesso rápido, a legenda centralizada na janela e os botões de minimizar, maximizar e fechar, na cor da linha de abas do tema do Ribbon, Classic ou Fluent, claro ou escuro. O Ribbon fica logo abaixo e tem uma linha a menos. A janela mantém a sombra, as bordas de redimensionamento e o comportamento de maximizada, o Windows 11 mostra os snap layouts no botão de maximizar, e o espaço vazio da barra de título arrasta a janela.

TsgcVCLRibbonForm e TsgcFMXRibbonForm no Delphi e no C++ Builder, TsgcWinFormsRibbonForm, TsgcWpfRibbonWindow e TsgcAvaloniaRibbonWindow no .NET
A barra de acesso rápido na barra de título é a do Ribbon: os mesmos cliques, Actions, dicas, KeyTips e menu de personalização
Com QATPosition definido como rqpBelow ou ShowQAT desligado, a barra de título mostra apenas a legenda, e o comando "Show above the Ribbon" move a barra de volta para cima
CaptionAlignment centraliza a legenda ou a coloca depois do ícone, e TitleBarHeight define a altura
No WPF e no Avalonia, a propriedade anexada Ribbon na janela a configura a partir do XAML

Edição Registrada, como o Ribbon: a Community não inclui o formulário Ribbon. A moldura com tema exige o Windows com composição de desktop e, no FireMonkey, é aplicada somente no Windows. Sem ela, o Ribbon mostra a sua própria linha de barra de acesso rápido.

Ler o tópico da ajuda
Formulário Ribbon no .NET

Comandos

Todo item de que uma barra de comandos precisa, com agrupamento, menus e estouro tratados pelo controle.

Comandos

Todos os tipos de item de barra de ferramentas em um só controle

Uma barra de ferramentas real mistura botões simples, botões que ficam pressionados, botões com menu, separadores e um pouco de texto. No sgcToolbar, cada um deles é um item da mesma coleção, e Kind decide como é desenhado e como reage. Os itens são dispostos da esquerda para a direita com Spacing entre eles, e um espaçador ocupa a largura livre, então você pode empurrar Ajuda ou o nome do usuário para a borda direita sem nenhum código de layout. Width fixa um item quando você precisa de um tamanho estável. Dicas, estados desabilitados e destaque ao passar o mouse são desenhados para todos os tipos.

tikButton, tikToggle e tikDropdown para comandos
tikSeparator desenha uma linha vertical fina
tikSpacer empurra os itens seguintes para a direita
tikLabel mostra texto dentro da barra

Ler o tópico da ajuda

Comandos

Grupos de opção sem código

Alinhamento de texto, modos de exibição e ferramentas de desenho são clássicos de escolha única entre várias. Dê o mesmo GroupIndex a vários itens de alternância e eles formam um grupo de opção: definir Down em um deles, por clique ou por código, libera os outros, e um clique no item que já está pressionado o mantém pressionado, então uma escolha sempre permanece selecionada. Uma alternância com GroupIndex 0 é uma simples chave de liga e desliga, como Negrito ou Quebra de linha. O clique inverte Down antes de OnItemClick disparar, então o seu tratador lê o novo estado. Nenhuma ligação de evento é necessária para manter o grupo consistente.

GroupIndex maior que 0 cria um grupo de opção
Down lê ou define o estado por código
O estado pressionado é desenhado com um tom de destaque
Uma action vinculada controla Down pelo seu Checked

Ler o tópico da ajuda

Comandos Somente Registrada

Os usuários redimensionam janelas, e uma barra de ferramentas que simplesmente corta os últimos botões esconde comandos de que eles precisam. Quando os itens não cabem, o sgcToolbar move os últimos para uma lista de estouro e desenha um botão de seta dupla na extremidade direita. Ao pressioná-lo, aparece OverflowMenu, montado em tempo de execução com uma entrada por item oculto, e escolher uma entrada age exatamente como um clique: uma alternância inverte, OnItemClick dispara e um menu suspenso mostra o seu menu. O modelo informa o que está oculto. Quando a janela cresce de novo, os itens voltam para a barra por conta própria.

OverflowMenu é montado para você em tempo de execução
HasOverflow, OverflowCount e InOverflow por item
ItemAtPos informa um acerto no botão de estouro
Compilado sob SGC_TOOLBAR_ADVANCED

Community: os itens que não cabem são cortados, não há botão de estouro.

Ler o tópico da ajuda

Comandos Somente Registrada

Reaproveite suas TActions

Se os seus comandos já vivem em um TActionList, a barra de ferramentas não deveria duplicá-los. Vincule um item a qualquer TAction do VCL ou do FireMonkey pela propriedade Action e ele acompanha Caption, Enabled, Visible, Hint, ImageIndex e Checked da action. Um clique executa a action com a barra como ActionComponent, a menos que o item tenha um tratador OnClick. As barras chamam InitiateAction em ociosidade, então uma action desabilitada desabilita o seu botão sem código extra. No .NET o item tem Command e CommandParameter para ICommand. Um único TActionList pode controlar juntos a barra de ferramentas, o menu principal e a barra de navegação.

Action vincula um item a qualquer TBasicAction
O Checked da action controla o Down de uma alternância
O OnUpdate das actions roda em ociosidade
.NET: Command e CommandParameter

Community: trate o OnClick do item ou o OnItemClick da barra no lugar de uma action.

Ler o tópico da ajuda

Barra de status

Uma barra de status que se organiza sozinha, mostra progresso e estado, e aceita atualizações de qualquer thread.

Barra de status

Painéis de status que se organizam sozinhos

Linha e coluna, um nome de arquivo, o estado de gravação e uma mensagem principal disputam a borda inferior da janela. O TsgcVCLStatusBar organiza seus Panels da esquerda para a direita em três passagens: os painéis fixos ocupam a sua Width, os painéis AutoSize ocupam a largura do seu texto, e os painéis Spring dividem o que sobrar. Use um painel spring para a mensagem principal e a barra fica organizada em qualquer tamanho de janela. Uma linha fina separa os painéis, e OnPanelClick informa qual deles foi clicado. Os painéis são uma coleção, então você pode adicioná-los e editá-los no Object Inspector em tempo de design.

Painéis spkText com Alignment e Hint
Painéis Spring dividem a largura livre
Painéis AutoSize se ajustam ao texto
OnPanelClick informa um clique em um painel

Ler o tópico da ajuda

Barra de status

Barras de progresso e indicadores de estado

Operações longas precisam de uma barra de progresso, e conexões ativas precisam de uma luz que diga se está tudo bem. Um painel pode ser uma barra de progresso preenchida até o percentual de Progress na cor de destaque, ou um indicador: um ponto colorido seguido do texto do painel. IndicatorState escolhe desligado, ok, aviso ou erro, com verde, âmbar e vermelho ajustados separadamente para o tema claro e o escuro. Combina com o estado de uma conexão de banco de dados, de um feed de dados ou de uma sincronização em segundo plano. Defina Progress ou IndicatorState e o painel se redesenha sozinho, sem código de desenho para escrever.

spkProgress com Progress de 0 a 100
spkIndicator com IndicatorState
sisOff, sisOk, sisWarning, sisError
GetIndicatorColor devolve a cor para o tema

Ler o tópico da ajuda

Barra de status

Atualize a barra de status a partir de uma thread de trabalho

Downloads, feeds e cálculos longos rodam em threads de trabalho, e devolver cada atualização de status para a thread principal é trabalhoso e fácil de errar. SetPanelText, SetProgress e SetIndicator podem ser chamados de qualquer thread, sem Synchronize ou Queue. O modelo protege os valores com um lock e dispara OnChange somente quando um valor realmente mudou, então repetir o mesmo valor não custa nada. A barra VCL então envia uma mensagem à sua janela e a barra FireMonkey enfileira o redesenho, de modo que a interface nunca é tocada fora da thread principal. Uma thread que sobrevive a um painel também é segura.

SetPanelText, SetProgress, SetIndicator de qualquer thread
Nenhum Synchronize ou Queue no seu código
Valores inalterados não custam nada
Um índice fora do intervalo é ignorado, nunca gera exceção

Ler o tópico da ajuda

Aparência, teclado e saída

Ícones, temas e suporte a teclado que combinam com o resto do sgcUI, além de imagens das barras para a sua documentação.

Aparência, teclado e saída

Ícones ou letras de glifo, legendas opcionais

Todo item clicável tem um espaço de ícone de 16 pixels lógicos. Ele mostra a imagem em ImageIndex da lista Images da barra ou, quando o item não tem imagem, o seu Glyph: uma letra ou símbolo curto que não precisa de lista de imagens alguma. Desative ShowCaptions para uma barra compacta só com ícones, e a legenda vira dica, então nada se perde. As listas de imagens do VCL são convertidas uma vez para ARGB direto, com o alfa recuperado, e mantidas em cache até a lista mudar, então listas com máscara e de 32 bits ficam corretas. Misture os dois à vontade enquanto os ícones ainda estão sendo desenhados.

Images e ImageIndex para listas de imagens
Glyph quando não há imagem
ShowCaptions False para só ícones
Listas de imagens do FireMonkey a partir do Delphi XE8
Da direita para a esquerda para árabe e hebraico: os itens fluem a partir da direita, e MirrorGlyph inverte ícones direcionais como voltar, avançar, desfazer e refazer

Ler o tópico da ajuda

Aparência, teclado e saída

Claro, escuro e a sua cor de destaque

As barras tiram suas cores dos tokens de tema do sgcUICore, os mesmos que todo produto da suíte usa, então uma barra de ferramentas acima de um sgcGrid e ao lado de uma barra sgcNavigation parece uma única aplicação. Theme seleciona utLight ou utDark, e AccentColor substitui o destaque usado pelo anel de foco, pelo tom de pressionado das alternâncias e pelas barras de progresso. Os estados de passagem do mouse, de clique, pressionado, em foco e desabilitado são todos derivados para você. Cada barra tem o seu próprio Theme, então defina-o na barra de ferramentas e na barra de status. Trocar em tempo de execução redesenha as duas barras de uma vez.

Theme: utDefault (padrão, segue o tema da aplicação), utLight ou utDark
AccentColor como $AARRGGBB, 0 mantém o destaque do tema
As cores dos indicadores seguem o tema
Troque em tempo de execução para um botão de modo escuro

Ler o tópico da ajuda

Aparência, teclado e saída

Acesso pelo teclado e uma alça de redimensionamento que funciona

A barra de ferramentas pode entrar na ordem de tabulação quando os seus usuários precisarem: defina TabStop e o botão em foco mostra um anel de foco, Esquerda e Direita movem entre os botões habilitados, Home e End saltam, Enter ou Espaço ativa. Vem desativado por padrão, então a barra nunca rouba o foco do editor abaixo dela. ClickItem ativa um item por código, por exemplo a partir de um atalho do formulário. Na barra de status, SizeGrip desenha os pontos da alça, e no VCL arrastá-los redimensiona um formulário redimensionável. No FireMonkey a alça é desenhada mas não redimensiona o formulário, então desative SizeGrip lá quando o formulário não for redimensionável.

TabStop no VCL, CanFocus no FireMonkey
ClickItem executa um item por código
SizeGrip e GripRect na barra de status
A alça redimensiona o formulário somente quando ele é redimensionável

Ler o tópico da ajuda

Aparência, teclado e saída

Renderize as duas barras sem janela

As capturas de tela de uma barra de ferramentas em um manual ficam desatualizadas a cada versão. O renderizador em sgcToolbar_Render pinta um TsgcToolbarModel ou um TsgcStatusBarModel sem janela e sem VCL ou FireMonkey, de modo que um programa de console, um teste ou um servidor web pode produzir as mesmas barras como imagem. SaveToPNG e SaveToSVG recebem um tamanho em pixels lógicos e uma escala, então 560 por 44 na escala 2 gera uma imagem nítida de 1120 por 88. As units compilam em todas as plataformas, inclusive Linux64. Passe as suas próprias imagens por OnGetImage e a imagem combina com a aplicação em execução.

SaveToPNG grava um arquivo ou stream PNG
SaveToSVG grava a mesma barra como SVG
Funciona em TsgcToolbarModel e TsgcStatusBarModel
OnGetImage fornece os ícones para a saída headless

Ler o tópico da ajuda

EM AÇÃO

Veja o sgcToolbar em ação

sgcToolbar dentro das demos da suíte sgcUI: aplicações completas que rodam offline com dados simulados integrados.

Uma barra superior com Inject event, botões de atalho e o alternador de tema, barra de status abaixo.
Altamira Fleet →

A barra superior do ERP com busca, New, notificações e o menu do usuário.
Altamira ERP →

A barra superior do PMO com Reset what-if e o alternador de tema.
Altamira PMO →

A barra superior da planta com Inject fault, Acknowledge all e controles de velocidade.
Altamira Plant →

Ver todas as demos da suíte

CAPTURAS DE TELA

sgcToolbar em Ação

Theme = utLight ou utDark muda o estilo da barra de ferramentas e da barra de status, inclusive da alça de redimensionamento.

Painéis spkText, spkProgress e spkIndicator: posição do cursor, progresso de 64 por cento e um indicador sisWarning.

ShowCaptions = True mostra o texto ao lado de cada glifo; False mantém uma barra compacta só com glifos.

CASOS DE USO

Quem cria com o sgcToolbar

Editores de documentos e de código

Um editor precisa de botões de alternância Negrito e Itálico, um grupo de opção de alinhamento, um menu de Zoom e uma barra de status com a linha, a coluna e o estado de gravação. O sgcToolbar cobre tudo isso com uma coleção de itens e uma coleção de painéis, vinculadas ao TActionList que você já tem. Quando a janela estreita, o menu de estouro mantém todos os comandos acessíveis. O demo EditorShell monta exatamente isso em torno de um TMemo.

Tipos de item
Grupos de opção
Menu de estouro

Execute o demo EditorShell

Ferramentas de longa duração e feeds ao vivo

Ferramentas de importação, clientes de sincronização e aplicativos de monitoramento fazem o trabalho em threads de segundo plano e precisam relatá-lo. Chame SetProgress, SetIndicator e SetPanelText direto da thread de trabalho, e a barra de status se redesenha na thread principal sem Synchronize no seu código. O indicador fica verde, âmbar ou vermelho conforme o estado da tarefa. O demo LiveStatus simula um download que faz exatamente isso.

Atualizações thread-safe
Painéis de progresso
Indicadores

Execute o demo LiveStatus

Uma barra de comandos em todas as plataformas

Uma aplicação FireMonkey entregue em Windows, macOS e dispositivos móveis merece a mesma barra de ferramentas em todo lugar. O TsgcFMXToolbar e o TsgcFMXStatusBar têm os mesmos itens, painéis e eventos das barras VCL, e as barras .NET para WinForms, WPF e Avalonia seguem os mesmos nomes. EditorShellFMX é a versão FireMonkey do editor, com os mesmos itens, menu de estouro e painéis de status.

Barras FireMonkey
Temas
Painéis de status

Execute o demo EditorShellFMX

INÍCIO RÁPIDO

The same API in Delphi, C++ Builder and C#: a toggle, a radio group, a dropdown, and a status bar updated from the click handler.

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;

Uma janela no estilo do Office: TsgcVCLRibbonForm move a barra de acesso rápido e a legenda centralizada para uma barra de título com tema.

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

Baixe a avaliação

DEMOS

Execute os demos do sgcToolbar

Os demos EditorShell e LiveStatus acompanham o VCL e o C++ Builder, além de uma versão FireMonkey para Delphi, e na edição .NET como projetos WinForms, WPF e Avalonia. A edição Registrada acrescenta os demos do Ribbon, RibbonShell, RibbonForm e RibbonSuite.

Somente Registrada EditorShell

Uma estrutura de editor com TMemo, com alternâncias, um grupo de opção Esquerda, Centro e Direita, um menu suspenso de Zoom, vínculos com TActionList, o menu de estouro, painéis de linha e coluna e uma alternância Dark. Usa estouro e actions, então exige a edição Registrada ou de Avaliação.

LiveStatus

Uma thread de trabalho simula um download e alimenta um painel de texto, um painel de progresso e um indicador que fica verde, âmbar ou vermelho, com os botões Start e Stop. Compila com a edição Community.

Somente Registrada EditorShellFMX

O demo EditorShell com um TsgcFMXToolbar e um TsgcFMXStatusBar em torno de um TMemo do FireMonkey, somente para Delphi: os mesmos itens, vínculos de action, menu de estouro e painéis de status.

Somente Registrada RibbonShell

Uma estrutura de documento em torno de um Ribbon com abas, grupos, uma galeria, uma aba contextual, a barra de acesso rápido, KeyTips e uma exibição backstage. RibbonShell é o demo VCL e RibbonShellFMX o FireMonkey, ambos com gêmeos em C++ Builder. RibbonShell, RibbonShellWpf e RibbonShellAvalonia são os projetos .NET.

Somente Registrada RibbonForm e RibbonFormFMX

Uma janela de editor no estilo do Office, para a VCL e para o FireMonkey, com equivalentes para C++ Builder: a barra de acesso rápido com Save, Undo e Redo na barra de título, ao lado do ícone da janela, a legenda centralizada e um Ribbon com o botão File e as abas Home, Insert e View logo abaixo. Uma caixa de seleção move a barra de acesso rápido para baixo do Ribbon, outra desliga a moldura com tema, e o seletor de tema alterna entre Light, Dark e Fluent. Na edição .NET acompanha como RibbonForm para WinForms, RibbonFormWpf e RibbonFormAvalonia.

Somente Registrada RibbonSuite

Um Ribbon que controla vários produtos sgcUI a partir de um único formulário: seus comandos atuam sobre os outros controles sgcUI da suíte.

Demos compilados

Executáveis prontos para rodar de todos os produtos sgcUI, sem nada para instalar.

Baixar sgcUI_bin.zip →

Guia Primeiros Passos

Cinco demos QuickStart para Delphi (VCL) acompanham o produto em Demos\Toolbar\Delphi\00.QuickStart. O guia em PDF as explica passo a passo: uma primeira barra de ferramentas, todos os tipos de item, actions e uma barra de status, temas, e um pequeno editor de texto.

Baixar o guia (PDF, em inglês) →

EDIÇÕES

Onde o sgcToolbar está incluído

O sgcToolbar está em todas as edições do sgcUI, a partir da Standard, e também é vendido separadamente. O sgcToolbar também está incluído no pacote All-Access.

sgcToolbar pacote individual

€149 / desenvolvedor, código-fonte completo, 1 ano de atualizações.

Comprar o sgcToolbar → Ver preços →

sgcUI Standard

sgcToolbar, sgcGrid, sgcNavigation e sgcEditors, a partir de €380.

Ver Standard →

sgcUI Professional

Standard mais sgcCharts, sgcDashboard e sgcGauges, a partir de €529.

Ver Professional →

sgcUI Enterprise

Todos os 17 produtos sgcUI, a partir de €699.

Ver Enterprise →

A edição Community gratuita (esegece.sgcToolbar.Community no NuGet) não tem o Ribbon nem o formulário Ribbon, o menu de estouro nem os links de Action.

Recurso	Community (gratuita)	Registrada
Todos os tipos de item, alternâncias, grupos de opção e menus suspensos	✓	✓
Painéis de texto, de progresso e de indicador	✓	✓
Atualizações de status thread-safe	✓	✓
Ícones, glifos, temas, teclado e alça de redimensionamento	✓	✓
Saída headless em PNG e SVG	✓	✓
Ribbon com KeyTips, galerias, barra de acesso rápido e exibição backstage	−	✓
Formulário Ribbon: barra de acesso rápido e legenda em uma barra de título com tema	−	✓
Menu de estouro	−	✓
Links de Action (Delphi) e Command (.NET)	−	✓

PLATAFORMAS

Frameworks e plataformas suportados

Componentes do sgcToolbar

Componente	Alvo
TsgcVCLToolbar, TsgcVCLStatusBar	Delphi e C++ Builder, VCL (sgcToolbar_VCL)
TsgcFMXToolbar, TsgcFMXStatusBar	Delphi e C++ Builder, FireMonkey (sgcToolbar_FMX)
O Ribbon	Edição Registrada: VCL, FireMonkey, WinForms, WPF e Avalonia
TsgcVCLRibbonForm, TsgcFMXRibbonForm	Edição Registrada: Delphi e C++ Builder, VCL e FireMonkey (sgcToolbar_RibbonForm_VCL, sgcToolbar_RibbonForm_FMX), a barra de título com tema no Windows
TsgcWinFormsRibbonForm, TsgcWpfRibbonWindow, TsgcAvaloniaRibbonWindow	Edição Registrada: .NET, WinForms, WPF e Avalonia
TsgcToolbarItem, TsgcStatusBarPanel, TsgcToolbarModel, TsgcStatusBarModel	Modelos independentes de framework (sgcToolbar_Model)
TsgcWinFormsToolbar, TsgcWinFormsStatusBar	.NET, WinForms
TsgcWpfToolbar, TsgcWpfStatusBar	.NET, WPF
TsgcAvaloniaToolbar, TsgcAvaloniaStatusBar	.NET, Avalonia

Alvo	Componente	Plataformas
Delphi 7 a 13, VCL	TsgcVCLToolbar, TsgcVCLStatusBar	Win32 e Win64
Delphi XE6 a 13, FireMonkey	TsgcFMXToolbar, TsgcFMXStatusBar	Windows, macOS, iOS, Android e Linux (FMXLinux)
C++ Builder 2007 a 13	Barras VCL e FireMonkey	Headers .hpp gerados e bibliotecas estáticas
Delphi 10.2 a 13, independente de framework	Modelos e renderizador headless de PNG e SVG	Linux64, por exemplo para renderizar uma barra de ferramentas em um servidor
.NET Framework 4.7.2, .NET 8, 9 e 10	TsgcWinFormsToolbar, barras WPF e Avalonia	WinForms, WPF e Avalonia

FAQ

Perguntas frequentes

Sim. SetPanelText, SetProgress e SetIndicator podem ser chamados de qualquer thread, sem Synchronize ou Queue. O modelo protege os valores com um lock e a barra se redesenha na thread principal. Toda outra propriedade é definida a partir da thread principal. Veja Atualizações thread-safe.

Ele cobre as mesmas tarefas: botões, alternâncias, botões suspensos, separadores e rótulos no alto, painéis de texto embaixo. E acrescenta um item espaçador, painéis de progresso e de indicador, setters thread-safe, temas e saída headless. Os seus componentes TActionList e TPopupMenu existentes se encaixam por meio de Action e DropdownMenu.

O Ribbon e o formulário Ribbon, o menu de estouro e os links de Action dos itens, que no .NET são Command e CommandParameter. Na Community, os itens que não cabem são cortados. Todos os outros recursos, incluindo as atualizações de status thread-safe, os painéis de progresso e de indicador e a saída headless, estão na Community.

Sim. O C++ Builder 2007 a 13 usa as mesmas barras VCL e FireMonkey por meio de headers e bibliotecas gerados, e os demos EditorShell e LiveStatus também acompanham como projetos C++ Builder. A aba de código desta página mostra a mesma barra de ferramentas em Delphi, C++ Builder e C#.

Sim. Todos os tamanhos são pixels lógicos multiplicados pela escala do monitor, e o espaço do ícone tem 16 pixels lógicos, então botões, glifos, barras de progresso e pontos de indicador ficam nítidos em qualquer DPI. O FireMonkey pega as imagens da lista de imagens no tamanho de dispositivo do frame.

Sim. SaveToSVG e SaveToPNG de TsgcToolbarModel e TsgcStatusBarModel desenham as barras sem janela, também no Linux64 a partir do Delphi 10.2, então uma etapa de build pode regenerar as imagens do seu manual a cada versão. Um parâmetro de escala gera imagens nítidas para telas de alto DPI e para impressão.

DOCUMENTAÇÃO

Ajuda do sgcToolbar

Manuais em PDF

Delphi, C++ Builder e .NET, cobrindo todos os produtos sgcUI.

RELACIONADOS

Combina bem com

sgcNavigation

Adicione uma barra lateral ou um acordeão com os mesmos tokens de tema e a barra de ferramentas, a barra de status e o menu formam uma única estrutura de aplicação.

Conhecer o sgcNavigation →

sgcEditors

Coloque seletores de data, controles deslizantes e editores de token nos formulários abaixo da barra de ferramentas, com o mesmo tema e a mesma cor de destaque.

Conhecer o sgcEditors →

sgcGrid

Combine a barra de status com uma grade de dados ao vivo e mostre a contagem de linhas, o filtro e o estado do feed como painéis.

Conhecer o sgcGrid →

sgcToolbar, a Barra de Ferramentas e Barra de Status para Delphi, C++ Builder & .NET

Uma Barra de Comandos e de Status Completa

Ribbon

Um Ribbon que se adapta, com KeyTips e exibição backstage

Um formulário Ribbon com a barra de acesso rápido na barra de título

Comandos

Todos os tipos de item de barra de ferramentas em um só controle

Grupos de opção sem código

Menus suspensos a partir do seu popup

Itens que não cabem vão para um menu de estouro

Reaproveite suas TActions

Barra de status

Painéis de status que se organizam sozinhos

Barras de progresso e indicadores de estado

Atualize a barra de status a partir de uma thread de trabalho

Aparência, teclado e saída

Ícones ou letras de glifo, legendas opcionais

Claro, escuro e a sua cor de destaque

Acesso pelo teclado e uma alça de redimensionamento que funciona

Renderize as duas barras sem janela

Veja o sgcToolbar em ação

sgcToolbar em Ação

Quem cria com o sgcToolbar

Editores de documentos e de código

Ferramentas de longa duração e feeds ao vivo

Uma barra de comandos em todas as plataformas

A Toolbar and Status Bar in a Few Lines

Execute os demos do sgcToolbar

Somente Registrada EditorShell

LiveStatus

Somente Registrada EditorShellFMX

Somente Registrada RibbonShell

Somente Registrada RibbonForm e RibbonFormFMX

Somente Registrada RibbonSuite

Demos compilados

Guia Primeiros Passos

Onde o sgcToolbar está incluído

sgcToolbar pacote individual

sgcUI Standard

sgcUI Professional

sgcUI Enterprise

Frameworks e plataformas suportados

Componentes do sgcToolbar

Perguntas frequentes

Ajuda do sgcToolbar

Delphi

C++ Builder

.NET

Manuais em PDF

Combina bem com

sgcNavigation

sgcEditors

sgcGrid

Experimente o sgcToolbar Hoje