ViewTests.cs 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533
  1. using UnitTests;
  2. using Xunit.Abstractions;
  3. namespace Terminal.Gui.ViewTests;
  4. public class ViewTests
  5. {
  6. private readonly ITestOutputHelper _output;
  7. public ViewTests (ITestOutputHelper output)
  8. {
  9. _output = output;
  10. }
  11. // Generic lifetime (IDisposable) tests
  12. [Fact]
  13. [TestRespondersDisposed]
  14. public void Dispose_Works ()
  15. {
  16. var r = new View ();
  17. #if DEBUG_IDISPOSABLE
  18. Assert.Equal (4, View.Instances.Count);
  19. #endif
  20. r.Dispose ();
  21. #if DEBUG_IDISPOSABLE
  22. Assert.Empty (View.Instances);
  23. #endif
  24. }
  25. [Fact]
  26. public void Disposing_Event_Notify_All_Subscribers_On_The_First_Container ()
  27. {
  28. #if DEBUG_IDISPOSABLE
  29. // Only clear before because need to test after assert
  30. View.Instances.Clear ();
  31. #endif
  32. var container1 = new View { Id = "Container1" };
  33. var count = 0;
  34. var view = new View { Id = "View" };
  35. view.Disposing += ViewDisposing;
  36. container1.Add (view);
  37. Assert.Equal (container1, view.SuperView);
  38. Assert.Single (container1.SubViews);
  39. var container2 = new View { Id = "Container2" };
  40. // BUGBUG: It's not legit to add a View to two SuperViews
  41. container2.Add (view);
  42. Assert.Equal (container2, view.SuperView);
  43. Assert.Equal (container1.SubViews.Count, container2.SubViews.Count);
  44. container2.Dispose ();
  45. Assert.Empty (container1.SubViews);
  46. Assert.Empty (container2.SubViews);
  47. Assert.Equal (1, count);
  48. Assert.Null (view.SuperView);
  49. container1.Dispose ();
  50. #if DEBUG_IDISPOSABLE
  51. Assert.Empty (View.Instances);
  52. #endif
  53. return;
  54. void ViewDisposing (object sender, EventArgs e)
  55. {
  56. count++;
  57. Assert.Equal (view, sender);
  58. container1.Remove ((View)sender);
  59. }
  60. }
  61. [Fact]
  62. public void Disposing_Event_Notify_All_Subscribers_On_The_Second_Container ()
  63. {
  64. #if DEBUG_IDISPOSABLE
  65. // Only clear before because need to test after assert
  66. View.Instances.Clear ();
  67. #endif
  68. var container1 = new View { Id = "Container1" };
  69. var view = new View { Id = "View" };
  70. container1.Add (view);
  71. Assert.Equal (container1, view.SuperView);
  72. Assert.Single (container1.SubViews);
  73. var container2 = new View { Id = "Container2" };
  74. var count = 0;
  75. view.Disposing += View_Disposing;
  76. // BUGBUG: It's not legit to add a View to two SuperViews
  77. container2.Add (view);
  78. Assert.Equal (container2, view.SuperView);
  79. void View_Disposing (object sender, EventArgs e)
  80. {
  81. count++;
  82. Assert.Equal (view, sender);
  83. container2.Remove ((View)sender);
  84. }
  85. Assert.Equal (container1.SubViews.Count, container2.SubViews.Count);
  86. container1.Dispose ();
  87. Assert.Empty (container1.SubViews);
  88. Assert.Empty (container2.SubViews);
  89. Assert.Equal (1, count);
  90. Assert.Null (view.SuperView);
  91. container2.Dispose ();
  92. #if DEBUG_IDISPOSABLE
  93. Assert.Empty (View.Instances);
  94. #endif
  95. }
  96. [Fact]
  97. public void Not_Notifying_Dispose ()
  98. {
  99. // Only clear before because need to test after assert
  100. #if DEBUG_IDISPOSABLE
  101. View.Instances.Clear ();
  102. #endif
  103. var container1 = new View { Id = "Container1" };
  104. var view = new View { Id = "View" };
  105. container1.Add (view);
  106. Assert.Equal (container1, view.SuperView);
  107. Assert.Single (container1.SubViews);
  108. var container2 = new View { Id = "Container2" };
  109. // BUGBUG: It's not legit to add a View to two SuperViews
  110. container2.Add (view);
  111. Assert.Equal (container2, view.SuperView);
  112. Assert.Equal (container1.SubViews.Count, container2.SubViews.Count);
  113. container1.Dispose ();
  114. Assert.Empty (container1.SubViews);
  115. Assert.NotEmpty (container2.SubViews);
  116. Assert.Single (container2.SubViews);
  117. Assert.Null (view.SuperView);
  118. // Trying access disposed properties
  119. #if DEBUG_IDISPOSABLE
  120. Assert.True (container2.SubViews.ElementAt (0).WasDisposed);
  121. #endif
  122. Assert.False (container2.SubViews.ElementAt (0).CanFocus);
  123. Assert.Null (container2.SubViews.ElementAt (0).Margin);
  124. Assert.Null (container2.SubViews.ElementAt (0).Border);
  125. Assert.Null (container2.SubViews.ElementAt (0).Padding);
  126. Assert.Null (view.SuperView);
  127. container2.Dispose ();
  128. #if DEBUG_IDISPOSABLE
  129. Assert.Empty (View.Instances);
  130. #endif
  131. }
  132. [Fact]
  133. [TestRespondersDisposed]
  134. public void Dispose_View ()
  135. {
  136. var view = new View ();
  137. Assert.NotNull (view.Margin);
  138. Assert.NotNull (view.Border);
  139. Assert.NotNull (view.Padding);
  140. #if DEBUG_IDISPOSABLE
  141. Assert.Equal (4, View.Instances.Count);
  142. #endif
  143. view.Dispose ();
  144. Assert.Null (view.Margin);
  145. Assert.Null (view.Border);
  146. Assert.Null (view.Padding);
  147. }
  148. [Fact]
  149. public void Internal_Tests ()
  150. {
  151. var rect = new Rectangle (1, 1, 10, 1);
  152. var view = new View { Frame = rect };
  153. }
  154. [Fact]
  155. [TestRespondersDisposed]
  156. public void New_Initializes ()
  157. {
  158. // Parameterless
  159. var r = new View ();
  160. Assert.NotNull (r);
  161. Assert.True (r.Enabled);
  162. Assert.True (r.Visible);
  163. Assert.Equal ($"View(){r.Viewport}", r.ToString ());
  164. Assert.False (r.CanFocus);
  165. Assert.False (r.HasFocus);
  166. Assert.Equal (new (0, 0, 0, 0), r.Viewport);
  167. Assert.Equal (new (0, 0, 0, 0), r.Frame);
  168. Assert.Null (r.Focused);
  169. Assert.Null (r.ColorScheme);
  170. Assert.Equal (0, r.Width);
  171. Assert.Equal (0, r.Height);
  172. Assert.Equal (0, r.X);
  173. Assert.Equal (0, r.Y);
  174. Assert.False (r.IsCurrentTop);
  175. Assert.Empty (r.Id);
  176. Assert.Empty (r.SubViews);
  177. Assert.False (r.WantContinuousButtonPressed);
  178. Assert.False (r.WantMousePositionReports);
  179. Assert.Null (r.SuperView);
  180. Assert.Null (r.MostFocused);
  181. Assert.Equal (TextDirection.LeftRight_TopBottom, r.TextDirection);
  182. r.Dispose ();
  183. // Empty Rect
  184. r = new () { Frame = Rectangle.Empty };
  185. Assert.NotNull (r);
  186. Assert.Equal ($"View(){r.Viewport}", r.ToString ());
  187. Assert.False (r.CanFocus);
  188. Assert.False (r.HasFocus);
  189. Assert.Equal (new (0, 0, 0, 0), r.Viewport);
  190. Assert.Equal (new (0, 0, 0, 0), r.Frame);
  191. Assert.Null (r.Focused);
  192. Assert.Null (r.ColorScheme);
  193. Assert.Equal (0, r.Width);
  194. Assert.Equal (0, r.Height);
  195. Assert.Equal (0, r.X);
  196. Assert.Equal (0, r.Y);
  197. Assert.False (r.IsCurrentTop);
  198. Assert.Empty (r.Id);
  199. Assert.Empty (r.SubViews);
  200. Assert.False (r.WantContinuousButtonPressed);
  201. Assert.False (r.WantMousePositionReports);
  202. Assert.Null (r.SuperView);
  203. Assert.Null (r.MostFocused);
  204. Assert.Equal (TextDirection.LeftRight_TopBottom, r.TextDirection);
  205. r.Dispose ();
  206. // Rect with values
  207. r = new () { Frame = new (1, 2, 3, 4) };
  208. Assert.NotNull (r);
  209. Assert.Equal ($"View(){r.Frame}", r.ToString ());
  210. Assert.False (r.CanFocus);
  211. Assert.False (r.HasFocus);
  212. Assert.Equal (new (0, 0, 3, 4), r.Viewport);
  213. Assert.Equal (new (1, 2, 3, 4), r.Frame);
  214. Assert.Null (r.Focused);
  215. Assert.Null (r.ColorScheme);
  216. Assert.Equal (3, r.Width);
  217. Assert.Equal (4, r.Height);
  218. Assert.Equal (1, r.X);
  219. Assert.Equal (2, r.Y);
  220. Assert.False (r.IsCurrentTop);
  221. Assert.Empty (r.Id);
  222. Assert.Empty (r.SubViews);
  223. Assert.False (r.WantContinuousButtonPressed);
  224. Assert.False (r.WantMousePositionReports);
  225. Assert.Null (r.SuperView);
  226. Assert.Null (r.MostFocused);
  227. Assert.Equal (TextDirection.LeftRight_TopBottom, r.TextDirection);
  228. r.Dispose ();
  229. // Initializes a view with a vertical direction
  230. r = new ()
  231. {
  232. Text = "Vertical View",
  233. TextDirection = TextDirection.TopBottom_LeftRight,
  234. Width = Dim.Auto (),
  235. Height = Dim.Auto ()
  236. };
  237. r.TextFormatter.WordWrap = false;
  238. Assert.NotNull (r);
  239. r.BeginInit ();
  240. r.EndInit ();
  241. Assert.False (r.CanFocus);
  242. Assert.False (r.HasFocus);
  243. Assert.Equal (new (0, 0, 1, 13), r.Viewport);
  244. Assert.Equal (new (0, 0, 1, 13), r.Frame);
  245. Assert.Null (r.Focused);
  246. Assert.Null (r.ColorScheme);
  247. Assert.False (r.IsCurrentTop);
  248. Assert.Equal (string.Empty, r.Id);
  249. Assert.Empty (r.SubViews);
  250. Assert.False (r.WantContinuousButtonPressed);
  251. Assert.False (r.WantMousePositionReports);
  252. Assert.Null (r.SuperView);
  253. Assert.Null (r.MostFocused);
  254. Assert.Equal (TextDirection.TopBottom_LeftRight, r.TextDirection);
  255. r.Dispose ();
  256. }
  257. [Fact]
  258. [TestRespondersDisposed]
  259. public void New_Methods_Return_False ()
  260. {
  261. var r = new View ();
  262. Assert.False (r.NewKeyDownEvent (Key.Empty));
  263. //Assert.False (r.OnKeyDown (new KeyEventArgs () { Key = Key.Unknown }));
  264. Assert.False (r.NewKeyUpEvent (Key.Empty));
  265. Assert.False (r.NewMouseEvent (new () { Flags = MouseFlags.AllEvents }));
  266. r.Dispose ();
  267. // TODO: Add more
  268. }
  269. [Fact]
  270. [AutoInitShutdown]
  271. public void Test_Nested_Views_With_Height_Equal_To_One ()
  272. {
  273. var v = new View { Width = 11, Height = 3, ColorScheme = new () };
  274. var top = new View { Width = Dim.Fill (), Height = 1 };
  275. var bottom = new View { Width = Dim.Fill (), Height = 1, Y = 2 };
  276. top.Add (new Label { Text = "111" });
  277. v.Add (top);
  278. v.Add (new LineView (Orientation.Horizontal) { Y = 1 });
  279. bottom.Add (new Label { Text = "222" });
  280. v.Add (bottom);
  281. v.BeginInit ();
  282. v.EndInit ();
  283. v.LayoutSubViews ();
  284. v.Draw ();
  285. var looksLike =
  286. @"
  287. 111
  288. ───────────
  289. 222";
  290. DriverAssert.AssertDriverContentsAre (looksLike, _output);
  291. v.Dispose ();
  292. top.Dispose ();
  293. bottom.Dispose ();
  294. }
  295. [Fact]
  296. [TestRespondersDisposed]
  297. public void View_With_No_Difference_Between_An_Object_Initializer_Compute_And_A_Absolute ()
  298. {
  299. // Object Initializer Computed
  300. var view = new View { X = 1, Y = 2, Width = 3, Height = 4 };
  301. // Object Initializer Absolute
  302. var super = new View { Frame = new (0, 0, 10, 10) };
  303. super.Add (view);
  304. super.BeginInit ();
  305. super.EndInit ();
  306. super.LayoutSubViews ();
  307. Assert.Equal (1, view.X);
  308. Assert.Equal (2, view.Y);
  309. Assert.Equal (3, view.Width);
  310. Assert.Equal (4, view.Height);
  311. Assert.False (view.Frame.IsEmpty);
  312. Assert.Equal (new (1, 2, 3, 4), view.Frame);
  313. Assert.False (view.Viewport.IsEmpty);
  314. Assert.Equal (new (0, 0, 3, 4), view.Viewport);
  315. view.LayoutSubViews ();
  316. Assert.Equal (1, view.X);
  317. Assert.Equal (2, view.Y);
  318. Assert.Equal (3, view.Width);
  319. Assert.Equal (4, view.Height);
  320. Assert.False (view.Frame.IsEmpty);
  321. Assert.False (view.Viewport.IsEmpty);
  322. super.Dispose ();
  323. #if DEBUG_IDISPOSABLE
  324. Assert.Empty (View.Instances);
  325. #endif
  326. // Default Constructor
  327. view = new ();
  328. Assert.Equal (0, view.X);
  329. Assert.Equal (0, view.Y);
  330. Assert.Equal (0, view.Width);
  331. Assert.Equal (0, view.Height);
  332. Assert.True (view.Frame.IsEmpty);
  333. Assert.True (view.Viewport.IsEmpty);
  334. view.Dispose ();
  335. // Object Initializer
  336. view = new () { X = 1, Y = 2, Text = "" };
  337. Assert.Equal (1, view.X);
  338. Assert.Equal (2, view.Y);
  339. Assert.Equal (0, view.Width);
  340. Assert.Equal (0, view.Height);
  341. Assert.False (view.Frame.IsEmpty);
  342. Assert.True (view.Viewport.IsEmpty);
  343. view.Dispose ();
  344. // Default Constructor and post assignment equivalent to Object Initializer
  345. view = new ();
  346. view.X = 1;
  347. view.Y = 2;
  348. view.Width = 3;
  349. view.Height = 4;
  350. super = new () { Frame = new (0, 0, 10, 10) };
  351. super.Add (view);
  352. super.BeginInit ();
  353. super.EndInit ();
  354. super.LayoutSubViews ();
  355. Assert.Equal (1, view.X);
  356. Assert.Equal (2, view.Y);
  357. Assert.Equal (3, view.Width);
  358. Assert.Equal (4, view.Height);
  359. Assert.False (view.Frame.IsEmpty);
  360. Assert.Equal (new (1, 2, 3, 4), view.Frame);
  361. Assert.False (view.Viewport.IsEmpty);
  362. Assert.Equal (new (0, 0, 3, 4), view.Viewport);
  363. super.Dispose ();
  364. }
  365. [Fact]
  366. [AutoInitShutdown]
  367. public void Visible_Clear_The_View_Output ()
  368. {
  369. var view = new View { Text = "Testing visibility." }; // use View, not Label to avoid AutoSize == true
  370. Assert.Equal (0, view.Frame.Width);
  371. Assert.Equal (0, view.Height);
  372. var win = new Window ();
  373. win.Add (view);
  374. Toplevel top = new ();
  375. top.Add (win);
  376. RunState rs = Application.Begin (top);
  377. view.Width = Dim.Auto ();
  378. view.Height = Dim.Auto ();
  379. Application.RunIteration (ref rs);
  380. Assert.Equal ("Testing visibility.".Length, view.Frame.Width);
  381. Assert.True (view.Visible);
  382. ((FakeDriver)Application.Driver!).SetBufferSize (30, 5);
  383. DriverAssert.AssertDriverContentsWithFrameAre (
  384. @"
  385. ┌────────────────────────────┐
  386. │Testing visibility. │
  387. │ │
  388. │ │
  389. └────────────────────────────┘
  390. ",
  391. _output
  392. );
  393. view.Visible = false;
  394. var firstIteration = false;
  395. Application.RunIteration (ref rs, firstIteration);
  396. DriverAssert.AssertDriverContentsWithFrameAre (
  397. @"
  398. ┌────────────────────────────┐
  399. │ │
  400. │ │
  401. │ │
  402. └────────────────────────────┘
  403. ",
  404. _output
  405. );
  406. Application.End (rs);
  407. top.Dispose ();
  408. }
  409. [Fact]
  410. [AutoInitShutdown]
  411. public void Visible_Sets_Also_Sets_SubViews ()
  412. {
  413. var button = new Button { Text = "Click Me" };
  414. var win = new Window { Width = Dim.Fill (), Height = Dim.Fill () };
  415. win.Add (button);
  416. Toplevel top = new ();
  417. top.Add (win);
  418. var iterations = 0;
  419. Application.Iteration += (s, a) =>
  420. {
  421. iterations++;
  422. Assert.True (button.Visible);
  423. Assert.True (button.CanFocus);
  424. Assert.True (button.HasFocus);
  425. Assert.True (win.Visible);
  426. Assert.True (win.CanFocus);
  427. Assert.True (win.HasFocus);
  428. win.Visible = false;
  429. Assert.True (button.Visible);
  430. Assert.True (button.CanFocus);
  431. Assert.False (button.HasFocus);
  432. Assert.False (win.Visible);
  433. Assert.True (win.CanFocus);
  434. Assert.False (win.HasFocus);
  435. button.SetFocus ();
  436. Assert.False (button.HasFocus);
  437. Assert.False (win.HasFocus);
  438. win.SetFocus ();
  439. Assert.False (button.HasFocus);
  440. Assert.False (win.HasFocus);
  441. win.Visible = true;
  442. Assert.True (button.HasFocus);
  443. Assert.True (win.HasFocus);
  444. Application.RequestStop ();
  445. };
  446. Application.Run (top);
  447. top.Dispose ();
  448. Assert.Equal (1, iterations);
  449. }
  450. }