sgcUI sgcToolbar를 지금 바로 사용할 수 있어요

sgcToolbar. 위에는 명령. 아래에는 실시간 상태.

어떤 UI에서도 똑같이 보이는 컨트롤 두 개로 데스크톱 애플리케이션의 뼈대를 만들어 보세요. 버튼, 토글, 라디오 그룹, 드롭다운이 있는 툴바와, 작업자 스레드가 직접 갱신할 수 있는 진행률 및 표시등 패널을 갖춘 진짜 상태 표시줄이에요. 소스 코드가 포함돼요.

체험판 다운로드 sgcToolbar 살펴보기

VCL
FireMonkey
WinForms
WPF
Avalonia
Delphi 7~13

LiveStatus 데모: 작업자 스레드가 다운로드를 흉내 내며 상태 표시줄의 텍스트 패널, 진행률 표시줄, 초록색 Running 표시등, 청크 카운터를 갱신해요

6툴바 항목 종류: 버튼, 토글, 드롭다운, 구분선, 스페이서, 레이블
3상태 패널 종류: 텍스트, 진행률, 표시등
0작업자 스레드에서 상태 표시줄을 갱신할 때 필요한 Synchronize 호출
5UI 프레임워크: VCL, FireMonkey, WinForms, WPF, Avalonia

모든 데스크톱 애플리케이션에 필요한 두 가지 바.

위에는 명령, 아래에는 상태, 그리고 백그라운드에서 도는 작업. sgcToolbar는 항목 컬렉션 하나와 패널 컬렉션 하나로 이 모두를 모든 프레임워크에서 처리해요.

툴바와 상태 표시줄
위에는 항목 종류 6가지, 아래에는 텍스트, 진행률, 표시등 패널이 있어요.
스레드에 안전한 상태
작업자 스레드에서 Synchronize 없이 패널 텍스트, 진행률, 표시등을 설정해요.
모든 UI 프레임워크
VCL, FireMonkey, WinForms, WPF, Avalonia에서 같은 항목 모델을 써요.
창 없는 출력
두 바를 창 없이 PNG나 SVG로 렌더링해요. Linux64도 지원해요.

동작하는 모습을 보세요.

체험판에 들어 있는 EditorShell과 LiveStatus 데모에서 캡처했어요.

EditorShell 툴바를 2배로 확대하고 버튼, 토글, 구분선, 드롭다운, 레이블, 스페이서를 짚어 준 모습

명령

툴바 항목 종류를 컨트롤 하나에 모두.

tikButton, tikToggle, tikDropdown은 명령용이고, tikSeparator와 tikLabel이 그 사이를 채워요.
tikSpacer는 남는 너비를 차지해서 도움말이나 사용자 이름을 오른쪽 끝으로 밀어 줘요.
토글에 같은 GroupIndex를 주면 이벤트 연결 없이 라디오 그룹이 돼요.

오버플로

들어가지 않는 항목은 오버플로 메뉴로 옮겨 가요.

이중 쉐브론 버튼이 OverflowMenu를 보여 주고, 이 메뉴는 숨은 항목마다 하나씩 항목을 실행 시간에 만들어요.
항목을 고르면 클릭과 똑같이 동작해요. 토글이 바뀌고, OnItemClick이 발생하고, 드롭다운은 메뉴를 보여 줘요.
창이 다시 넓어지면 항목들이 저절로 바로 돌아와요.

spkText, spkProgress, spkIndicator 패널: 커서 위치, 진행률 64퍼센트, sisWarning 표시등

상태 표시줄

스스로 배치되는 상태 패널.

고정 패널은 Width를 따르고, AutoSize 패널은 텍스트에 맞추고, Spring 패널은 남은 너비를 나눠 가져요.
spkProgress는 Progress 퍼센트만큼 강조 색으로 채워져요.
spkIndicator는 sisOff, sisOk, sisWarning, sisError에 맞는 점을 보여 주고, 라이트와 다크 테마에 맞게 조정돼 있어요.

실시간 상태

작업자 스레드에서 상태 표시줄을 갱신하세요.

SetPanelText, SetProgress, SetIndicator는 Synchronize나 Queue 없이 어느 스레드에서든 호출할 수 있어요.
모델이 락으로 값을 보호하고, 값이 실제로 바뀔 때만 OnChange를 발생시켜요.
바는 메인 스레드에서 다시 그려지므로, UI는 그 밖에서 절대 건드리지 않아요.

sgcToolbar 더 보기.

라디오 그룹, 드롭다운 메뉴, 테마, 아이콘만 있는 바를 데모에서 그대로 가져왔어요.

EditorShell 데모: Bold와 Italic 토글, Left, Center, Right 라디오 그룹, Zoom 드롭다운, 줄, 확대, 저장 상태 패널 — TMemo를 둘러싼 EditorShell 데모: 토글, 정렬 라디오 그룹, Zoom 드롭다운, 상태 패널.

GroupIndex를 공유하는 토글 항목이 라디오 그룹을 이루는 모습 — 같은 `GroupIndex`를 가진 토글은 라디오 그룹이 되고, 항상 하나는 선택된 상태로 남아요.

라이트 테마와 다크 테마의 툴바와 상태 표시줄 — `Theme` = `utLight` 또는 `utDark` 는 크기 조절 손잡이를 포함해 툴바와 상태 표시줄의 스타일을 바꿔요.

캡션이 있는 툴바와 글리프만 있는 컴팩트 바로 보여 준 같은 툴바 — `ShowCaptions`를 끄면 아이콘만 있는 컴팩트 바가 되고, 캡션은 힌트로 바뀌어요.

몇 줄로 만드는 툴바와 상태 표시줄.

토글, 라디오 그룹, 드롭다운, 그리고 클릭 핸들러에서 갱신되는 상태 표시줄이에요. Delphi, C++ Builder, C#에서 같은 API예요.

dotnet add package esegece.sgcToolbar.WinForms

C++ Builder와 C# 버전

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.OnItemClick := ToolbarItemClick;
  oItem := FToolbar.Items.Add;
  oItem.Kind := tikToggle;
  oItem.Caption := 'Bold';
  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;
  FStatusBar.Panels.Add.Kind := spkIndicator;
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;