sgcUI sgcWizard 现已发布

sgcWizard. 一步一步来。边走边验证。

引导用户完成设置、新手引导和结账。您添加的每个页面都会成为步骤条中的一个步骤，内置“上一步”“下一步”“完成”和“取消”，并且只需一个事件，就能在页面有效之前阻止切换。这是适用于 Delphi、C++ Builder 和 .NET 的原生向导与步骤条，并附带源代码。

下载试用版了解 sgcWizard

VCL
FireMonkey
WinForms
WPF
Avalonia
Delphi 7 至 13

1个事件验证每一次切换：下一步、上一步、完成、点击步骤或代码调用
5种步骤状态：待处理、当前、已完成、错误和已跳过
3种步骤条布局：顶部、左侧或隐藏
5个界面框架：VCL、FireMonkey、WinForms、WPF、Avalonia

向导所需的一切。

冗长的表单会让用户望而却步，而拆分成几个清晰步骤的同样字段则更容易填完。sgcWizard 把它们变成引导式流程，遵循您应用程序的规则和外观。

页面变成步骤
您添加的每个页面都会出现在步骤条中，并内置“上一步”“下一步”“完成”和“取消”。
带否决权的验证
OnBeforePageChange 会在页面有效之前阻止切换，无论用户按下了什么。
清晰的步骤状态
待处理、当前、已完成、错误和已跳过，一目了然。
贴合您的应用程序
自定义按钮文字、浅色和深色主题、强调色，以及在 IDE 中设计的页面。

看它运行。

录制自试用版附带的 Onboarding 演示。

Onboarding 演示：包含欢迎、账户、选项和摘要页面的四步向导，以及“上一步”“下一步”和“取消”按钮栏

页面与步骤

带内置步骤条的多步骤表单。

AddPage 会同时创建页面和它在步骤条中的步骤。
Caption、Description 和 StepGlyph 为每个步骤添加标签，让用户知道自己在哪里以及还剩什么。
Next、Back 和 GoToPage 的切换方式与按钮完全相同。

Onboarding 演示的摘要页面，由 OnPageChanged 填充，带有“完成”按钮

跳过与完成

跳过不适用的步骤，由您决定在哪里完成。

在页面上设置 Skip 后，“下一步”和“上一步”会跳过它，而步骤条仍以虚线轮廓显示该步骤。
OnFinish 在验证允许完成之后运行，因此保存代码集中在一处。
OnCancel 处理“取消”按钮、Escape 键以及对 Cancel 的调用。向导自己从不关闭任何内容。

StepperPosition 设为 wspLeft 的向导：带说明的垂直步骤栏，类似安装程序

步骤条布局

步骤条在顶部、左侧或隐藏。

StepperPosition 可取 wspTop、wspLeft 或 wspNone，无需改动您的页面。
CircleSize、ConnectorThickness 和 ShowDescriptions 设置步骤标记的大小和标签。
阿拉伯语和希伯来语的从右到左排版会镜像步骤条、步骤顺序以及“上一步”和“下一步”按钮。

无窗口输出

用于文档和测试的步骤条图像。

sgcWizardSaveToPNG 和 sgcWizardSaveToSVG 无需窗口，也无需 VCL 或 FireMonkey，即可绘制步骤条。
控制台程序、服务、单元测试或 Web 服务器都能获得图像形式的同一个步骤条，Linux64 也可以。
在 .NET 中，esegece.sgcWizard.Rendering 包可在 Windows、Linux 和 macOS 上写出 PNG。

sgcWizard 的更多功能。

步骤状态、独立步骤条、深色主题和自定义按钮文字，直接来自演示。

同一个步骤条中的已完成、已跳过、错误和待处理步骤 — 已完成、已跳过、错误和待处理的步骤。启用 `AutoStates` 后，`ActiveIndex` 会为您自动设置。

用于结账流程的独立步骤条 — 单独使用 `TsgcVCLStepper` 实现结账流程，`Clickable` 步骤可以点击返回。

带自定义“上一步”“下一步”“完成”和“取消”文字的向导页面 — `BackCaption`、`NextCaption`、`FinishCaption` 和 `CancelCaption` 可为按钮设置您自己的文字，这里使用的是西班牙语。

几行代码实现向导。

添加页面，把其中一个标记为可选，并在用户离开账户页面之前进行验证。Delphi、C++ Builder 和 C# 中的 API 相同。

dotnet add package esegece.sgcWizard.WinForms

C++ Builder 和 C# 版本

procedure TMainForm.CreateWizard;
var
  oPage: TsgcVCLWizardPage;
begin
  // the wizard fills the form: stepper on the left, buttons at the bottom
  FWizard := TsgcVCLWizard.Create(Self);
  FWizard.Parent := Self;
  FWizard.Align := alClient;
  FWizard.StepperPosition := wspLeft;
  FWizard.Theme := utDark;
  FWizard.NextCaption := 'Continue';
  FWizard.FinishCaption := 'Create account';
  // every page is a step of the stepper
  oPage := FWizard.AddPage('Welcome');
  oPage.Description := 'Start here';
  oPage := FWizard.AddPage('Account');
  oPage.Description := 'Your details';
  FName := TEdit.Create(Self);
  FName.Parent := oPage;
  FName.SetBounds(24, 24, 240, 24);
  // an optional page the user can skip: Next and Back jump over it
  FOptions := FWizard.AddPage('Options');
  FOptions.Description := 'Optional';
  FOptions.Skip := True;
  oPage := FWizard.AddPage('Done');
  oPage.Description := 'Summary';
  FWizard.ActivePageIndex := 0;
  FWizard.OnBeforePageChange := WizardBeforePageChange;
  FWizard.OnFinish := WizardFinish;
end;

procedure TMainForm.WizardBeforePageChange(Sender: TObject;
  aFromIndex, aToIndex: Integer; var aAllow: Boolean);
begin
  // veto: leaving Account forwards needs a name
  if (aFromIndex = 1) and (aToIndex > aFromIndex) then
    aAllow := Trim(FName.Text) <> '';
end;

procedure TMainForm.WizardFinish(Sender: TObject);
begin
  ShowMessage('Welcome, ' + FName.Text);
end;