MouseTests.cs 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531
  1. using Xunit.Abstractions;
  2. namespace Terminal.Gui.ViewMouseTests;
  3. [Trait ("Category", "Input")]
  4. public class MouseTests (ITestOutputHelper output) : TestsAllViews
  5. {
  6. [Theory]
  7. [InlineData (false, false, false)]
  8. [InlineData (true, false, true)]
  9. [InlineData (true, true, true)]
  10. public void MouseClick_SetsFocus_If_CanFocus (bool canFocus, bool setFocus, bool expectedHasFocus)
  11. {
  12. var superView = new View { CanFocus = true, Height = 1, Width = 15 };
  13. var focusedView = new View { CanFocus = true, Width = 1, Height = 1 };
  14. var testView = new View { CanFocus = canFocus, X = 4, Width = 4, Height = 1 };
  15. superView.Add (focusedView, testView);
  16. focusedView.SetFocus ();
  17. Assert.True (superView.HasFocus);
  18. Assert.True (focusedView.HasFocus);
  19. Assert.False (testView.HasFocus);
  20. if (setFocus)
  21. {
  22. testView.SetFocus ();
  23. }
  24. testView.NewMouseEvent (new () { Position = new (0, 0), Flags = MouseFlags.Button1Clicked });
  25. Assert.True (superView.HasFocus);
  26. Assert.Equal (expectedHasFocus, testView.HasFocus);
  27. }
  28. [Theory]
  29. [InlineData (false, false, 1)]
  30. [InlineData (true, false, 1)]
  31. [InlineData (true, true, 1)]
  32. public void MouseClick_Raises_Selected (bool canFocus, bool setFocus, int expectedSelectedCount)
  33. {
  34. var superView = new View { CanFocus = true, Height = 1, Width = 15 };
  35. var focusedView = new View { CanFocus = true, Width = 1, Height = 1 };
  36. var testView = new View { CanFocus = canFocus, X = 4, Width = 4, Height = 1 };
  37. superView.Add (focusedView, testView);
  38. focusedView.SetFocus ();
  39. Assert.True (superView.HasFocus);
  40. Assert.True (focusedView.HasFocus);
  41. Assert.False (testView.HasFocus);
  42. if (setFocus)
  43. {
  44. testView.SetFocus ();
  45. }
  46. int selectedCount = 0;
  47. testView.Selected += (sender, args) => selectedCount++;
  48. testView.NewMouseEvent (new () { Position = new (0, 0), Flags = MouseFlags.Button1Clicked });
  49. Assert.True (superView.HasFocus);
  50. Assert.Equal (expectedSelectedCount, selectedCount);
  51. }
  52. // TODO: Add more tests that ensure the above test works with positive adornments
  53. // Test drag to move
  54. [Theory]
  55. [InlineData (0, 0, 0, 0, false)]
  56. [InlineData (0, 0, 0, 4, false)]
  57. [InlineData (1, 0, 0, 4, false)]
  58. [InlineData (0, 1, 0, 4, true)]
  59. [InlineData (0, 0, 1, 4, false)]
  60. [InlineData (1, 1, 0, 3, false)]
  61. [InlineData (1, 1, 0, 4, false)]
  62. [InlineData (1, 1, 0, 5, true)]
  63. [InlineData (1, 1, 0, 6, false)]
  64. [InlineData (1, 1, 0, 11, false)]
  65. [InlineData (1, 1, 0, 12, true)]
  66. [InlineData (1, 1, 0, 13, false)]
  67. [InlineData (1, 1, 0, 14, false)]
  68. [AutoInitShutdown]
  69. public void ButtonPressed_In_Border_Starts_Drag (int marginThickness, int borderThickness, int paddingThickness, int xy, bool expectedMoved)
  70. {
  71. var testView = new View
  72. {
  73. CanFocus = true,
  74. X = 4,
  75. Y = 4,
  76. Width = 10,
  77. Height = 10,
  78. Arrangement = ViewArrangement.Movable
  79. };
  80. testView.Margin.Thickness = new (marginThickness);
  81. testView.Border.Thickness = new (borderThickness);
  82. testView.Padding.Thickness = new (paddingThickness);
  83. var top = new Toplevel ();
  84. top.Add (testView);
  85. Application.Begin (top);
  86. Assert.Equal (new Point (4, 4), testView.Frame.Location);
  87. Application.OnMouseEvent (new () { ScreenPosition = new (xy, xy), Flags = MouseFlags.Button1Pressed });
  88. Application.OnMouseEvent (new () { ScreenPosition = new (xy + 1, xy + 1), Flags = MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition });
  89. Assert.Equal (expectedMoved, new Point (5, 5) == testView.Frame.Location);
  90. top.Dispose ();
  91. }
  92. [Theory]
  93. [InlineData (MouseFlags.WheeledUp | MouseFlags.ButtonCtrl, MouseFlags.WheeledLeft)]
  94. [InlineData (MouseFlags.WheeledDown | MouseFlags.ButtonCtrl, MouseFlags.WheeledRight)]
  95. public void WheeledLeft_WheeledRight (MouseFlags mouseFlags, MouseFlags expectedMouseFlagsFromEvent)
  96. {
  97. MouseFlags mouseFlagsFromEvent = MouseFlags.None;
  98. var view = new View ();
  99. view.MouseEvent += (s, e) => mouseFlagsFromEvent = e.MouseEvent.Flags;
  100. view.NewMouseEvent (new MouseEvent () { Flags = mouseFlags });
  101. Assert.Equal (mouseFlagsFromEvent, expectedMouseFlagsFromEvent);
  102. }
  103. [Fact]
  104. public void NewMouseEvent_Invokes_MouseEvent_Properly ()
  105. {
  106. View view = new ()
  107. {
  108. Width = 1,
  109. Height = 1,
  110. };
  111. bool mouseEventInvoked = false;
  112. view.MouseEvent += (s, e) =>
  113. {
  114. mouseEventInvoked = true;
  115. e.Handled = true;
  116. };
  117. MouseEvent me = new ();
  118. view.NewMouseEvent (me);
  119. Assert.True (mouseEventInvoked);
  120. Assert.True (me.Handled);
  121. view.Dispose ();
  122. }
  123. [Theory]
  124. [MemberData (nameof (AllViewTypes))]
  125. public void AllViews_NewMouseEvent_Enabled_False_Does_Not_Set_Handled (Type viewType)
  126. {
  127. var view = CreateInstanceIfNotGeneric (viewType);
  128. if (view == null)
  129. {
  130. output.WriteLine ($"Ignoring {viewType} - It's a Generic");
  131. return;
  132. }
  133. view.Enabled = false;
  134. var me = new MouseEvent ();
  135. view.NewMouseEvent (me);
  136. Assert.False (me.Handled);
  137. view.Dispose ();
  138. }
  139. [Theory]
  140. [MemberData (nameof (AllViewTypes))]
  141. public void AllViews_NewMouseEvent_Clicked_Enabled_False_Does_Not_Set_Handled (Type viewType)
  142. {
  143. var view = CreateInstanceIfNotGeneric (viewType);
  144. if (view == null)
  145. {
  146. output.WriteLine ($"Ignoring {viewType} - It's a Generic");
  147. return;
  148. }
  149. view.Enabled = false;
  150. var me = new MouseEvent ()
  151. {
  152. Flags = MouseFlags.Button1Clicked
  153. };
  154. view.NewMouseEvent (me);
  155. Assert.False (me.Handled);
  156. view.Dispose ();
  157. }
  158. [Theory]
  159. [InlineData (MouseFlags.Button1Pressed, MouseFlags.Button1Released, MouseFlags.Button1Clicked)]
  160. [InlineData (MouseFlags.Button2Pressed, MouseFlags.Button2Released, MouseFlags.Button2Clicked)]
  161. [InlineData (MouseFlags.Button3Pressed, MouseFlags.Button3Released, MouseFlags.Button3Clicked)]
  162. [InlineData (MouseFlags.Button4Pressed, MouseFlags.Button4Released, MouseFlags.Button4Clicked)]
  163. public void WantContinuousButtonPressed_False_Button_Press_Release_DoesNotClick (MouseFlags pressed, MouseFlags released, MouseFlags clicked)
  164. {
  165. var me = new MouseEvent ();
  166. var view = new View ()
  167. {
  168. Width = 1,
  169. Height = 1,
  170. WantContinuousButtonPressed = false
  171. };
  172. var clickedCount = 0;
  173. view.MouseClick += (s, e) => clickedCount++;
  174. me.Flags = pressed;
  175. view.NewMouseEvent (me);
  176. Assert.Equal (0, clickedCount);
  177. me.Handled = false;
  178. me.Flags = pressed;
  179. view.NewMouseEvent (me);
  180. Assert.Equal (0, clickedCount);
  181. me.Handled = false;
  182. me.Flags = released;
  183. view.NewMouseEvent (me);
  184. Assert.Equal (0, clickedCount);
  185. me.Handled = false;
  186. me.Flags = clicked;
  187. view.NewMouseEvent (me);
  188. Assert.Equal (1, clickedCount);
  189. view.Dispose ();
  190. }
  191. [Theory]
  192. [InlineData (MouseFlags.Button1Clicked)]
  193. [InlineData (MouseFlags.Button2Clicked)]
  194. [InlineData (MouseFlags.Button3Clicked)]
  195. [InlineData (MouseFlags.Button4Clicked)]
  196. public void WantContinuousButtonPressed_True_Button_Clicked_Raises_MouseClick (MouseFlags clicked)
  197. {
  198. var me = new MouseEvent ();
  199. var view = new View ()
  200. {
  201. Width = 1,
  202. Height = 1,
  203. WantContinuousButtonPressed = true
  204. };
  205. var clickedCount = 0;
  206. view.MouseClick += (s, e) => clickedCount++;
  207. me.Flags = clicked;
  208. view.NewMouseEvent (me);
  209. Assert.Equal (1, clickedCount);
  210. view.Dispose ();
  211. }
  212. [Theory]
  213. [InlineData (MouseFlags.Button1Clicked)]
  214. [InlineData (MouseFlags.Button2Clicked)]
  215. [InlineData (MouseFlags.Button3Clicked)]
  216. [InlineData (MouseFlags.Button4Clicked)]
  217. public void WantContinuousButtonPressed_True_Button_Clicked_Raises_Selected (MouseFlags clicked)
  218. {
  219. var me = new MouseEvent ();
  220. var view = new View ()
  221. {
  222. Width = 1,
  223. Height = 1,
  224. WantContinuousButtonPressed = true
  225. };
  226. var selectedCount = 0;
  227. view.Selected += (s, e) => selectedCount++;
  228. me.Flags = clicked;
  229. view.NewMouseEvent (me);
  230. Assert.Equal (1, selectedCount);
  231. view.Dispose ();
  232. }
  233. [Theory]
  234. [InlineData (MouseFlags.Button1Pressed, MouseFlags.Button1Released)]
  235. [InlineData (MouseFlags.Button2Pressed, MouseFlags.Button2Released)]
  236. [InlineData (MouseFlags.Button3Pressed, MouseFlags.Button3Released)]
  237. [InlineData (MouseFlags.Button4Pressed, MouseFlags.Button4Released)]
  238. public void WantContinuousButtonPressed_True_And_WantMousePositionReports_True_Button_Press_Release_Clicks (MouseFlags pressed, MouseFlags released)
  239. {
  240. var me = new MouseEvent ();
  241. var view = new View ()
  242. {
  243. Width = 1,
  244. Height = 1,
  245. WantContinuousButtonPressed = true,
  246. WantMousePositionReports = true
  247. };
  248. var clickedCount = 0;
  249. view.MouseClick += (s, e) => clickedCount++;
  250. me.Flags = pressed;
  251. view.NewMouseEvent (me);
  252. Assert.Equal (1, clickedCount);
  253. me.Flags = released;
  254. view.NewMouseEvent (me);
  255. Assert.Equal (1, clickedCount);
  256. view.Dispose ();
  257. }
  258. [Theory]
  259. [InlineData (MouseFlags.Button1Pressed, MouseFlags.Button1Released, MouseFlags.Button1Clicked)]
  260. [InlineData (MouseFlags.Button2Pressed, MouseFlags.Button2Released, MouseFlags.Button2Clicked)]
  261. [InlineData (MouseFlags.Button3Pressed, MouseFlags.Button3Released, MouseFlags.Button3Clicked)]
  262. [InlineData (MouseFlags.Button4Pressed, MouseFlags.Button4Released, MouseFlags.Button4Clicked)]
  263. public void WantContinuousButtonPressed_True_And_WantMousePositionReports_True_Button_Press_Release_Clicks_Repeatedly (MouseFlags pressed, MouseFlags released, MouseFlags clicked)
  264. {
  265. var me = new MouseEvent ();
  266. var view = new View ()
  267. {
  268. Width = 1,
  269. Height = 1,
  270. WantContinuousButtonPressed = true,
  271. WantMousePositionReports = true
  272. };
  273. var clickedCount = 0;
  274. view.MouseClick += (s, e) => clickedCount++;
  275. me.Flags = pressed;
  276. view.NewMouseEvent (me);
  277. Assert.Equal (1, clickedCount);
  278. me.Handled = false;
  279. me.Flags = pressed;
  280. view.NewMouseEvent (me);
  281. Assert.Equal (2, clickedCount);
  282. me.Handled = false;
  283. me.Flags = released;
  284. view.NewMouseEvent (me);
  285. Assert.Equal (2, clickedCount);
  286. me.Handled = false;
  287. me.Flags = clicked;
  288. view.NewMouseEvent (me);
  289. Assert.Equal (2, clickedCount);
  290. view.Dispose ();
  291. Application.ResetState (ignoreDisposed: true);
  292. }
  293. [Fact]
  294. public void WantContinuousButtonPressed_True_And_WantMousePositionReports_True_Move_InViewport_OutOfViewport_Keeps_Counting ()
  295. {
  296. var me = new MouseEvent ();
  297. var view = new View ()
  298. {
  299. Width = 1,
  300. Height = 1,
  301. WantContinuousButtonPressed = true,
  302. WantMousePositionReports = true
  303. };
  304. var clickedCount = 0;
  305. view.MouseClick += (s, e) => clickedCount++;
  306. // Start in Viewport
  307. me.Flags = MouseFlags.Button1Pressed;
  308. me.Position = me.Position with { X = 0 };
  309. view.NewMouseEvent (me);
  310. Assert.Equal (1, clickedCount);
  311. me.Handled = false;
  312. // Move out of Viewport
  313. me.Flags = MouseFlags.Button1Pressed;
  314. me.Position = me.Position with { X = 1 };
  315. view.NewMouseEvent (me);
  316. Assert.Equal (2, clickedCount);
  317. me.Handled = false;
  318. // Move into Viewport
  319. me.Flags = MouseFlags.Button1Pressed;
  320. me.Position = me.Position with { X = 0 };
  321. view.NewMouseEvent (me);
  322. Assert.Equal (3, clickedCount);
  323. me.Handled = false;
  324. view.Dispose ();
  325. }
  326. [Theory]
  327. [InlineData (HighlightStyle.None, 0, 0)]
  328. [InlineData (HighlightStyle.Pressed | HighlightStyle.PressedOutside, 1, 1)]
  329. public void HighlightOnPress_Fires_Events_And_Highlights (HighlightStyle highlightOnPress, int expectedEnabling, int expectedDisabling)
  330. {
  331. var view = new View ()
  332. {
  333. CanFocus = true,
  334. HighlightStyle = highlightOnPress,
  335. Height = 1,
  336. Width = 1
  337. };
  338. int enablingHighlight = 0;
  339. int disablingHighlight = 0;
  340. view.Highlight += View_Highlight;
  341. view.ColorScheme = new ColorScheme (new Attribute (ColorName16.Red, ColorName16.Blue));
  342. ColorScheme originalColorScheme = view.ColorScheme;
  343. view.NewMouseEvent (new () { Flags = MouseFlags.Button1Pressed, });
  344. if (highlightOnPress != HighlightStyle.None)
  345. {
  346. Assert.NotEqual (originalColorScheme, view.ColorScheme);
  347. }
  348. else
  349. {
  350. Assert.Equal (originalColorScheme, view.ColorScheme);
  351. }
  352. view.NewMouseEvent (new () { Flags = MouseFlags.Button1Released, });
  353. Assert.Equal (originalColorScheme, view.ColorScheme);
  354. Assert.Equal (expectedEnabling, enablingHighlight);
  355. Assert.Equal (expectedDisabling, disablingHighlight);
  356. view.Dispose ();
  357. return;
  358. void View_Highlight (object sender, CancelEventArgs<HighlightStyle> e)
  359. {
  360. if (e.NewValue == HighlightStyle.None)
  361. {
  362. disablingHighlight++;
  363. }
  364. else
  365. {
  366. enablingHighlight++;
  367. }
  368. }
  369. }
  370. // TODO: Add tests for each combination of HighlightFlags
  371. [Theory]
  372. [InlineData (0)]
  373. [InlineData (1)]
  374. [InlineData (10)]
  375. public void HighlightOnPress_Move_Keeps_Highlight (int x)
  376. {
  377. var view = new View ()
  378. {
  379. CanFocus = true,
  380. HighlightStyle = HighlightStyle.Pressed | HighlightStyle.PressedOutside,
  381. Height = 1,
  382. Width = 1
  383. };
  384. int enablingHighlight = 0;
  385. int disablingHighlight = 0;
  386. view.Highlight += View_Highlight;
  387. bool inViewport = view.Viewport.Contains (x, 0);
  388. // Start at 0,0 ; in viewport
  389. view.NewMouseEvent (new () { Flags = MouseFlags.Button1Pressed });
  390. Assert.Equal (1, enablingHighlight);
  391. Assert.Equal (0, disablingHighlight);
  392. // Move to x,0
  393. view.NewMouseEvent (new () { Flags = MouseFlags.Button1Pressed });
  394. if (inViewport)
  395. {
  396. Assert.Equal (2, enablingHighlight);
  397. Assert.Equal (0, disablingHighlight);
  398. }
  399. else
  400. {
  401. Assert.Equal (2, enablingHighlight);
  402. Assert.Equal (0, disablingHighlight);
  403. }
  404. // Move backto 0,0 ; in viewport
  405. view.NewMouseEvent (new () { Flags = MouseFlags.Button1Pressed });
  406. if (inViewport)
  407. {
  408. Assert.Equal (3, enablingHighlight);
  409. Assert.Equal (0, disablingHighlight);
  410. }
  411. else
  412. {
  413. Assert.Equal (3, enablingHighlight);
  414. Assert.Equal (0, disablingHighlight);
  415. }
  416. view.Dispose ();
  417. return;
  418. void View_Highlight (object sender, CancelEventArgs<HighlightStyle> e)
  419. {
  420. if (e.NewValue == HighlightStyle.None)
  421. {
  422. disablingHighlight++;
  423. }
  424. else
  425. {
  426. enablingHighlight++;
  427. }
  428. }
  429. }
  430. }