Files
Terminal.Gui/Examples/UICatalog/Scenarios/PosAlignDemo.cs
Tig 7422385457 Fixes #4057 - MASSIVE! Fully implements ColorScheme->Scheme + VisualRole + Colors.->SchemeManager. (#4062)
* touching publish.yml

* ColorScheme->Scheme

* ColorScheme->Scheme 2

* Prototype of GetAttributeForRole

* Badly broke CM

* Further Badly broke CM

* Refactored CM big-time. View still broken

* All unit test pass again. Tons added. CM is still WIP, but Schemes is not mostly refactored and working.

* Actually:
All unit test pass again.
Tons added.
CM is still WIP, but Schemes is not mostly refactored and working.

* Bug fixes.
DeepMemberWiseClone cleanup

* Further cleanup of Scope<T>, ConfigProperty, etc.

* Made ConfigManager thread safe.

* WIP: Broken

* WIP: new deep clone impl

* WIP: new deep clone impl is done. Now fixing CM

* WIP:
- config.md
- Working on AOT clean up
- Core CM is broken; but known.

* WIP

* Merged.
Removed CM from Application.Init

* WIP

* More WIP; Less broke

* All CM unit tests pass... Not sure if it actually works though

* All unit tests pass... Themes are broken though in UI Cat

* CM Ready for review?

* Fixed failures due to TextStyles PR

* Working on Scheme/Attribute

* Working on Scheme/Attribute 2

* Working on Scheme/Attribute 3

* Working on Scheme/Attribute 4

* Working on Scheme/Attribute 5

* Working on Scheme/Attribute 6

* Added test to show how awful memory usage is

* Improved schema. Updated config.json

* Nade Scope<T> concurrentdictionary and added test to prove

* Made Themes ConcrurrentDictionary. Added bunches of tests

* Code cleanup

* Code cleanup 2

* Code cleanup 3

* Tweaking Scheme

* ClearJsonErrors

* ClearJsonErrors2

* Updated Attribute API

* It all (mostly) works!

* Skip odd unit test

* Messed with Themes

* Theme tweaks

* Code reorg. New .md stuff

* Fixed Enabled. Added mock driver

* Fixed a bunch of View.Enabled related issues

* Scheme -> Get/SetScheme()

* Cleanup

* Cleanup2

* Broke something

* Fixed everything

* Made CM.Enable better

* Text Style Scenario

* Added comments

* Fixed UI Catalog Theme Changing

* Fixed more dynamic CM update stuff

* Warning cleanup

* New Default Theme

* fixed unit test

* Refactoring Scheme and Attribute to fix inheritance

* more unit tests

* ConfigProperty is not updating schemes correctly

* All unit tests pass.
Code cleanup

* All unit tests pass.
Code cleanup2

* Fixed unit tests

* Upgraded TextField and TextView

* Fixed TextView !Enabled bug

* More updates to TextView. More unit tests for SchemeManager

* Upgraded CharMap

* API docs

* Fixe HexView API

* upgrade HexView

* Fixed shortcut KeyView

* Fixed more bugs. Added new themes

* updated themes

* upgraded Border

* Fixed themes memory usage...mostly

* Fixed themes memory usage...mostly2

* Fixed themes memory usage...2

* Fixed themes memory usage...3

* Added new colors

* Fixed GetHardCodedConfig bug

* Added Themes Scenario - WIP

* Added Themes Scenario

* Tweaked Themes Scenario

* Code cleanup

* Fixed json schmea

* updated deepdives

* updated deepdives

* Tweaked Themes Scenario

* Made Schemes a concurrent dict

* Test cleanup

* Thread safe ConfigProperty tests

* trying to make things more thread safe

* more trying to make things more thread safe

* Fixing bugs in shadowview

* Fixing bugs in shadowview 2

* Refactored GetViewsUnderMouse to GetViewsUnderLocation etc...

* Fixed dupe unit tests?

* Added better description of layout and coordiantes to deep dive

* Added better description of layout and coordiantes to deep dive

* Modified tests that call v2.AddTimeout; they were returning true which means restart the timer!
This was causing mac/linux unit test failures.
I think

* Fixed auto scheme.
Broke TextView/TextField selection

* Realized Attribute.IsExplicitlySet is stupid; just use nullable

* Fixed Attribute. Simplified. MOre theme testing

* Updated themes again

* GetViewsUnderMouse to GetViewsUnderLocation broke TransparentMouse.

* Fixing mouseunder bugs

* rewriting...

* All working again.
Shadows are now slick as snot.
GetViewsUnderLocation is rewritten to actually work and be readable.
Tons more low-level unit tests.
Margin is now actually ViewportSettings.Transparent.

* Code cleanup

* Code cleanup

* Code cleanup of color apis

* Fixed Hover/Highlight

* Update Examples/UICatalog/Scenarios/AllViewsTester.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update Examples/UICatalog/Scenarios/CharacterMap/CharacterMap.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update Examples/UICatalog/Scenarios/Clipping.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Fixed race condition?

* reverted

* Simplified Attribute API by removing events from SetAttributeForRole

* Removed recursion from GetViewsAtLocation

* Removed unneeded code

* Code clean up.
Fixed Scheme bug.

* reverted temporary disable

* Adjusted scheme algo

* Upgraded TextValidateField

* Fixed TextValidate bugs

* Tweaks

* Frameview rounded border by default

* API doc cleanup

* Readme fix

* Addressed tznind feeback

* Fixed more unit test issues by protecting Application statics from being set if Application.Initialized is not true

* Fixed more unit test issues by protecting Application statics from being set if Application.Initialized is not true 2

* cleanup

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2025-05-29 13:55:54 -06:00

417 lines
20 KiB
C#

using System;
using System.Collections.Generic;
using System.Linq;
using Terminal.Gui;
namespace UICatalog.Scenarios;
[ScenarioMetadata ("Pos.Align", "Demonstrates Pos.Align")]
[ScenarioCategory ("Layout")]
public sealed class PosAlignDemo : Scenario
{
private readonly Aligner _horizAligner = new () { AlignmentModes = AlignmentModes.StartToEnd | AlignmentModes.AddSpaceBetweenItems};
private int _leftMargin;
private readonly Aligner _vertAligner = new () { AlignmentModes = AlignmentModes.StartToEnd | AlignmentModes.AddSpaceBetweenItems };
private int _topMargin;
public override void Main ()
{
// Init
Application.Init ();
// Setup - Create a top-level application window and configure it.
Window appWindow = new ()
{
Title = $"{Application.QuitKey} to Quit - Scenario: {GetName ()} - {GetDescription ()}"
};
SetupControls (appWindow, Dimension.Width, Schemes.Toplevel);
SetupControls (appWindow, Dimension.Height, Schemes.Error);
Setup3By3Grid (appWindow);
// Run - Start the application.
Application.Run (appWindow);
appWindow.Dispose ();
// Shutdown - Calling Application.Shutdown is required.
Application.Shutdown ();
}
private void SetupControls (Window appWindow, Dimension dimension, Schemes scheme)
{
RadioGroup alignRadioGroup = new ()
{
RadioLabels = Enum.GetNames<Alignment> (),
SchemeName = SchemeManager.SchemesToSchemeName (scheme),
};
if (dimension == Dimension.Width)
{
alignRadioGroup.X = Pos.Align (_horizAligner.Alignment);
alignRadioGroup.Y = Pos.Center ();
}
else
{
alignRadioGroup.X = Pos.Center ();
alignRadioGroup.Y = Pos.Align (_vertAligner.Alignment);
}
alignRadioGroup.SelectedItemChanged += (s, e) =>
{
if (dimension == Dimension.Width)
{
_horizAligner.Alignment =
(Alignment)Enum.Parse (
typeof (Alignment),
alignRadioGroup.RadioLabels [alignRadioGroup.SelectedItem]);
UpdatePosAlignObjects (appWindow, dimension, _horizAligner);
}
else
{
_vertAligner.Alignment =
(Alignment)Enum.Parse (
typeof (Alignment),
alignRadioGroup.RadioLabels [alignRadioGroup.SelectedItem]);
UpdatePosAlignObjects (appWindow, dimension, _vertAligner);
}
};
appWindow.Add (alignRadioGroup);
CheckBox endToStartCheckBox = new ()
{
SchemeName = SchemeManager.SchemesToSchemeName (scheme),
Text = "EndToStart"
};
if (dimension == Dimension.Width)
{
endToStartCheckBox.CheckedState = _horizAligner.AlignmentModes.HasFlag (AlignmentModes.EndToStart) ? CheckState.Checked : CheckState.UnChecked;
endToStartCheckBox.X = Pos.Align (_horizAligner.Alignment);
endToStartCheckBox.Y = Pos.Top (alignRadioGroup);
}
else
{
endToStartCheckBox.CheckedState = _vertAligner.AlignmentModes.HasFlag (AlignmentModes.EndToStart) ? CheckState.Checked : CheckState.UnChecked;
endToStartCheckBox.X = Pos.Left (alignRadioGroup);
endToStartCheckBox.Y = Pos.Align (_vertAligner.Alignment);
}
endToStartCheckBox.CheckedStateChanging += (s, e) =>
{
if (dimension == Dimension.Width)
{
_horizAligner.AlignmentModes = e.NewValue == CheckState.Checked
? _horizAligner.AlignmentModes | AlignmentModes.EndToStart
: _horizAligner.AlignmentModes & ~AlignmentModes.EndToStart;
UpdatePosAlignObjects (appWindow, dimension, _horizAligner);
}
else
{
_vertAligner.AlignmentModes = e.NewValue == CheckState.Checked
? _vertAligner.AlignmentModes | AlignmentModes.EndToStart
: _vertAligner.AlignmentModes & ~AlignmentModes.EndToStart;
UpdatePosAlignObjects (appWindow, dimension, _vertAligner);
}
};
appWindow.Add (endToStartCheckBox);
CheckBox ignoreFirstOrLast = new ()
{
SchemeName = SchemeManager.SchemesToSchemeName (scheme),
Text = "IgnoreFirstOrLast"
};
if (dimension == Dimension.Width)
{
ignoreFirstOrLast.CheckedState = _horizAligner.AlignmentModes.HasFlag (AlignmentModes.IgnoreFirstOrLast) ? CheckState.Checked : CheckState.UnChecked;
ignoreFirstOrLast.X = Pos.Align (_horizAligner.Alignment);
ignoreFirstOrLast.Y = Pos.Top (alignRadioGroup);
}
else
{
ignoreFirstOrLast.CheckedState = _vertAligner.AlignmentModes.HasFlag (AlignmentModes.IgnoreFirstOrLast) ? CheckState.Checked : CheckState.UnChecked;
ignoreFirstOrLast.X = Pos.Left (alignRadioGroup);
ignoreFirstOrLast.Y = Pos.Align (_vertAligner.Alignment);
}
ignoreFirstOrLast.CheckedStateChanging += (s, e) =>
{
if (dimension == Dimension.Width)
{
_horizAligner.AlignmentModes = e.NewValue == CheckState.Checked
? _horizAligner.AlignmentModes | AlignmentModes.IgnoreFirstOrLast
: _horizAligner.AlignmentModes & ~AlignmentModes.IgnoreFirstOrLast;
UpdatePosAlignObjects (appWindow, dimension, _horizAligner);
}
else
{
_vertAligner.AlignmentModes = e.NewValue == CheckState.Checked
? _vertAligner.AlignmentModes | AlignmentModes.IgnoreFirstOrLast
: _vertAligner.AlignmentModes & ~AlignmentModes.IgnoreFirstOrLast;
UpdatePosAlignObjects (appWindow, dimension, _vertAligner);
}
};
appWindow.Add (ignoreFirstOrLast);
CheckBox addSpacesBetweenItems = new ()
{
SchemeName = SchemeManager.SchemesToSchemeName (scheme),
Text = "AddSpaceBetweenItems"
};
if (dimension == Dimension.Width)
{
addSpacesBetweenItems.CheckedState = _horizAligner.AlignmentModes.HasFlag (AlignmentModes.AddSpaceBetweenItems) ? CheckState.Checked : CheckState.UnChecked;
addSpacesBetweenItems.X = Pos.Align (_horizAligner.Alignment);
addSpacesBetweenItems.Y = Pos.Top (alignRadioGroup);
}
else
{
addSpacesBetweenItems.CheckedState = _vertAligner.AlignmentModes.HasFlag (AlignmentModes.AddSpaceBetweenItems) ? CheckState.Checked : CheckState.UnChecked;
addSpacesBetweenItems.X = Pos.Left (alignRadioGroup);
addSpacesBetweenItems.Y = Pos.Align (_vertAligner.Alignment);
}
addSpacesBetweenItems.CheckedStateChanging += (s, e) =>
{
if (dimension == Dimension.Width)
{
_horizAligner.AlignmentModes = e.NewValue == CheckState.Checked
? _horizAligner.AlignmentModes | AlignmentModes.AddSpaceBetweenItems
: _horizAligner.AlignmentModes & ~AlignmentModes.AddSpaceBetweenItems;
UpdatePosAlignObjects (appWindow, dimension, _horizAligner);
}
else
{
_vertAligner.AlignmentModes = e.NewValue == CheckState.Checked
? _vertAligner.AlignmentModes | AlignmentModes.AddSpaceBetweenItems
: _vertAligner.AlignmentModes & ~AlignmentModes.AddSpaceBetweenItems;
UpdatePosAlignObjects (appWindow, dimension, _vertAligner);
}
};
appWindow.Add (addSpacesBetweenItems);
CheckBox margin = new ()
{
SchemeName = SchemeManager.SchemesToSchemeName (scheme),
Text = "Margin"
};
if (dimension == Dimension.Width)
{
margin.X = Pos.Align (_horizAligner.Alignment);
margin.Y = Pos.Top (alignRadioGroup);
}
else
{
margin.X = Pos.Left (addSpacesBetweenItems);
margin.Y = Pos.Align (_vertAligner.Alignment);
}
margin.CheckedStateChanging += (s, e) =>
{
if (dimension == Dimension.Width)
{
_leftMargin = e.NewValue == CheckState.Checked ? 1 : 0;
UpdatePosAlignObjects (appWindow, dimension, _horizAligner);
}
else
{
_topMargin = e.NewValue == CheckState.Checked ? 1 : 0;
UpdatePosAlignObjects (appWindow, dimension, _vertAligner);
}
};
appWindow.Add (margin);
List<Button> addedViews =
[
new ()
{
X = dimension == Dimension.Width ? Pos.Align (_horizAligner.Alignment) : Pos.Left (alignRadioGroup),
Y = dimension == Dimension.Width ? Pos.Top (alignRadioGroup) : Pos.Align (_vertAligner.Alignment),
Text = NumberToWords.Convert (0)
}
];
NumericUpDown<int> addedViewsUpDown = new()
{
Width = 9,
Title = "Added",
SchemeName = SchemeManager.SchemesToSchemeName (scheme),
BorderStyle = LineStyle.None,
Value = addedViews.Count
};
if (dimension == Dimension.Width)
{
addedViewsUpDown.X = Pos.Align (_horizAligner.Alignment);
addedViewsUpDown.Y = Pos.Top (alignRadioGroup);
addedViewsUpDown.Border.Thickness = new (0, 1, 0, 0);
}
else
{
addedViewsUpDown.X = Pos.Left (alignRadioGroup);
addedViewsUpDown.Y = Pos.Align (_vertAligner.Alignment);
addedViewsUpDown.Border.Thickness = new (1, 0, 0, 0);
}
addedViewsUpDown.ValueChanging += (s, e) =>
{
if (e.NewValue < 0)
{
e.Cancel = true;
return;
}
// Add or remove buttons
if (e.NewValue < e.CurrentValue)
{
// Remove buttons
for (int i = e.CurrentValue - 1; i >= e.NewValue; i--)
{
Button button = addedViews [i];
appWindow.Remove (button);
addedViews.RemoveAt (i);
button.Dispose ();
}
}
if (e.NewValue > e.CurrentValue)
{
// Add buttons
for (int i = e.CurrentValue; i < e.NewValue; i++)
{
var button = new Button
{
X = dimension == Dimension.Width ? Pos.Align (_horizAligner.Alignment) : Pos.Left (alignRadioGroup),
Y = dimension == Dimension.Width ? Pos.Top (alignRadioGroup) : Pos.Align (_vertAligner.Alignment),
Text = NumberToWords.Convert (i + 1)
};
appWindow.Add (button);
addedViews.Add (button);
}
}
};
appWindow.Add (addedViewsUpDown);
appWindow.Add (addedViews [0]);
}
private void UpdatePosAlignObjects (View superView, Dimension dimension, Aligner aligner)
{
foreach (View view in superView.SubViews.Where (v => dimension == Dimension.Width ? v.X is PosAlign : v.Y is PosAlign))
{
if (dimension == Dimension.Width ? view.X is PosAlign : view.Y is PosAlign)
{
//posAlign.Aligner.Alignment = _horizAligner.Alignment;
//posAlign.Aligner.AlignmentMode = _horizAligner.AlignmentMode;
// BUGBUG: Create and assign a new Pos object because we currently have no way for X to be notified
// BUGBUG: of changes in the Pos object. See https://github.com/gui-cs/Terminal.Gui/issues/3485
if (dimension == Dimension.Width)
{
var posAlign = view.X as PosAlign;
view.X = Pos.Align (
aligner.Alignment,
aligner.AlignmentModes,
posAlign!.GroupId);
view.Margin.Thickness = new (_leftMargin, view.Margin.Thickness.Top, view.Margin.Thickness.Right, view.Margin.Thickness.Bottom);
}
else
{
var posAlign = view.Y as PosAlign;
view.Y = Pos.Align (
aligner.Alignment,
aligner.AlignmentModes,
posAlign!.GroupId);
view.Margin.Thickness = new (view.Margin.Thickness.Left, _topMargin, view.Margin.Thickness.Right, view.Margin.Thickness.Bottom);
}
}
}
}
/// <summary>
/// Creates a 3x3 grid of views with two GroupIds: One for aligning X and one for aligning Y.
/// Demonstrates using PosAlign to create a grid of views that flow.
/// </summary>
/// <param name="appWindow"></param>
private void Setup3By3Grid (View appWindow)
{
var container = new FrameView
{
Title = "3 by 3",
X = Pos.AnchorEnd (),
Y = Pos.AnchorEnd (),
Width = Dim.Percent (40),
Height = Dim.Percent (40)
};
container.Padding.Thickness = new (8, 1, 0, 0);
container.Padding.SchemeName = "Error";
Aligner widthAligner = new () { AlignmentModes = AlignmentModes.StartToEnd };
RadioGroup widthAlignRadioGroup = new ()
{
RadioLabels = Enum.GetNames<Alignment> (),
Orientation = Orientation.Horizontal,
X = Pos.Center ()
};
container.Padding.Add (widthAlignRadioGroup);
widthAlignRadioGroup.SelectedItemChanged += (sender, e) =>
{
widthAligner.Alignment =
(Alignment)Enum.Parse (
typeof (Alignment),
widthAlignRadioGroup.RadioLabels [widthAlignRadioGroup.SelectedItem]);
UpdatePosAlignObjects (container, Dimension.Width, widthAligner);
};
Aligner heightAligner = new () { AlignmentModes = AlignmentModes.StartToEnd };
RadioGroup heightAlignRadioGroup = new ()
{
RadioLabels = Enum.GetNames<Alignment> (),
Orientation = Orientation.Vertical,
Y = Pos.Center ()
};
container.Padding.Add (heightAlignRadioGroup);
heightAlignRadioGroup.SelectedItemChanged += (sender, e) =>
{
heightAligner.Alignment =
(Alignment)Enum.Parse (
typeof (Alignment),
heightAlignRadioGroup.RadioLabels [heightAlignRadioGroup.SelectedItem]);
UpdatePosAlignObjects (container, Dimension.Height, heightAligner);
};
for (var i = 0; i < 9; i++)
{
var v = new View
{
Title = $"{i}",
Text = $"{i}",
BorderStyle = LineStyle.Dashed,
Height = Dim.Auto (),
Width = Dim.Auto() + 2
};
v.X = Pos.Align (widthAligner.Alignment, widthAligner.AlignmentModes, i / 3);
v.Y = Pos.Align (heightAligner.Alignment, heightAligner.AlignmentModes, i % 3 + 10);
container.Add (v);
}
appWindow.Add (container);
}
}