Zbuduj ramę aplikacji desktopowej z kontrolek, które wyglądają tak samo w każdym UI. Pasek narzędzi z przyciskami, przełącznikami, grupami opcji i listami rozwijanymi, Ribbon z kartami, galeriami, KeyTips i widokiem backstage dla aplikacji, które przerosły pasek narzędzi, z paskiem szybkiego dostępu w pasku tytułu z motywem, oraz prawdziwy pasek stanu z panelami postępu i wskaźników, które wątek roboczy może aktualizować bezpośrednio.
Czternaście funkcji dla pasków, których potrzebuje każda aplikacja desktopowa, od pełnego Ribbonu i grup opcji po postęp na żywo z wątku roboczego.
Ribbon w stylu Office dla aplikacji z większą liczbą poleceń, niż pomieści pasek narzędzi, w każdym frameworku sgcUI.
Ribbon Tylko zarejestrowana
Twoi użytkownicy otwierają edytor raportów na laptopie, przyciągają okno do połowy ekranu i nadal oczekują, że każde polecenie będzie w zasięgu. Ribbon im to zapewnia. Polecenia są w kartach i grupach, a gdy okno się zwęża, każda grupa schodzi z dużych przez średnie do małych przycisków i w końcu zwija się do jednego przycisku, według ustawionego priorytetu. Gdy wszystko jest zwinięte, Ribbon się przewija. Galerie zmniejszają się z pełnych wierszy do mniejszej liczby kolumn i do listy rozwijanej. Naciśnij Alt, a pojawią się KeyTips: wpisz kartę i polecenie, a Esc cofa o krok. Przycisk aplikacji otwiera widok backstage z poleceniami i stronami, które zawierają Twoje własne kontrolki. Pasek szybkiego dostępu leży nad Ribbonem lub pod nim, a użytkownicy dostosowują go z menu lub prawym przyciskiem myszy.
ICommand w .NET i deklaracja XAML w WPF i AvaloniaSaveLayout i LoadLayout zapisują pasek szybkiego dostępu i stan minimalizacji każdego użytkownika jako JSONEdycja zarejestrowana w VCL, FireMonkey, WinForms, WPF i Avalonia, Delphi 7 do 13 i C++ Builder. Community nie zawiera Ribbonu. KeyTips działają na pulpicie Windows. Pasek szybkiego dostępu ma własny wiersz albo formularz Ribbon rysuje go w pasku tytułu okna.
Przegląd RibbonuRibbon Tylko zarejestrowana
Aplikacja Office nie ma szarego nagłówka Windows nad Ribbonem. Pasek szybkiego dostępu i nazwa dokumentu są w pasku tytułu, a pasek tytułu i Ribbon wyglądają jak jedna powierzchnia. Formularz Ribbon nadaje Twojemu oknu taką samą ramkę. Upuść go na formularz i wskaż Ribbon: sgcUI usuwa natywny nagłówek i rysuje pasek tytułu z motywem, z ikoną okna, paskiem szybkiego dostępu, tytułem wyśrodkowanym w oknie oraz przyciskami minimalizacji, maksymalizacji i zamknięcia, w kolorze wiersza kart motywu Ribbon, Classic lub Fluent, jasnego lub ciemnego. Ribbon znajduje się tuż pod nim i jest o jeden wiersz niższy. Okno zachowuje cień, krawędzie zmiany rozmiaru i zachowanie po maksymalizacji, Windows 11 pokazuje układy przyciągania na przycisku maksymalizacji, a puste miejsce paska tytułu przeciąga okno.
TsgcVCLRibbonForm i TsgcFMXRibbonForm w Delphi i C++ Builder, TsgcWinFormsRibbonForm, TsgcWpfRibbonWindow i TsgcAvaloniaRibbonWindow w .NETQATPosition ma wartość rqpBelow lub ShowQAT jest wyłączone, pasek tytułu pokazuje tylko tytuł, a polecenie Show above the Ribbon przenosi pasek z powrotem na góręCaptionAlignment wyśrodkowuje tytuł lub umieszcza go po ikonie, a TitleBarHeight ustawia wysokośćRibbon okna konfiguruje formularz z XAMLEdycja Zarejestrowana, tak jak Ribbon: Community nie zawiera formularza Ribbon. Ramka z motywem wymaga Windows z kompozycją pulpitu, a w FireMonkey jest stosowana tylko w Windows. Bez niej Ribbon pokazuje własny wiersz paska szybkiego dostępu.
Przeczytaj temat pomocyKażda pozycja, której potrzebuje pasek poleceń, a grupowanie, menu i przepełnienie obsługuje kontrolka.
Polecenia
Prawdziwy pasek narzędzi aplikacji miesza zwykłe przyciski, przyciski, które zostają wciśnięte, przyciski z menu, separatory i trochę tekstu. W sgcToolbar każdy z nich to jedna pozycja tej samej kolekcji, a Kind decyduje, jak jest rysowana i jak reaguje. Pozycje są układane od lewej do prawej z odstępem Spacing, a spacer zajmuje wolną szerokość, więc możesz przesunąć Pomoc lub nazwę użytkownika do prawej krawędzi bez kodu układu. Width ustala rozmiar pozycji, gdy potrzebujesz stałego. Podpowiedzi, stany wyłączone i podświetlanie są rysowane dla każdego rodzaju.
tikButton, tikToggle i tikDropdown dla poleceńtikSeparator rysuje cienką pionową liniętikSpacer przesuwa kolejne pozycje w prawotikLabel pokazuje tekst wewnątrz paska
Polecenia
Wyrównanie tekstu, tryby widoku i narzędzia rysowania to klasyczne wybory jednej z wielu opcji. Nadaj kilku przełącznikom ten sam GroupIndex, a utworzą grupę opcji: ustawienie Down na jednym z nich, kliknięciem lub z kodu, zwalnia pozostałe, a kliknięcie pozycji już wciśniętej zostawia ją wciśniętą, więc jeden wybór zawsze pozostaje zaznaczony. Przełącznik z GroupIndex 0 to zwykły przełącznik włącz i wyłącz, taki jak Pogrubienie czy Zawijanie wierszy. Kliknięcie zmienia Down przed wywołaniem OnItemClick, więc Twoja procedura odczytuje nowy stan. Nie potrzeba żadnego podpinania zdarzeń, aby grupa była spójna.
GroupIndex powyżej 0 tworzy grupę opcjiDown odczytuje lub ustawia stan z koduDown przez swoje CheckedPolecenia
Poziomy powiększenia, formaty eksportu i ostatnie pliki należą do menu pod przyciskiem, a nie do dziesięciu kolejnych przycisków. Pozycja tikDropdown rysuje małą strzałkę po podpisie i pokazuje menu popup przypisane do DropdownMenu tuż pod przyciskiem: TPopupMenu w VCL i FireMonkey, ContextMenuStrip w WinForms. OnItemClick i OnClick pozycji są wywoływane przed otwarciem menu, więc możesz najpierw wypełnić lub zaznaczyć jego wpisy. Jeśli menu zostanie zwolnione, pasek sam czyści odwołanie. Jeden cel kliknięcia, jedno menu i pasek narzędzi, który pozostaje krótki, nawet gdy poleceń przybywa.
DropdownMenu przyjmuje popup Twojego frameworkaOnItemClickPolecenia Tylko zarejestrowana
Użytkownicy zmieniają rozmiar okien, a pasek narzędzi, który po prostu przycina ostatnie przyciski, ukrywa potrzebne im polecenia. Gdy pozycje się nie mieszczą, sgcToolbar przenosi ostatnie do listy przepełnienia i rysuje przycisk z podwójną strzałką na prawym końcu. Jego naciśnięcie pokazuje OverflowMenu, budowane w czasie działania z jednym wpisem na każdą ukrytą pozycję, a wybór wpisu działa dokładnie jak kliknięcie: przełącznik się zmienia, wywoływane jest OnItemClick, a lista rozwijana pokazuje swoje menu. Model informuje, co jest ukryte. Gdy okno znów się powiększy, pozycje same wracają na pasek.
OverflowMenu jest budowane za Ciebie w czasie działaniaHasOverflow, OverflowCount i InOverflow dla każdej pozycjiItemAtPos zgłasza trafienie w przycisk przepełnieniaSGC_TOOLBAR_ADVANCEDCommunity: pozycje, które się nie mieszczą, są przycinane, nie ma przycisku przepełnienia.
Przeczytaj temat pomocyPolecenia Tylko zarejestrowana
Jeśli Twoje polecenia już żyją w TActionList, pasek narzędzi nie powinien ich duplikować. Powiąż pozycję z dowolnym TAction VCL lub FireMonkey przez właściwość Action, a podąża ona za Caption, Enabled, Visible, Hint, ImageIndex i Checked akcji. Kliknięcie wykonuje akcję z paskiem jako ActionComponent, chyba że pozycja ma procedurę OnClick. Paski wywołują InitiateAction w czasie bezczynności, więc wyłączona akcja wyłącza swój przycisk bez dodatkowego kodu. W .NET pozycja ma Command i CommandParameter dla ICommand. Jeden TActionList może sterować razem paskiem narzędzi, menu głównym i paskiem nawigacji.
Action łączy pozycję z dowolnym TBasicActionDown przełącznikaCommand i CommandParameterCommunity: zamiast akcji obsłuż OnClick pozycji lub OnItemClick paska.
Przeczytaj temat pomocyPasek stanu, który sam się układa, pokazuje postęp i stan oraz przyjmuje aktualizacje z dowolnego wątku.
Pasek stanu
Wiersz i kolumna, nazwa pliku, stan zapisu i główny komunikat rywalizują o dolną krawędź okna. TsgcVCLStatusBar układa swoje Panels od lewej do prawej w trzech przebiegach: panele stałe dostają swoją Width, panele AutoSize szerokość swojego tekstu, a panele Spring dzielą to, co zostało. Użyj jednego panelu spring na główny komunikat, a pasek pozostanie schludny przy każdym rozmiarze okna. Cienka linia oddziela panele, a OnPanelClick informuje, który został kliknięty. Panele to kolekcja, więc możesz je dodawać i edytować w Inspektorze obiektów w czasie projektowania.
spkText z Alignment i HintSpring dzielą wolną szerokośćAutoSize dopasowują się do tekstuOnPanelClick zgłasza kliknięcie panelu
Pasek stanu
Długie operacje potrzebują paska postępu, a aktywne połączenia światła, które mówi, czy wszystko jest w porządku. Panel może być paskiem postępu wypełnionym do Progress procent w kolorze akcentu albo wskaźnikiem: kolorową kropką, po której następuje tekst panelu. IndicatorState wybiera off, ok, warning lub error, z zielenią, bursztynem i czerwienią dobranymi osobno dla jasnego i ciemnego motywu. Pasuje do stanu połączenia z bazą danych, źródła danych lub synchronizacji w tle. Ustaw Progress lub IndicatorState, a panel sam się odrysuje, nie ma kodu rysującego do napisania.
spkProgress z Progress od 0 do 100spkIndicator z IndicatorStatesisOff, sisOk, sisWarning, sisErrorGetIndicatorColor zwraca kolor dla motywuPasek stanu
Pobieranie, źródła danych i długie obliczenia działają w wątkach roboczych, a przekazywanie każdej aktualizacji stanu z powrotem do wątku głównego jest żmudne i łatwo je zepsuć. SetPanelText, SetProgress i SetIndicator można wywoływać z dowolnego wątku, bez Synchronize ani Queue. Model chroni wartości blokadą i wywołuje OnChange tylko wtedy, gdy wartość naprawdę się zmieniła, więc powtarzanie tej samej wartości nic nie kosztuje. Pasek VCL wysyła wtedy komunikat do swojego okna, a pasek FireMonkey kolejkuje odrysowanie, więc UI nigdy nie jest dotykane poza wątkiem głównym. Wątek, który przeżyje panel, też jest bezpieczny.
SetPanelText, SetProgress, SetIndicator z dowolnego wątkuSynchronize ani Queue w Twoim kodzieIkony, motywy i obsługa klawiatury zgodne z resztą sgcUI oraz obrazy pasków do Twojej dokumentacji.
Wygląd, klawiatura i eksport
Każda klikalna pozycja ma miejsce na ikonę o rozmiarze 16 pikseli logicznych. Pokazuje obraz o ImageIndex z listy Images paska lub, gdy pozycja nie ma obrazu, jej Glyph: literę lub krótki symbol, który w ogóle nie wymaga listy obrazów. Wyłącz ShowCaptions dla zwartego paska tylko z ikonami, a podpis stanie się podpowiedzią, więc nic nie ginie. Listy obrazów VCL są raz konwertowane do prostego ARGB z odzyskanym alfa i trzymane w pamięci podręcznej do zmiany listy, więc listy z maską i 32-bitowe wyglądają poprawnie. Mieszaj oba sposoby swobodnie, gdy ikony są jeszcze projektowane.
Images i ImageIndex dla list obrazówGlyph, gdy nie ma obrazuShowCaptions False dla samych ikonMirrorGlyph odwraca ikony kierunkowe, takie jak wstecz, dalej, cofnij i ponów
Wygląd, klawiatura i eksport
Paski biorą kolory z tokenów motywu sgcUICore, tych samych, których używa każdy produkt pakietu, więc pasek narzędzi nad sgcGrid i obok paska sgcNavigation wygląda jak jedna aplikacja. Theme wybiera utLight lub utDark, a AccentColor zastępuje akcent używany przez pierścień fokusu, odcień wciśnięcia przełączników i paski postępu. Stany najechania, naciśnięcia, wciśnięcia, fokusu i wyłączenia są wyprowadzane za Ciebie. Każdy pasek ma własny Theme, więc ustaw go na pasku narzędzi i na pasku stanu. Przełączenie w czasie działania odrysowuje oba paski naraz.
Theme: utDefault (domyślnie, podąża za motywem aplikacji), utLight lub utDarkAccentColor jako $AARRGGBB, 0 zachowuje akcent motywuWygląd, klawiatura i eksport
Pasek narzędzi może dołączyć do kolejności tabulacji, gdy użytkownicy tego potrzebują: ustaw TabStop, a zaznaczony przycisk pokaże pierścień fokusu, strzałki w lewo i w prawo przechodzą między włączonymi przyciskami, Home i End skaczą, Enter lub Spacja aktywuje. Domyślnie jest wyłączone, więc pasek narzędzi nigdy nie zabiera fokusu edytorowi pod nim. ClickItem aktywuje pozycję z kodu, na przykład ze skrótu formularza. Na pasku stanu SizeGrip rysuje kropki uchwytu, a w VCL przeciągnięcie ich zmienia rozmiar formularza o zmiennym rozmiarze. W FireMonkey uchwyt jest rysowany, ale nie zmienia rozmiaru formularza, więc wyłącz tam SizeGrip, gdy formularz nie ma zmiennego rozmiaru.
TabStop w VCL, CanFocus w FireMonkeyClickItem uruchamia pozycję z koduSizeGrip i GripRect na pasku stanuWygląd, klawiatura i eksport
Zrzuty ekranu paska narzędzi w podręczniku starzeją się z każdym wydaniem. Renderer w sgcToolbar_Render rysuje TsgcToolbarModel lub TsgcStatusBarModel bez okna i bez VCL czy FireMonkey, więc program konsolowy, test lub serwer WWW może tworzyć te same paski jako obraz. SaveToPNG i SaveToSVG przyjmują rozmiar w pikselach logicznych i skalę, więc 560 na 44 w skali 2 daje ostry obraz 1120 na 88. Jednostki kompilują się na każdej platformie, także Linux64. Przekaż własne obrazy przez OnGetImage, a obraz będzie zgodny z działającą aplikacją.
SaveToPNG zapisuje plik lub strumień PNGSaveToSVG zapisuje ten sam pasek jako SVGTsgcToolbarModel i TsgcStatusBarModelOnGetImage dostarcza ikony do wyjścia bez oknasgcToolbar w demach pakietu sgcUI: kompletne aplikacje działające offline na wbudowanych danych symulowanych.
Górny pasek z Inject event, przyciskami szybkimi i przełącznikiem motywu, poniżej pasek stanu.
Altamira Fleet →
Górny pasek ERP z wyszukiwaniem, New, powiadomieniami i menu użytkownika.
Altamira ERP →
Górny pasek PMO z Reset what-if i przełącznikiem motywu.
Altamira PMO →
Górny pasek zakładu z Inject fault, Acknowledge all i sterowaniem prędkością.
Altamira Plant →
Edytor potrzebuje przełączników Pogrubienie i Kursywa, grupy opcji wyrównania, menu Powiększenie i paska stanu z wierszem, kolumną i stanem zapisu. sgcToolbar obsługuje to wszystko jedną kolekcją pozycji i jedną kolekcją paneli, powiązanymi z TActionList, który już masz. Gdy okno się zwęża, menu przepełnienia zachowuje dostęp do każdego polecenia. Demo EditorShell buduje dokładnie to wokół TMemo.
Narzędzia importu, klienty synchronizacji i aplikacje monitorujące wykonują pracę w wątkach w tle i muszą o niej informować. Wywołuj SetProgress, SetIndicator i SetPanelText prosto z wątku roboczego, a pasek stanu odrysuje się w wątku głównym bez Synchronize w Twoim kodzie. Wskaźnik robi się zielony, bursztynowy lub czerwony zależnie od stanu zadania. Demo LiveStatus symuluje pobieranie, które robi dokładnie to.
Aplikacja FireMonkey dostarczana na Windows, macOS i urządzenia mobilne zasługuje na ten sam pasek narzędzi wszędzie. TsgcFMXToolbar i TsgcFMXStatusBar mają te same pozycje, panele i zdarzenia co paski VCL, a paski .NET dla WinForms, WPF i Avalonia używają tych samych nazw. EditorShellFMX to wersja FireMonkey powłoki edytora, z tymi samymi pozycjami, menu przepełnienia i panelami stanu.
To samo API w Delphi, C++ Builder i C#: przełącznik, grupa opcji, lista rozwijana i pasek stanu aktualizowany z procedury kliknięcia.
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;Okno w stylu Office: TsgcVCLRibbonForm przenosi pasek szybkiego dostępu i wyśrodkowany tytuł do paska tytułu z motywem.
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.WinFormsDema EditorShell i LiveStatus są dostępne dla VCL i C++ Builder, wersja FireMonkey dla Delphi, a w edycji .NET jako projekty WinForms, WPF i Avalonia. Edycja zarejestrowana dodaje dema Ribbonu RibbonShell, RibbonForm i RibbonSuite.
Powłoka edytora TMemo z przełącznikami, grupą opcji Lewo, Środek i Prawo, listą rozwijaną Powiększenie, powiązaniami TActionList, menu przepełnienia, panelami wiersza i kolumny oraz przełącznikiem Ciemny. Używa przepełnienia i akcji, więc wymaga edycji zarejestrowanej lub wersji próbnej.
Wątek roboczy symuluje pobieranie i zasila panel tekstowy, panel postępu i wskaźnik, który robi się zielony, bursztynowy lub czerwony, z przyciskami Start i Stop. Buduje się z edycją Community.
Demo EditorShell z TsgcFMXToolbar i TsgcFMXStatusBar wokół TMemo FireMonkey, tylko dla Delphi: te same pozycje, powiązania akcji, menu przepełnienia i panele stanu.
Powłoka dokumentu wokół Ribbonu z kartami, grupami, galerią, kartą kontekstową, paskiem szybkiego dostępu, KeyTips i widokiem backstage. RibbonShell to demo VCL, a RibbonShellFMX to demo FireMonkey, oba z bliźniakami C++ Builder. RibbonShell, RibbonShellWpf i RibbonShellAvalonia to projekty .NET.
Okno edytora w stylu Office, dla VCL i dla FireMonkey, z odpowiednikami dla C++ Builder: pasek szybkiego dostępu z poleceniami Zapisz, Cofnij i Ponów w pasku tytułu obok ikony okna, wyśrodkowany tytuł oraz tuż pod nim Ribbon z przyciskiem Plik i kartami Narzędzia główne, Wstawianie i Widok. Jedno pole wyboru przenosi pasek szybkiego dostępu pod Ribbon, drugie wyłącza ramkę z motywem, a wybór motywu przełącza Light, Dark i Fluent. W edycji .NET jest dostarczane jako RibbonForm dla WinForms, RibbonFormWpf i RibbonFormAvalonia.
Jeden Ribbon, który steruje kilkoma produktami sgcUI z jednego formularza: jego polecenia działają na pozostałych kontrolkach sgcUI zestawu.
Gotowe do uruchomienia pliki wykonywalne każdego produktu sgcUI, nic nie trzeba instalować.
Pobierz sgcUI_bin.zip →Pięć dem QuickStart dla Delphi (VCL) znajduje się w Demos\Toolbar\Delphi\00.QuickStart. Przewodnik PDF omawia je krok po kroku: pierwszy pasek narzędzi, wszystkie rodzaje elementów, akcje i pasek stanu, motywy oraz mały edytor tekstu.
sgcToolbar jest w każdej edycji sgcUI, począwszy od Standard, i jest też sprzedawany osobno. sgcToolbar jest również w pakiecie All-Access.
€149 / programista, pełny kod źródłowy, 1 rok aktualizacji.
Kup sgcToolbar → Zobacz cennik →Bezpłatna edycja Community (esegece.sgcToolbar.Community w NuGet) pomija Ribbon i formularz Ribbon, menu przepełnienia i linki Action.
| Funkcja | Community (bezpłatna) | Zarejestrowana |
|---|---|---|
| Każdy rodzaj pozycji, przełączniki, grupy opcji i menu rozwijane | ✓ | ✓ |
| Panele tekstu, postępu i wskaźników | ✓ | ✓ |
| Aktualizacje stanu bezpieczne wątkowo | ✓ | ✓ |
| Ikony, glify, motywy, klawiatura i uchwyt zmiany rozmiaru | ✓ | ✓ |
| Eksport PNG i SVG bez okna | ✓ | ✓ |
| Ribbon z KeyTips, galeriami, paskiem szybkiego dostępu i widokiem backstage | − | ✓ |
| Formularz Ribbon: pasek szybkiego dostępu i tytuł w pasku tytułu z motywem | − | ✓ |
| Menu przepełnienia | − | ✓ |
| Linki Action (Delphi) i Command (.NET) | − | ✓ |
| Komponent | Cel |
|---|---|
| TsgcVCLToolbar, TsgcVCLStatusBar | Delphi i C++ Builder, VCL (sgcToolbar_VCL) |
| TsgcFMXToolbar, TsgcFMXStatusBar | Delphi i C++ Builder, FireMonkey (sgcToolbar_FMX) |
| Ribbon | Edycja zarejestrowana: VCL, FireMonkey, WinForms, WPF i Avalonia |
| TsgcVCLRibbonForm, TsgcFMXRibbonForm | Edycja zarejestrowana: Delphi i C++ Builder, VCL i FireMonkey (sgcToolbar_RibbonForm_VCL, sgcToolbar_RibbonForm_FMX), pasek tytułu z motywem w Windows |
| TsgcWinFormsRibbonForm, TsgcWpfRibbonWindow, TsgcAvaloniaRibbonWindow | Edycja zarejestrowana: .NET, WinForms, WPF i Avalonia |
| TsgcToolbarItem, TsgcStatusBarPanel, TsgcToolbarModel, TsgcStatusBarModel | Modele niezależne od frameworka (sgcToolbar_Model) |
| TsgcWinFormsToolbar, TsgcWinFormsStatusBar | .NET, WinForms |
| TsgcWpfToolbar, TsgcWpfStatusBar | .NET, WPF |
| TsgcAvaloniaToolbar, TsgcAvaloniaStatusBar | .NET, Avalonia |
| Cel | Komponent | Platformy |
|---|---|---|
| Delphi 7 do 13, VCL | TsgcVCLToolbar, TsgcVCLStatusBar | Win32 i Win64 |
| Delphi XE6 do 13, FireMonkey | TsgcFMXToolbar, TsgcFMXStatusBar | Windows, macOS, iOS, Android i Linux (FMXLinux) |
| C++ Builder 2007 do 13 | Paski VCL i FireMonkey | Wygenerowane nagłówki .hpp i biblioteki statyczne |
| Delphi 10.2 do 13, bez frameworka | Modele i renderer PNG oraz SVG bez okna | Linux64, na przykład do renderowania paska narzędzi na serwerze |
| .NET Framework 4.7.2, .NET 8, 9 i 10 | TsgcWinFormsToolbar, paski WPF i Avalonia | WinForms, WPF i Avalonia |
Tak. SetPanelText, SetProgress i SetIndicator można wywoływać z dowolnego wątku, bez Synchronize ani Queue. Model chroni wartości blokadą, a pasek odrysowuje się w wątku głównym. Każda inna właściwość jest ustawiana z wątku głównego. Zobacz Aktualizacje bezpieczne wątkowo.
Obsługuje te same zadania: przyciski, przełączniki, przyciski rozwijane, separatory i etykiety u góry, panele tekstowe na dole. Dodaje pozycję spacer, panele postępu i wskaźników, settery bezpieczne wątkowo, motywy i eksport bez okna. Twoje istniejące komponenty TActionList i TPopupMenu podłączasz przez Action i DropdownMenu.
Ribbon i formularz Ribbon, menu przepełnienia i linków Action pozycji, czyli Command i CommandParameter w .NET. W Community pozycje, które się nie mieszczą, są przycinane. Każda inna funkcja, w tym aktualizacje stanu bezpieczne wątkowo, panele postępu i wskaźników oraz eksport bez okna, jest w Community.
Tak. C++ Builder 2007 do 13 używa tych samych pasków VCL i FireMonkey przez wygenerowane nagłówki i biblioteki, a dema EditorShell i LiveStatus są dostępne także jako projekty C++ Builder. Zakładka z kodem na tej stronie pokazuje ten sam pasek narzędzi w Delphi, C++ Builder i C#.
Tak. Wszystkie rozmiary to piksele logiczne pomnożone przez skalę monitora, a miejsce na ikonę ma 16 pikseli logicznych, więc przyciski, glify, paski postępu i kropki wskaźników pozostają ostre przy dowolnym DPI. FireMonkey bierze obrazy z listy obrazów w rozmiarze urządzenia ramki.
Tak. SaveToSVG i SaveToPNG z TsgcToolbarModel i TsgcStatusBarModel rysują paski bez okna, także na Linux64 od Delphi 10.2, więc krok budowania może odtwarzać obrazy Twojego podręcznika przy każdym wydaniu. Parametr skali daje ostre obrazy na ekranach o wysokim DPI i do druku.
Wprowadzenie, Szybki start VCL, Szybki start FireMonkey, TsgcVCLToolbar, TsgcVCLStatusBar, Rodzaje pozycji, Przegląd Ribbonu, Ribbon KeyTips, Ribbon backstage, Panele stanu, Aktualizacje bezpieczne wątkowo, Edycje, Platformy.
Wprowadzenie, Szybki start C++ Builder, TsgcVCLToolbar, TsgcVCLStatusBar, Dema.
Przegląd .NET, Szybki start WinForms, Szybki start WPF, Szybki start Avalonia, Różnice względem Delphi.
Delphi, C++ Builder i .NET, obejmujące każdy produkt sgcUI.
Dodaj panel boczny lub akordeon z tymi samymi tokenami motywu, a pasek narzędzi, pasek stanu i menu utworzą jedną powłokę aplikacji.
Poznaj sgcNavigation →
Umieść selektory dat, suwaki i edytory tokenów w formularzach pod paskiem narzędzi, z tym samym motywem i kolorem akcentu.
Poznaj sgcEditors →
Połącz pasek stanu z siatką danych na żywo i pokaż liczbę wierszy, filtr i stan źródła danych jako panele.
Poznaj sgcGrid →