PosAlignDemo.cs 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421
  1. namespace UICatalog.Scenarios;
  2. [ScenarioMetadata ("Pos.Align", "Demonstrates Pos.Align")]
  3. [ScenarioCategory ("Layout")]
  4. public sealed class PosAlignDemo : Scenario
  5. {
  6. private readonly Aligner _horizAligner = new () { AlignmentModes = AlignmentModes.StartToEnd | AlignmentModes.AddSpaceBetweenItems };
  7. private int _leftMargin;
  8. private readonly Aligner _vertAligner = new () { AlignmentModes = AlignmentModes.StartToEnd | AlignmentModes.AddSpaceBetweenItems };
  9. private int _topMargin;
  10. public override void Main ()
  11. {
  12. // Init
  13. Application.Init ();
  14. // Setup - Create a top-level application window and configure it.
  15. Window appWindow = new ()
  16. {
  17. Title = $"{Application.QuitKey} to Quit - Scenario: {GetName ()} - {GetDescription ()}"
  18. };
  19. SetupControls (appWindow, Dimension.Width, Schemes.Runnable);
  20. SetupControls (appWindow, Dimension.Height, Schemes.Error);
  21. Setup3By3Grid (appWindow);
  22. // Run - Start the application.
  23. Application.Run (appWindow);
  24. appWindow.Dispose ();
  25. // Shutdown - Calling Application.Shutdown is required.
  26. Application.Shutdown ();
  27. }
  28. private void SetupControls (Window appWindow, Dimension dimension, Schemes scheme)
  29. {
  30. OptionSelector<Alignment> alignOptionSelector = new ()
  31. {
  32. SchemeName = SchemeManager.SchemesToSchemeName (scheme)
  33. };
  34. if (dimension == Dimension.Width)
  35. {
  36. alignOptionSelector.X = Pos.Align (_horizAligner.Alignment);
  37. alignOptionSelector.Y = Pos.Center ();
  38. }
  39. else
  40. {
  41. alignOptionSelector.X = Pos.Center ();
  42. alignOptionSelector.Y = Pos.Align (_vertAligner.Alignment);
  43. }
  44. alignOptionSelector.ValueChanged += (s, e) =>
  45. {
  46. if (alignOptionSelector.Value is null)
  47. {
  48. return;
  49. }
  50. if (dimension == Dimension.Width)
  51. {
  52. _horizAligner.Alignment = alignOptionSelector.Value.Value;
  53. UpdatePosAlignObjects (appWindow, dimension, _horizAligner);
  54. }
  55. else
  56. {
  57. _vertAligner.Alignment = alignOptionSelector.Value.Value;
  58. UpdatePosAlignObjects (appWindow, dimension, _vertAligner);
  59. }
  60. };
  61. appWindow.Add (alignOptionSelector);
  62. CheckBox endToStartCheckBox = new ()
  63. {
  64. SchemeName = SchemeManager.SchemesToSchemeName (scheme),
  65. Text = "EndToStart"
  66. };
  67. if (dimension == Dimension.Width)
  68. {
  69. endToStartCheckBox.CheckedState = _horizAligner.AlignmentModes.HasFlag (AlignmentModes.EndToStart) ? CheckState.Checked : CheckState.UnChecked;
  70. endToStartCheckBox.X = Pos.Align (_horizAligner.Alignment);
  71. endToStartCheckBox.Y = Pos.Top (alignOptionSelector);
  72. }
  73. else
  74. {
  75. endToStartCheckBox.CheckedState = _vertAligner.AlignmentModes.HasFlag (AlignmentModes.EndToStart) ? CheckState.Checked : CheckState.UnChecked;
  76. endToStartCheckBox.X = Pos.Left (alignOptionSelector);
  77. endToStartCheckBox.Y = Pos.Align (_vertAligner.Alignment);
  78. }
  79. endToStartCheckBox.CheckedStateChanging += (s, e) =>
  80. {
  81. if (dimension == Dimension.Width)
  82. {
  83. _horizAligner.AlignmentModes = e.Result == CheckState.Checked
  84. ? _horizAligner.AlignmentModes | AlignmentModes.EndToStart
  85. : _horizAligner.AlignmentModes & ~AlignmentModes.EndToStart;
  86. UpdatePosAlignObjects (appWindow, dimension, _horizAligner);
  87. }
  88. else
  89. {
  90. _vertAligner.AlignmentModes = e.Result == CheckState.Checked
  91. ? _vertAligner.AlignmentModes | AlignmentModes.EndToStart
  92. : _vertAligner.AlignmentModes & ~AlignmentModes.EndToStart;
  93. UpdatePosAlignObjects (appWindow, dimension, _vertAligner);
  94. }
  95. };
  96. appWindow.Add (endToStartCheckBox);
  97. CheckBox ignoreFirstOrLast = new ()
  98. {
  99. SchemeName = SchemeManager.SchemesToSchemeName (scheme),
  100. Text = "IgnoreFirstOrLast"
  101. };
  102. if (dimension == Dimension.Width)
  103. {
  104. ignoreFirstOrLast.CheckedState =
  105. _horizAligner.AlignmentModes.HasFlag (AlignmentModes.IgnoreFirstOrLast) ? CheckState.Checked : CheckState.UnChecked;
  106. ignoreFirstOrLast.X = Pos.Align (_horizAligner.Alignment);
  107. ignoreFirstOrLast.Y = Pos.Top (alignOptionSelector);
  108. }
  109. else
  110. {
  111. ignoreFirstOrLast.CheckedState = _vertAligner.AlignmentModes.HasFlag (AlignmentModes.IgnoreFirstOrLast) ? CheckState.Checked : CheckState.UnChecked;
  112. ignoreFirstOrLast.X = Pos.Left (alignOptionSelector);
  113. ignoreFirstOrLast.Y = Pos.Align (_vertAligner.Alignment);
  114. }
  115. ignoreFirstOrLast.CheckedStateChanging += (s, e) =>
  116. {
  117. if (dimension == Dimension.Width)
  118. {
  119. _horizAligner.AlignmentModes = e.Result == CheckState.Checked
  120. ? _horizAligner.AlignmentModes | AlignmentModes.IgnoreFirstOrLast
  121. : _horizAligner.AlignmentModes & ~AlignmentModes.IgnoreFirstOrLast;
  122. UpdatePosAlignObjects (appWindow, dimension, _horizAligner);
  123. }
  124. else
  125. {
  126. _vertAligner.AlignmentModes = e.Result == CheckState.Checked
  127. ? _vertAligner.AlignmentModes | AlignmentModes.IgnoreFirstOrLast
  128. : _vertAligner.AlignmentModes & ~AlignmentModes.IgnoreFirstOrLast;
  129. UpdatePosAlignObjects (appWindow, dimension, _vertAligner);
  130. }
  131. };
  132. appWindow.Add (ignoreFirstOrLast);
  133. CheckBox addSpacesBetweenItems = new ()
  134. {
  135. SchemeName = SchemeManager.SchemesToSchemeName (scheme),
  136. Text = "AddSpaceBetweenItems"
  137. };
  138. if (dimension == Dimension.Width)
  139. {
  140. addSpacesBetweenItems.CheckedState =
  141. _horizAligner.AlignmentModes.HasFlag (AlignmentModes.AddSpaceBetweenItems) ? CheckState.Checked : CheckState.UnChecked;
  142. addSpacesBetweenItems.X = Pos.Align (_horizAligner.Alignment);
  143. addSpacesBetweenItems.Y = Pos.Top (alignOptionSelector);
  144. }
  145. else
  146. {
  147. addSpacesBetweenItems.CheckedState =
  148. _vertAligner.AlignmentModes.HasFlag (AlignmentModes.AddSpaceBetweenItems) ? CheckState.Checked : CheckState.UnChecked;
  149. addSpacesBetweenItems.X = Pos.Left (alignOptionSelector);
  150. addSpacesBetweenItems.Y = Pos.Align (_vertAligner.Alignment);
  151. }
  152. addSpacesBetweenItems.CheckedStateChanging += (s, e) =>
  153. {
  154. if (dimension == Dimension.Width)
  155. {
  156. _horizAligner.AlignmentModes = e.Result == CheckState.Checked
  157. ? _horizAligner.AlignmentModes
  158. | AlignmentModes.AddSpaceBetweenItems
  159. : _horizAligner.AlignmentModes
  160. & ~AlignmentModes.AddSpaceBetweenItems;
  161. UpdatePosAlignObjects (appWindow, dimension, _horizAligner);
  162. }
  163. else
  164. {
  165. _vertAligner.AlignmentModes = e.Result == CheckState.Checked
  166. ? _vertAligner.AlignmentModes
  167. | AlignmentModes.AddSpaceBetweenItems
  168. : _vertAligner.AlignmentModes
  169. & ~AlignmentModes.AddSpaceBetweenItems;
  170. UpdatePosAlignObjects (appWindow, dimension, _vertAligner);
  171. }
  172. };
  173. appWindow.Add (addSpacesBetweenItems);
  174. CheckBox margin = new ()
  175. {
  176. SchemeName = SchemeManager.SchemesToSchemeName (scheme),
  177. Text = "Margin"
  178. };
  179. if (dimension == Dimension.Width)
  180. {
  181. margin.X = Pos.Align (_horizAligner.Alignment);
  182. margin.Y = Pos.Top (alignOptionSelector);
  183. }
  184. else
  185. {
  186. margin.X = Pos.Left (addSpacesBetweenItems);
  187. margin.Y = Pos.Align (_vertAligner.Alignment);
  188. }
  189. margin.CheckedStateChanging += (s, e) =>
  190. {
  191. if (dimension == Dimension.Width)
  192. {
  193. _leftMargin = e.Result == CheckState.Checked ? 1 : 0;
  194. UpdatePosAlignObjects (appWindow, dimension, _horizAligner);
  195. }
  196. else
  197. {
  198. _topMargin = e.Result == CheckState.Checked ? 1 : 0;
  199. UpdatePosAlignObjects (appWindow, dimension, _vertAligner);
  200. }
  201. };
  202. appWindow.Add (margin);
  203. List<Button> addedViews =
  204. [
  205. new ()
  206. {
  207. X = dimension == Dimension.Width ? Pos.Align (_horizAligner.Alignment) : Pos.Left (alignOptionSelector),
  208. Y = dimension == Dimension.Width ? Pos.Top (alignOptionSelector) : Pos.Align (_vertAligner.Alignment),
  209. Text = NumberToWords.Convert (0)
  210. }
  211. ];
  212. NumericUpDown<int> addedViewsUpDown = new ()
  213. {
  214. Width = 9,
  215. Title = "Added",
  216. SchemeName = SchemeManager.SchemesToSchemeName (scheme),
  217. BorderStyle = LineStyle.None,
  218. Value = addedViews.Count
  219. };
  220. if (dimension == Dimension.Width)
  221. {
  222. addedViewsUpDown.X = Pos.Align (_horizAligner.Alignment);
  223. addedViewsUpDown.Y = Pos.Top (alignOptionSelector);
  224. addedViewsUpDown.Border!.Thickness = new (0, 1, 0, 0);
  225. }
  226. else
  227. {
  228. addedViewsUpDown.X = Pos.Left (alignOptionSelector);
  229. addedViewsUpDown.Y = Pos.Align (_vertAligner.Alignment);
  230. addedViewsUpDown.Border!.Thickness = new (1, 0, 0, 0);
  231. }
  232. addedViewsUpDown.ValueChanging += (s, e) =>
  233. {
  234. if (e.NewValue < 0)
  235. {
  236. e.Cancel = true;
  237. return;
  238. }
  239. // Add or remove buttons
  240. if (e.NewValue < e.CurrentValue)
  241. {
  242. // Remove buttons
  243. for (int i = e.CurrentValue - 1; i >= e.NewValue; i--)
  244. {
  245. Button button = addedViews [i];
  246. appWindow.Remove (button);
  247. addedViews.RemoveAt (i);
  248. button.Dispose ();
  249. }
  250. }
  251. if (e.NewValue > e.CurrentValue)
  252. {
  253. // Add buttons
  254. for (int i = e.CurrentValue; i < e.NewValue; i++)
  255. {
  256. var button = new Button
  257. {
  258. X = dimension == Dimension.Width
  259. ? Pos.Align (_horizAligner.Alignment)
  260. : Pos.Left (alignOptionSelector),
  261. Y = dimension == Dimension.Width ? Pos.Top (alignOptionSelector) : Pos.Align (_vertAligner.Alignment),
  262. Text = NumberToWords.Convert (i + 1)
  263. };
  264. appWindow.Add (button);
  265. addedViews.Add (button);
  266. }
  267. }
  268. };
  269. appWindow.Add (addedViewsUpDown);
  270. appWindow.Add (addedViews [0]);
  271. }
  272. private void UpdatePosAlignObjects (View superView, Dimension dimension, Aligner aligner)
  273. {
  274. foreach (View view in superView.SubViews.Where (v => dimension == Dimension.Width ? v.X is PosAlign : v.Y is PosAlign))
  275. {
  276. if (dimension == Dimension.Width ? view.X is PosAlign : view.Y is PosAlign)
  277. {
  278. //posAlign.Aligner.Alignment = _horizAligner.Alignment;
  279. //posAlign.Aligner.AlignmentMode = _horizAligner.AlignmentMode;
  280. // BUGBUG: Create and assign a new Pos object because we currently have no way for X to be notified
  281. // BUGBUG: of changes in the Pos object. See https://github.com/gui-cs/Terminal.Gui/issues/3485
  282. if (dimension == Dimension.Width)
  283. {
  284. var posAlign = view.X as PosAlign;
  285. view.X = Pos.Align (
  286. aligner.Alignment,
  287. aligner.AlignmentModes,
  288. posAlign!.GroupId);
  289. view.Margin!.Thickness = new (_leftMargin, view.Margin!.Thickness.Top, view.Margin!.Thickness.Right, view.Margin!.Thickness.Bottom);
  290. }
  291. else
  292. {
  293. var posAlign = view.Y as PosAlign;
  294. view.Y = Pos.Align (
  295. aligner.Alignment,
  296. aligner.AlignmentModes,
  297. posAlign!.GroupId);
  298. view.Margin!.Thickness = new (view.Margin!.Thickness.Left, _topMargin, view.Margin!.Thickness.Right, view.Margin!.Thickness.Bottom);
  299. }
  300. }
  301. }
  302. }
  303. /// <summary>
  304. /// Creates a 3x3 grid of views with two GroupIds: One for aligning X and one for aligning Y.
  305. /// Demonstrates using PosAlign to create a grid of views that flow.
  306. /// </summary>
  307. /// <param name="appWindow"></param>
  308. private void Setup3By3Grid (View appWindow)
  309. {
  310. var container = new FrameView
  311. {
  312. Title = "3 by 3",
  313. X = Pos.AnchorEnd (),
  314. Y = Pos.AnchorEnd (),
  315. Width = Dim.Percent (40),
  316. Height = Dim.Percent (40)
  317. };
  318. container.Padding!.Thickness = new (8, 1, 0, 0);
  319. container.Padding.SchemeName = "Error";
  320. Aligner widthAligner = new () { AlignmentModes = AlignmentModes.StartToEnd };
  321. OptionSelector widthAlignOptionSelector = new ()
  322. {
  323. Labels = Enum.GetNames<Alignment> (),
  324. Orientation = Orientation.Horizontal,
  325. X = Pos.Center ()
  326. };
  327. container.Padding.Add (widthAlignOptionSelector);
  328. widthAlignOptionSelector.ValueChanged += (_, _) =>
  329. {
  330. widthAligner.Alignment =
  331. (Alignment)Enum.Parse (
  332. typeof (Alignment),
  333. widthAlignOptionSelector.Labels [widthAlignOptionSelector
  334. .Value!.Value]);
  335. UpdatePosAlignObjects (container, Dimension.Width, widthAligner);
  336. };
  337. Aligner heightAligner = new () { AlignmentModes = AlignmentModes.StartToEnd };
  338. OptionSelector heightAlignOptionSelector = new ()
  339. {
  340. Labels = Enum.GetNames<Alignment> (),
  341. Orientation = Orientation.Vertical,
  342. Y = Pos.Center ()
  343. };
  344. container.Padding.Add (heightAlignOptionSelector);
  345. heightAlignOptionSelector.ValueChanged += (sender, e) =>
  346. {
  347. heightAligner.Alignment =
  348. (Alignment)Enum.Parse (
  349. typeof (Alignment),
  350. heightAlignOptionSelector.Labels [heightAlignOptionSelector
  351. .Value!.Value]);
  352. UpdatePosAlignObjects (container, Dimension.Height, heightAligner);
  353. };
  354. for (var i = 0; i < 9; i++)
  355. {
  356. var v = new View
  357. {
  358. Title = $"{i}",
  359. Text = $"{i}",
  360. BorderStyle = LineStyle.Dashed,
  361. Height = Dim.Auto (),
  362. Width = Dim.Auto () + 2
  363. };
  364. v.X = Pos.Align (widthAligner.Alignment, widthAligner.AlignmentModes, i / 3);
  365. v.Y = Pos.Align (heightAligner.Alignment, heightAligner.AlignmentModes, i % 3 + 10);
  366. container.Add (v);
  367. }
  368. appWindow.Add (container);
  369. }
  370. }