모든 UI에서 똑같이 보이는 컨트롤로 데스크톱 애플리케이션의 틀을 만드세요. 버튼, 토글, 라디오 그룹, 드롭다운을 갖춘 툴바, 툴바로는 부족해진 애플리케이션을 위한 탭, 갤러리, KeyTips, 백스테이지 뷰를 갖춘 Ribbon(빠른 실행 도구 모음이 테마가 적용된 제목 표시줄에 들어갑니다), 그리고 작업 스레드가 직접 업데이트할 수 있는 진행률 및 표시등 패널을 갖춘 진짜 상태 표시줄입니다.
모든 데스크톱 애플리케이션에 필요한 바를 위한 14가지 기능으로, 완전한 Ribbon과 라디오 그룹부터 작업 스레드의 실시간 진행률까지 다룹니다.
툴바에 담기에는 명령이 너무 많은 애플리케이션을 위한 Office 스타일 Ribbon으로, 모든 sgcUI 프레임워크에서 제공됩니다.
Ribbon Registered 에디션 전용
사용자는 노트북에서 보고서 편집기를 열고 창을 화면 절반에 맞춰도 모든 명령에 접근할 수 있기를 기대합니다. Ribbon이 이를 지켜 줍니다. 명령은 탭과 그룹에 담기고, 창이 좁아지면 지정한 우선순위에 따라 각 그룹이 큰 버튼에서 중간 버튼, 작은 버튼으로 줄어들다가 마지막에는 하나의 버튼으로 접힙니다. 모두 접히면 Ribbon이 스크롤됩니다. 갤러리는 전체 행에서 더 적은 열로, 그다음 드롭다운으로 줄어듭니다. Alt 키를 누르면 KeyTips가 나타나고, 탭과 명령을 입력하며 Esc로 한 단계 돌아갑니다. 애플리케이션 버튼은 명령과 사용자 컨트롤을 담는 페이지가 있는 백스테이지 뷰를 엽니다. 빠른 실행 도구 모음은 Ribbon 위나 아래에 놓이며, 사용자는 메뉴나 오른쪽 클릭으로 사용자 지정할 수 있습니다.
ICommand, WPF와 Avalonia에서는 XAML 선언SaveLayout과 LoadLayout이 사용자별 빠른 실행 도구 모음과 최소화 상태를 JSON으로 보관Registered 에디션에서 VCL, FireMonkey, WinForms, WPF, Avalonia, Delphi 7부터 13까지와 C++ Builder를 지원합니다. Community에는 Ribbon이 포함되지 않습니다. KeyTips는 Windows 데스크톱에서 동작합니다. 빠른 실행 도구 모음은 자체 행을 갖거나, Ribbon 폼이 창의 제목 표시줄에 그립니다.
Ribbon 개요Ribbon Registered 에디션 전용
Office 애플리케이션에는 Ribbon 위에 회색 Windows 캡션이 없습니다. 빠른 실행 도구 모음과 문서 이름이 제목 표시줄에 있고, 제목 표시줄과 Ribbon이 하나의 표면처럼 보입니다. Ribbon 폼은 창에 같은 프레임을 줍니다. 폼에 올려놓고 Ribbon을 선택하면, sgcUI가 기본 캡션을 제거하고 창 아이콘, 빠른 실행 도구 모음, 창 가운데에 놓인 캡션, 최소화, 최대화, 닫기 버튼이 있는 테마가 적용된 제목 표시줄을 그립니다. 색은 Ribbon 테마(Classic 또는 Fluent, 라이트 또는 다크)의 탭 행 색입니다. Ribbon은 그 바로 아래에 놓이며 한 행 더 낮아집니다. 창은 그림자, 크기 조절 테두리, 최대화 동작을 그대로 유지하고, Windows 11은 최대화 버튼에서 스냅 레이아웃을 표시하며, 제목 표시줄의 빈 공간을 끌면 창이 이동합니다.
TsgcVCLRibbonForm과 TsgcFMXRibbonForm, .NET의 TsgcWinFormsRibbonForm, TsgcWpfRibbonWindow, TsgcAvaloniaRibbonWindowQATPosition을 rqpBelow로 하거나 ShowQAT를 끄면 제목 표시줄에는 캡션만 표시되며, Show above the Ribbon 명령이 도구 모음을 다시 위로 옮깁니다CaptionAlignment는 캡션을 가운데에 놓거나 아이콘 뒤에 놓고, TitleBarHeight는 높이를 정합니다Ribbon으로 XAML에서 설정합니다Ribbon과 마찬가지로 Registered 에디션입니다. Community에는 Ribbon 폼이 포함되지 않습니다. 테마가 적용된 프레임에는 데스크톱 컴포지션이 있는 Windows가 필요하며, FireMonkey에서는 Windows에서만 적용됩니다. 적용되지 않으면 Ribbon은 자체 빠른 실행 도구 모음 행을 표시합니다.
도움말 항목 읽기명령 바에 필요한 모든 항목을 제공하며 그룹화, 메뉴, 오버플로는 컨트롤이 처리합니다.
명령
실제 애플리케이션 툴바에는 일반 버튼, 눌린 상태를 유지하는 버튼, 메뉴가 있는 버튼, 구분선, 약간의 텍스트가 섞여 있습니다. sgcToolbar에서는 이들이 모두 같은 컬렉션의 항목 하나이며, Kind가 그리는 방식과 동작을 결정합니다. 항목은 Spacing 간격으로 왼쪽에서 오른쪽으로 배치되고 스페이서가 남은 너비를 차지하므로, 레이아웃 코드 없이 Help나 사용자 이름을 오른쪽 끝으로 밀 수 있습니다. 크기를 고정하고 싶을 때는 Width를 사용하세요. 힌트, 비활성 상태, 핫 트래킹은 모든 종류에 대해 그려집니다.
tikButton, tikToggle, tikDropdowntikSeparator는 가는 세로선을 그립니다tikSpacer는 뒤따르는 항목을 오른쪽으로 밉니다tikLabel은 바 안에 텍스트를 표시합니다
명령
텍스트 정렬, 보기 모드, 그리기 도구는 전형적인 여럿 중 하나를 고르는 선택입니다. 여러 토글 항목에 같은 GroupIndex를 지정하면 라디오 그룹이 됩니다. 클릭하거나 코드에서 그중 하나의 Down을 설정하면 나머지는 해제되고, 이미 눌린 항목을 클릭해도 눌린 상태로 남으므로 항상 하나가 선택된 상태가 유지됩니다. GroupIndex가 0인 토글은 Bold나 Word wrap 같은 단순한 켜기와 끄기 스위치입니다. OnItemClick이 발생하기 전에 클릭이 Down을 뒤집으므로 핸들러는 새 상태를 읽을 수 있습니다. 그룹의 일관성을 유지하기 위해 이벤트를 연결할 필요가 없습니다.
GroupIndex가 0보다 크면 라디오 그룹이 됩니다Down으로 코드에서 상태를 읽거나 설정합니다Down을 구동합니다명령
확대 수준, 내보내기 형식, 최근 파일은 버튼 열 개가 아니라 버튼 아래의 메뉴에 속합니다. tikDropdown 항목은 캡션 뒤에 작은 화살표를 그리고, DropdownMenu에 지정한 팝업 메뉴를 버튼 바로 아래에 표시합니다. VCL과 FireMonkey에서는 TPopupMenu, WinForms에서는 ContextMenuStrip입니다. OnItemClick과 항목의 OnClick은 메뉴가 열리기 전에 발생하므로 먼저 항목을 채우거나 체크할 수 있습니다. 메뉴가 해제되면 바가 참조를 자동으로 지웁니다. 클릭 대상 하나, 메뉴 하나로 명령이 늘어나도 툴바는 짧게 유지됩니다.
DropdownMenu는 사용 중인 프레임워크의 팝업을 받습니다OnItemClick에서 메뉴를 채우거나 체크합니다명령 Registered 에디션 전용
사용자는 창 크기를 조절하며, 마지막 버튼을 그냥 잘라 버리는 툴바는 필요한 명령을 숨깁니다. 항목이 맞지 않으면 sgcToolbar는 마지막 항목들을 오버플로 목록으로 옮기고 오른쪽 끝에 이중 화살표 버튼을 그립니다. 이 버튼을 누르면 숨겨진 항목마다 하나씩 실행 중에 만들어지는 OverflowMenu가 표시되고, 항목을 선택하면 클릭과 똑같이 동작합니다. 토글은 전환되고, OnItemClick이 발생하며, 드롭다운은 메뉴를 표시합니다. 모델이 무엇이 숨겨졌는지 알려 줍니다. 창이 다시 커지면 항목은 스스로 바로 돌아옵니다.
OverflowMenu는 실행 중에 자동으로 만들어집니다HasOverflow, OverflowCount, InOverflowItemAtPos는 오버플로 버튼 위의 히트를 알려 줍니다SGC_TOOLBAR_ADVANCED 아래에서 컴파일됩니다Community: 맞지 않는 항목은 잘리며 오버플로 버튼이 없습니다.
도움말 항목 읽기명령 Registered 에디션 전용
명령이 이미 TActionList에 있다면 툴바가 이를 중복해서는 안 됩니다. 항목을 Action 속성으로 VCL 또는 FireMonkey TAction에 연결하면 액션의 Caption, Enabled, Visible, Hint, ImageIndex, Checked를 따릅니다. 항목에 OnClick 핸들러가 없다면 클릭 시 바를 ActionComponent로 하여 액션이 실행됩니다. 바는 유휴 시간에 InitiateAction을 호출하므로 비활성화된 액션은 추가 코드 없이 해당 버튼을 비활성화합니다. .NET에서 항목에는 ICommand용 Command와 CommandParameter가 있습니다. TActionList 하나로 툴바, 메인 메뉴, 내비게이션 바를 함께 구동할 수 있습니다.
Action은 항목을 임의의 TBasicAction에 연결합니다Down을 구동합니다Command와 CommandParameterCommunity: 액션 대신 항목의 OnClick 또는 바의 OnItemClick을 처리하세요.
도움말 항목 읽기스스로 레이아웃을 맞추고, 진행률과 상태를 표시하며, 모든 스레드의 업데이트를 받아들이는 상태 표시줄입니다.
상태 표시줄
줄과 열, 파일 이름, 저장 상태, 주 메시지가 모두 창의 아래쪽 가장자리를 두고 경쟁합니다. TsgcVCLStatusBar는 Panels를 왼쪽에서 오른쪽으로 세 단계에 걸쳐 배치합니다. 고정 패널은 Width를 차지하고, AutoSize 패널은 텍스트 너비를 차지하며, Spring 패널은 남은 너비를 나눠 가집니다. 주 메시지에 스프링 패널 하나를 사용하면 창 크기에 관계없이 바가 깔끔하게 유지됩니다. 가는 선이 패널을 구분하고 OnPanelClick이 어떤 패널이 클릭되었는지 알려 줍니다. 패널은 컬렉션이므로 디자인 타임에 오브젝트 인스펙터에서 추가하고 편집할 수 있습니다.
Alignment와 Hint를 가진 spkText 패널Spring 패널은 남은 너비를 나눠 가집니다AutoSize 패널은 텍스트에 맞춰집니다OnPanelClick은 패널 클릭을 알려 줍니다
상태 표시줄
오래 걸리는 작업에는 진행률 표시줄이, 실시간 연결에는 모든 것이 정상인지 알려 주는 표시등이 필요합니다. 패널은 Progress 퍼센트까지 강조색으로 채워지는 진행률 표시줄이 될 수도 있고, 색상 점 뒤에 패널 텍스트가 오는 표시등이 될 수도 있습니다. IndicatorState는 off, ok, warning, error 중 하나를 고르며, 녹색, 황색, 적색은 라이트 테마와 다크 테마에 맞게 따로 조정되어 있습니다. 데이터베이스 연결, 데이터 피드, 백그라운드 동기화의 상태를 표시하는 데 적합합니다. Progress나 IndicatorState를 설정하면 패널이 스스로 다시 그려지므로 작성할 그리기 코드가 없습니다.
Progress를 가진 spkProgressIndicatorState를 가진 spkIndicatorsisOff, sisOk, sisWarning, sisErrorGetIndicatorColor는 테마에 맞는 색상을 반환합니다상태 표시줄
다운로드, 피드, 긴 계산은 작업자 스레드에서 실행되며, 모든 상태 업데이트를 메인 스레드로 되돌리는 일은 번거롭고 실수하기 쉽습니다. SetPanelText, SetProgress, SetIndicator는 Synchronize나 Queue 없이 어느 스레드에서든 호출할 수 있습니다. 모델이 잠금으로 값을 보호하고 값이 실제로 바뀐 경우에만 OnChange를 발생시키므로 같은 값을 반복해도 비용이 들지 않습니다. 그러면 VCL 바는 창에 메시지를 보내고 FireMonkey 바는 다시 그리기를 큐에 넣으므로 UI는 메인 스레드 밖에서 절대 건드려지지 않습니다. 패널보다 오래 사는 스레드도 안전합니다.
SetPanelText, SetProgress, SetIndicatorSynchronize나 Queue가 필요 없습니다sgcUI의 나머지 제품과 일치하는 아이콘, 테마, 키보드 지원과 문서용 바 이미지를 제공합니다.
모양, 키보드, 출력
클릭할 수 있는 모든 항목에는 논리 픽셀 16의 아이콘 자리가 있습니다. 바의 Images 목록에서 ImageIndex의 이미지를 표시하고, 항목에 이미지가 없으면 Glyph를 표시합니다. Glyph는 이미지 목록이 전혀 필요 없는 문자 또는 짧은 기호입니다. ShowCaptions를 끄면 아이콘만 있는 컴팩트한 바가 되고 캡션은 힌트가 되므로 잃는 것이 없습니다. VCL 이미지 목록은 알파를 복원해 한 번 스트레이트 ARGB로 변환되고 목록이 바뀔 때까지 캐시되므로 마스크 목록과 32비트 목록 모두 올바르게 보입니다. 아이콘을 아직 디자인하는 중에는 둘을 자유롭게 섞어 쓰세요.
Images와 ImageIndexGlyphShowCaptions를 False로MirrorGlyph는 뒤로, 앞으로, 실행 취소, 다시 실행 같은 방향성 아이콘을 뒤집습니다
모양, 키보드, 출력
바는 제품군의 모든 제품이 사용하는 sgcUICore 테마 토큰에서 색상을 가져오므로, sgcGrid 위에 있고 sgcNavigation 바 옆에 있는 툴바가 하나의 애플리케이션처럼 보입니다. Theme는 utLight 또는 utDark를 선택하고, AccentColor는 포커스 링, 토글의 눌린 틴트, 진행률 표시줄에 쓰이는 강조색을 바꿉니다. 핫, 눌림, 다운, 포커스, 비활성 상태는 모두 자동으로 파생됩니다. 각 바에는 자체 Theme가 있으므로 툴바와 상태 표시줄에 각각 설정하세요. 실행 중에 전환하면 두 바가 한꺼번에 다시 그려집니다.
Theme: utDefault(기본값, 애플리케이션 테마를 따름), utLight 또는 utDarkAccentColor, 0이면 테마 강조색을 유지합니다모양, 키보드, 출력
사용자가 필요로 하면 툴바를 탭 순서에 넣을 수 있습니다. TabStop을 설정하면 포커스된 버튼에 포커스 링이 나타나고, 왼쪽과 오른쪽 화살표는 활성화된 버튼 사이를 이동하며, Home과 End는 처음과 끝으로 이동하고, Enter 또는 Space로 활성화합니다. 기본값은 꺼져 있으므로 툴바가 아래의 편집기에서 포커스를 빼앗는 일은 없습니다. ClickItem은 폼 단축키 등에서 코드로 항목을 활성화합니다. 상태 표시줄에서 SizeGrip은 핸들 점을 그리며, VCL에서는 이를 끌어 크기를 조절할 수 있는 폼의 크기를 변경합니다. FireMonkey에서는 핸들이 그려지지만 폼 크기는 변경되지 않으므로, 폼의 크기를 조절할 수 없다면 SizeGrip을 꺼 두세요.
TabStop, FireMonkey의 CanFocusClickItem은 코드에서 항목을 실행합니다SizeGrip과 GripRect모양, 키보드, 출력
매뉴얼 속 툴바 스크린샷은 릴리스마다 낡아집니다. sgcToolbar_Render의 렌더러는 창도 VCL이나 FireMonkey도 없이 TsgcToolbarModel 또는 TsgcStatusBarModel을 그리므로, 콘솔 프로그램, 테스트, 웹 서버도 같은 바를 이미지로 만들 수 있습니다. SaveToPNG와 SaveToSVG는 논리 픽셀 크기와 scale을 받으므로, scale 2에서 560x44는 선명한 1120x88 그림이 됩니다. 이 유닛은 Linux64를 포함한 모든 플랫폼에서 빌드됩니다. OnGetImage로 사용자 이미지를 전달하면 그림이 실행 중인 애플리케이션과 일치합니다.
SaveToPNG는 PNG 파일 또는 스트림을 씁니다SaveToSVG는 같은 바를 SVG로 씁니다TsgcToolbarModel과 TsgcStatusBarModel에서 동작합니다OnGetImage는 헤드리스 출력에 아이콘을 제공합니다sgcUI 제품군 데모 속의 sgcToolbar: 내장 시뮬레이션 데이터로 오프라인에서 실행되는 완전한 애플리케이션입니다.
이벤트 삽입, 속도 단추, 테마 전환이 있는 상단 바와 아래의 상태 표시줄.
Altamira Fleet →
검색, 새로 만들기, 알림, 사용자 메뉴가 있는 ERP 상단 바.
Altamira ERP →
가상 시나리오 초기화와 테마 전환이 있는 PMO 상단 바.
Altamira PMO →
결함 주입, 모두 확인, 속도 조절이 있는 공장 상단 바.
Altamira Plant →
편집기에는 Bold와 Italic 토글, 정렬 라디오 그룹, Zoom 메뉴, 줄, 열, 저장 상태를 보여 주는 상태 표시줄이 필요합니다. sgcToolbar는 항목 컬렉션 하나와 패널 컬렉션 하나로 이 모든 것을 다루며 이미 사용 중인 TActionList에 연결됩니다. 창이 좁아지면 오버플로 메뉴가 모든 명령에 계속 접근할 수 있게 해 줍니다. EditorShell 데모는 TMemo를 둘러싸고 정확히 이렇게 구성되어 있습니다.
가져오기 도구, 동기화 클라이언트, 모니터링 앱은 백그라운드 스레드에서 작업하며 그 상황을 보고해야 합니다. 작업자 스레드에서 SetProgress, SetIndicator, SetPanelText를 바로 호출하면 코드에 Synchronize 없이 상태 표시줄이 메인 스레드에서 다시 그려집니다. 표시등은 작업의 상태에 따라 녹색, 황색, 적색으로 바뀝니다. LiveStatus 데모는 정확히 이렇게 동작하는 다운로드를 시뮬레이션합니다.
Windows, macOS, 모바일로 배포하는 FireMonkey 애플리케이션에도 어디서나 같은 툴바가 필요합니다. TsgcFMXToolbar와 TsgcFMXStatusBar는 VCL 바와 같은 항목, 패널, 이벤트를 가지며 WinForms, WPF, Avalonia용 .NET 바도 같은 이름을 따릅니다. EditorShellFMX는 같은 항목, 오버플로 메뉴, 상태 패널을 갖춘 에디터 셸의 FireMonkey 버전입니다.
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;Office 스타일 창: TsgcVCLRibbonForm이 빠른 실행 도구 모음과 가운데 캡션을 테마가 적용된 제목 표시줄로 옮깁니다.
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.WinFormsEditorShell과 LiveStatus 데모는 VCL과 C++ Builder용으로, Delphi용 FireMonkey 버전과 함께 제공되며, .NET 에디션에서는 WinForms, WPF, Avalonia 프로젝트로 제공됩니다. Registered 에디션은 Ribbon 데모인 RibbonShell, RibbonForm, RibbonSuite를 추가합니다.
토글, Left, Center, Right 라디오 그룹, Zoom 드롭다운, TActionList 링크, 오버플로 메뉴, 줄과 열 패널, Dark 토글을 갖춘 TMemo 편집기 셸입니다. 오버플로와 액션을 사용하므로 Registered 또는 체험판 에디션이 필요합니다.
작업자 스레드가 다운로드를 시뮬레이션하며 텍스트 패널, 진행률 패널, 녹색, 황색, 적색으로 바뀌는 표시등을 갱신하고, Start와 Stop 버튼이 있습니다. Community 에디션으로 빌드됩니다.
FireMonkey TMemo를 TsgcFMXToolbar와 TsgcFMXStatusBar가 둘러싼 EditorShell 데모이며 Delphi 전용입니다. 같은 항목, 액션 링크, 오버플로 메뉴, 상태 패널을 제공합니다.
탭, 그룹, 갤러리, 상황별 탭, 빠른 실행 도구 모음, KeyTips, 백스테이지 뷰를 갖춘 Ribbon을 감싼 문서 셸입니다. RibbonShell은 VCL 데모이고 RibbonShellFMX는 FireMonkey 데모이며, 둘 다 C++ Builder 짝이 있습니다. RibbonShell, RibbonShellWpf, RibbonShellAvalonia는 .NET 프로젝트입니다.
VCL용과 FireMonkey용 Office 스타일 편집기 창으로 C++ Builder 쌍둥이도 있습니다. 창 아이콘 옆 제목 표시줄에 저장, 실행 취소, 다시 실행이 있는 빠른 실행 도구 모음이 있고, 캡션은 가운데에 있으며, 바로 아래에 파일 버튼과 홈, 삽입, 보기 탭이 있는 Ribbon이 있습니다. 체크 상자 하나는 빠른 실행 도구 모음을 Ribbon 아래로 옮기고, 다른 하나는 테마 프레임을 끄며, 테마 선택기는 Light, Dark, Fluent를 전환합니다. .NET 에디션에서는 WinForms용 RibbonForm, RibbonFormWpf, RibbonFormAvalonia로 제공됩니다.
하나의 폼에서 여러 sgcUI 제품을 구동하는 하나의 Ribbon입니다. 명령은 스위트의 다른 sgcUI 컨트롤에 작용합니다.
Delphi(VCL)용 QuickStart 데모 다섯 개가 Demos\Toolbar\Delphi\00.QuickStart에 포함되어 있습니다. PDF 가이드가 단계별로 안내하는 내용은 다음과 같습니다. 첫 번째 툴바, 모든 종류의 항목, 액션과 상태 표시줄, 테마, 작은 텍스트 편집기.
sgcToolbar는 Standard부터 시작하는 모든 sgcUI 에디션에 포함되어 있으며 단독으로도 판매됩니다. 또한 All-Access 번들에도 포함되어 있습니다.
무료 Community 에디션(NuGet의 esegece.sgcToolbar.Community)에는 Ribbon과 Ribbon 폼, 오버플로 메뉴와 액션 링크가 빠져 있습니다.
| 기능 | Community (무료) | Registered 에디션 |
|---|---|---|
| 모든 항목 종류, 토글, 라디오 그룹, 드롭다운 메뉴 | ✓ | ✓ |
| 텍스트, 진행률, 표시등 패널 | ✓ | ✓ |
| 스레드 안전 상태 업데이트 | ✓ | ✓ |
| 아이콘, 글리프, 테마, 키보드, 크기 조절 핸들 | ✓ | ✓ |
| 헤드리스 PNG 및 SVG 출력 | ✓ | ✓ |
| KeyTips, 갤러리, 빠른 실행 도구 모음, 백스테이지 뷰를 갖춘 Ribbon | − | ✓ |
| Ribbon 폼: 테마 제목 표시줄의 빠른 실행 도구 모음과 캡션 | − | ✓ |
| 오버플로 메뉴 | − | ✓ |
| 액션 링크(Delphi)와 Command(.NET) | − | ✓ |
| 컴포넌트 | 대상 |
|---|---|
| TsgcVCLToolbar, TsgcVCLStatusBar | Delphi 및 C++ Builder, VCL (sgcToolbar_VCL) |
| TsgcFMXToolbar, TsgcFMXStatusBar | Delphi 및 C++ Builder, FireMonkey (sgcToolbar_FMX) |
| Ribbon | Registered 에디션: VCL, FireMonkey, WinForms, WPF, Avalonia |
| TsgcVCLRibbonForm, TsgcFMXRibbonForm | Registered 에디션: Delphi 및 C++ Builder, VCL 및 FireMonkey (sgcToolbar_RibbonForm_VCL, sgcToolbar_RibbonForm_FMX), Windows의 테마 제목 표시줄 |
| TsgcWinFormsRibbonForm, TsgcWpfRibbonWindow, TsgcAvaloniaRibbonWindow | Registered 에디션: .NET, WinForms, WPF, Avalonia |
| TsgcToolbarItem, TsgcStatusBarPanel, TsgcToolbarModel, TsgcStatusBarModel | 프레임워크 중립 모델 (sgcToolbar_Model) |
| TsgcWinFormsToolbar, TsgcWinFormsStatusBar | .NET, WinForms |
| TsgcWpfToolbar, TsgcWpfStatusBar | .NET, WPF |
| TsgcAvaloniaToolbar, TsgcAvaloniaStatusBar | .NET, Avalonia |
| 대상 | 컴포넌트 | 플랫폼 |
|---|---|---|
| Delphi 7부터 13, VCL | TsgcVCLToolbar, TsgcVCLStatusBar | Win32 및 Win64 |
| Delphi XE6부터 13, FireMonkey | TsgcFMXToolbar, TsgcFMXStatusBar | Windows, macOS, iOS, Android, Linux(FMXLinux) |
| C++ Builder 2007부터 13 | VCL 및 FireMonkey 바 | 생성된 .hpp 헤더와 정적 라이브러리 |
| Delphi 10.2부터 13, 프레임워크 중립 | 모델과 헤드리스 PNG 및 SVG 렌더러 | Linux64, 예를 들어 서버에서 툴바를 렌더링할 때 |
| .NET Framework 4.7.2, .NET 8, 9 및 10 | TsgcWinFormsToolbar, WPF 및 Avalonia 바 | WinForms, WPF, Avalonia |
네. SetPanelText, SetProgress, SetIndicator는 Synchronize나 Queue 없이 어느 스레드에서든 호출할 수 있습니다. 모델이 잠금으로 값을 보호하고 바는 메인 스레드에서 다시 그려집니다. 다른 모든 속성은 메인 스레드에서 설정합니다. 스레드 안전 업데이트를 참조하세요.
같은 역할을 모두 합니다. 위쪽에는 버튼, 토글, 드롭다운 버튼, 구분선, 라벨이, 아래쪽에는 텍스트 패널이 있습니다. 여기에 스페이서 항목, 진행률 및 표시등 패널, 스레드 안전 setter, 테마, 헤드리스 출력이 더해집니다. 기존 TActionList와 TPopupMenu 컴포넌트는 Action과 DropdownMenu로 연결됩니다.
Ribbon과 Ribbon 폼, 오버플로 메뉴와 항목의 액션 링크이며, .NET에서는 Command와 CommandParameter에 해당합니다. Community에서는 맞지 않는 항목이 잘립니다. 스레드 안전 상태 업데이트, 진행률 및 표시등 패널, 헤드리스 출력을 포함한 다른 모든 기능은 Community에 들어 있습니다.
네. C++ Builder 2007부터 13까지는 생성된 헤더와 라이브러리를 통해 같은 VCL 및 FireMonkey 바를 사용하며, EditorShell과 LiveStatus 데모도 C++ Builder 프로젝트로 제공됩니다. 이 페이지의 코드 탭에서 같은 툴바를 Delphi, C++ Builder, C#으로 볼 수 있습니다.
네. 모든 크기는 논리 픽셀에 모니터의 배율을 곱한 값이고 아이콘 자리는 논리 픽셀 16이므로, 버튼, 글리프, 진행률 표시줄, 표시등 점이 어떤 DPI에서도 선명합니다. FireMonkey는 프레임의 장치 크기에 맞춰 이미지 목록에서 이미지를 가져옵니다.
네. TsgcToolbarModel과 TsgcStatusBarModel의 SaveToSVG와 SaveToPNG는 Delphi 10.2부터 Linux64에서도 창 없이 바를 그리므로, 빌드 단계에서 릴리스마다 매뉴얼의 그림을 다시 생성할 수 있습니다. scale 매개변수로 고DPI 화면과 인쇄용 선명한 이미지를 얻을 수 있습니다.
소개, 빠른 시작 VCL, 빠른 시작 FireMonkey, TsgcVCLToolbar, TsgcVCLStatusBar, 항목 종류, Ribbon 개요, Ribbon KeyTips, Ribbon 백스테이지, 상태 패널, 스레드 안전 업데이트, 에디션, 플랫폼.
소개, 빠른 시작 C++ Builder, TsgcVCLToolbar, TsgcVCLStatusBar, 데모.
Delphi, C++ Builder, .NET용이며 sgcUI 제품 전체를 다룹니다.
