gui-cs.Terminal.Gui/UICatalog/Scenarios/Wizards.cs

using System;
using Terminal.Gui;

namespace UICatalog.Scenarios;

[ScenarioMetadata ("Wizards", "Demonstrates the Wizard class")]
[ScenarioCategory ("Dialogs")]
[ScenarioCategory ("Top Level Windows")]
[ScenarioCategory ("Wizards")]
public class Wizards : Scenario
{
    public override void Setup ()
    {
        var frame = new FrameView
        {
            X = Pos.Center (),
            Y = 0,
            Width = Dim.Percent (75),
            ColorScheme = Colors.ColorSchemes ["Base"],
            Title = "Wizard Options"
        };
        Win.Add (frame);

        var label = new Label { X = 0, Y = 0, TextAlignment = Alignment.End, Text = "Width:" };
        frame.Add (label);

        var widthEdit = new TextField
        {
            X = Pos.Right (label) + 1,
            Y = Pos.Top (label),
            Width = 5,
            Height = 1,
            Text = "80"
        };
        frame.Add (widthEdit);

        label = new()
        {
            X = 0,
            Y = Pos.Bottom (label),

            Width = Dim.Width (label),
            Height = 1,
            TextAlignment = Alignment.End,
            Text = "Height:"
        };
        frame.Add (label);

        var heightEdit = new TextField
        {
            X = Pos.Right (label) + 1,
            Y = Pos.Top (label),
            Width = 5,
            Height = 1,
            Text = "20"
        };
        frame.Add (heightEdit);

        label = new()
        {
            X = 0,
            Y = Pos.Bottom (label),

            Width = Dim.Width (label),
            Height = 1,
            TextAlignment = Alignment.End,
            Text = "Title:"
        };
        frame.Add (label);

        var titleEdit = new TextField
        {
            X = Pos.Right (label) + 1,
            Y = Pos.Top (label),
            Width = Dim.Fill (),
            Height = 1,
            Text = "Gandolf"
        };
        frame.Add (titleEdit);

        void Top_Loaded (object sender, EventArgs args)
        {
            frame.Height = widthEdit.Frame.Height + heightEdit.Frame.Height + titleEdit.Frame.Height + 2;
            Top.Loaded -= Top_Loaded;
        }

        Top.Loaded += Top_Loaded;

        label = new()
        {
            X = Pos.Center (), Y = Pos.AnchorEnd (1), TextAlignment = Alignment.End, Text = "Action:"
        };
        Win.Add (label);

        var actionLabel = new Label
        {
            X = Pos.Right (label), Y = Pos.AnchorEnd (1), ColorScheme = Colors.ColorSchemes ["Error"]
        };
        Win.Add (actionLabel);

        var showWizardButton = new Button
        {
            X = Pos.Center (), Y = Pos.Bottom (frame) + 2, IsDefault = true, Text = "Show Wizard"
        };

        showWizardButton.Accept += (s, e) =>
                                   {
                                       try
                                       {
                                           var width = 0;
                                           int.TryParse (widthEdit.Text, out width);
                                           var height = 0;
                                           int.TryParse (heightEdit.Text, out height);

                                           if (width < 1 || height < 1)
                                           {
                                               MessageBox.ErrorQuery (
                                                                      "Nope",
                                                                      "Height and width must be greater than 0 (much bigger)",
                                                                      "Ok"
                                                                     );

                                               return;
                                           }

                                           actionLabel.Text = string.Empty;

                                           var wizard = new Wizard { Title = titleEdit.Text, Width = width, Height = height };

                                           wizard.MovingBack += (s, args) =>
                                                                {
                                                                    //args.Cancel = true;
                                                                    actionLabel.Text = "Moving Back";
                                                                };

                                           wizard.MovingNext += (s, args) =>
                                                                {
                                                                    //args.Cancel = true;
                                                                    actionLabel.Text = "Moving Next";
                                                                };

                                           wizard.Finished += (s, args) =>
                                                              {
                                                                  //args.Cancel = true;
                                                                  actionLabel.Text = "Finished";
                                                              };

                                           wizard.Cancelled += (s, args) =>
                                                               {
                                                                   //args.Cancel = true;
                                                                   actionLabel.Text = "Cancelled";
                                                               };

                                           // Add 1st step
                                           var firstStep = new WizardStep { Title = "End User License Agreement" };
                                           firstStep.NextButtonText = "Accept!";

                                           firstStep.HelpText =
                                               "This is the End User License Agreement.\n\n\n\n\n\nThis is a test of the emergency broadcast system. This is a test of the emergency broadcast system.\nThis is a test of the emergency broadcast system.\n\n\nThis is a test of the emergency broadcast system.\n\nThis is a test of the emergency broadcast system.\n\n\n\nThe end of the EULA.";
                                           wizard.AddStep (firstStep);

                                           // Add 2nd step
                                           var secondStep = new WizardStep { Title = "Second Step" };
                                           wizard.AddStep (secondStep);

                                           secondStep.HelpText =
                                               "This is the help text for the Second Step.\n\nPress the button to change the Title.\n\nIf First Name is empty the step will prevent moving to the next step.";

                                           var buttonLbl = new Label { Text = "Second Step Button: ", X = 1, Y = 1 };

                                           var button = new Button
                                           {
                                               Text = "Press Me to Rename Step", X = Pos.Right (buttonLbl), Y = Pos.Top (buttonLbl)
                                           };

                                           button.Accept += (s, e) =>
                                                            {
                                                                secondStep.Title = "2nd Step";

                                                                MessageBox.Query (
                                                                                  "Wizard Scenario",
                                                                                  "This Wizard Step's title was changed to '2nd Step'"
                                                                                 );
                                                            };
                                           secondStep.Add (buttonLbl, button);
                                           var lbl = new Label { Text = "First Name: ", X = 1, Y = Pos.Bottom (buttonLbl) };

                                           var firstNameField =
                                               new TextField { Text = "Number", Width = 30, X = Pos.Right (lbl), Y = Pos.Top (lbl) };
                                           secondStep.Add (lbl, firstNameField);
                                           lbl = new() { Text = "Last Name:  ", X = 1, Y = Pos.Bottom (lbl) };
                                           var lastNameField = new TextField { Text = "Six", Width = 30, X = Pos.Right (lbl), Y = Pos.Top (lbl) };
                                           secondStep.Add (lbl, lastNameField);

                                           var thirdStepEnabledCeckBox = new CheckBox
                                           {
                                               Text = "Enable Step _3",
                                               Checked = false,
                                               X = Pos.Left (lastNameField),
                                               Y = Pos.Bottom (lastNameField)
                                           };
                                           secondStep.Add (thirdStepEnabledCeckBox);

                                           // Add a frame 
                                           var frame = new FrameView
                                           {
                                               X = 0,
                                               Y = Pos.Bottom (thirdStepEnabledCeckBox) + 2,
                                               Width = Dim.Fill (),
                                               Height = 4,
                                               Title = "A Broken Frame (by Depeche Mode)"
                                           };
                                           frame.Add (new TextField { Text = "This is a TextField inside of the frame." });
                                           secondStep.Add (frame);

                                           wizard.StepChanging += (s, args) =>
                                                                  {
                                                                      if (args.OldStep == secondStep && string.IsNullOrEmpty (firstNameField.Text))
                                                                      {
                                                                          args.Cancel = true;

                                                                          int btn = MessageBox.ErrorQuery (
                                                                               "Second Step",
                                                                               "You must enter a First Name to continue",
                                                                               "Ok"
                                                                              );
                                                                      }
                                                                  };

                                           // Add 3rd (optional) step
                                           var thirdStep = new WizardStep { Title = "Third Step (Optional)" };
                                           wizard.AddStep (thirdStep);

                                           thirdStep.HelpText =
                                               "This is step is optional (WizardStep.Enabled = false). Enable it with the checkbox in Step 2.";
                                           var step3Label = new Label { Text = "This step is optional.", X = 0, Y = 0 };
                                           thirdStep.Add (step3Label);
                                           var progLbl = new Label { Text = "Third Step ProgressBar: ", X = 1, Y = 10 };

                                           var progressBar = new ProgressBar
                                           {
                                               X = Pos.Right (progLbl), Y = Pos.Top (progLbl), Width = 40, Fraction = 0.42F
                                           };
                                           thirdStep.Add (progLbl, progressBar);
                                           thirdStep.Enabled = (bool)thirdStepEnabledCeckBox.Checked;
                                           thirdStepEnabledCeckBox.Toggled += (s, e) => { thirdStep.Enabled = (bool)thirdStepEnabledCeckBox.Checked; };

                                           // Add 4th step
                                           var fourthStep = new WizardStep { Title = "Step Four" };
                                           wizard.AddStep (fourthStep);

                                           var someText = new TextView
                                           {
                                               Text =
                                                   "This step (Step Four) shows how to show/hide the Help pane. The step contains this TextView (but it's hard to tell it's a TextView because of Issue #1800).",
                                               X = 0,
                                               Y = 0,
                                               Width = Dim.Fill (),
                                               Height = Dim.Fill (1),
                                               WordWrap = true,
                                               AllowsTab = false,
                                               ColorScheme = Colors.ColorSchemes ["Base"]
                                           };
                                           var help = "This is helpful.";
                                           fourthStep.Add (someText);

                                           var hideHelpBtn = new Button
                                           {
                                               Text = "Press me to show/hide help", X = Pos.Center (), Y = Pos.AnchorEnd (1)
                                           };

                                           hideHelpBtn.Accept += (s, e) =>
                                                                 {
                                                                     if (fourthStep.HelpText.Length > 0)
                                                                     {
                                                                         fourthStep.HelpText = string.Empty;
                                                                     }
                                                                     else
                                                                     {
                                                                         fourthStep.HelpText = help;
                                                                     }
                                                                 };
                                           fourthStep.Add (hideHelpBtn);
                                           fourthStep.NextButtonText = "Go To Last Step";
                                           var scrollBar = new ScrollBarView (someText, true);

                                           scrollBar.ChangedPosition += (s, e) =>
                                                                        {
                                                                            someText.TopRow = scrollBar.Position;

                                                                            if (someText.TopRow != scrollBar.Position)
                                                                            {
                                                                                scrollBar.Position = someText.TopRow;
                                                                            }

                                                                            someText.SetNeedsDisplay ();
                                                                        };

                                           scrollBar.VisibleChanged += (s, e) =>
                                                                       {
                                                                           if (scrollBar.Visible && someText.RightOffset == 0)
                                                                           {
                                                                               someText.RightOffset = 1;
                                                                           }
                                                                           else if (!scrollBar.Visible && someText.RightOffset == 1)
                                                                           {
                                                                               someText.RightOffset = 0;
                                                                           }
                                                                       };

                                           someText.DrawContent += (s, e) =>
                                                                   {
                                                                       scrollBar.Size = someText.Lines;
                                                                       scrollBar.Position = someText.TopRow;

                                                                       if (scrollBar.OtherScrollBarView != null)
                                                                       {
                                                                           scrollBar.OtherScrollBarView.Size = someText.Maxlength;
                                                                           scrollBar.OtherScrollBarView.Position = someText.LeftColumn;
                                                                       }

                                                                       scrollBar.LayoutSubviews ();
                                                                       scrollBar.Refresh ();
                                                                   };
                                           fourthStep.Add (scrollBar);

                                           // Add last step
                                           var lastStep = new WizardStep { Title = "The last step" };
                                           wizard.AddStep (lastStep);

                                           lastStep.HelpText =
                                               "The wizard is complete!\n\nPress the Finish button to continue.\n\nPressing ESC will cancel the wizard.";

                                           var finalFinalStepEnabledCeckBox =
                                               new CheckBox { Text = "Enable _Final Final Step", Checked = false, X = 0, Y = 1 };
                                           lastStep.Add (finalFinalStepEnabledCeckBox);

                                           // Add an optional FINAL last step
                                           var finalFinalStep = new WizardStep { Title = "The VERY last step" };
                                           wizard.AddStep (finalFinalStep);

                                           finalFinalStep.HelpText =
                                               "This step only shows if it was enabled on the other last step.";
                                           finalFinalStep.Enabled = (bool)thirdStepEnabledCeckBox.Checked;

                                           finalFinalStepEnabledCeckBox.Toggled += (s, e) =>
                                                                                   {
                                                                                       finalFinalStep.Enabled = (bool)finalFinalStepEnabledCeckBox.Checked;
                                                                                   };

                                           Application.Run (wizard);
                                           wizard.Dispose ();
                                       }
                                       catch (FormatException)
                                       {
                                           actionLabel.Text = "Invalid Options";
                                       }
                                   };
        Win.Add (showWizardButton);
    }
}