MouseTests.cs 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543
  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_Selecting (bool canFocus, bool setFocus, int expectedSelectingCount)
  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 selectingCount = 0;
  47. testView.Selecting += (sender, args) => selectingCount++;
  48. testView.NewMouseEvent (new () { Position = new (0, 0), Flags = MouseFlags.Button1Clicked });
  49. Assert.True (superView.HasFocus);
  50. Assert.Equal (expectedSelectingCount, selectingCount);
  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. var rs = Application.Begin (top);
  86. Assert.Equal (4, testView.Frame.X);
  87. Assert.Equal (new Point (4, 4), testView.Frame.Location);
  88. Application.RaiseMouseEvent (new () { ScreenPosition = new (xy, xy), Flags = MouseFlags.Button1Pressed });
  89. Application.RaiseMouseEvent (new () { ScreenPosition = new (xy + 1, xy + 1), Flags = MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition });
  90. Application.RunIteration(ref rs, false);
  91. Assert.Equal (expectedMoved, new Point (5, 5) == testView.Frame.Location);
  92. top.Dispose ();
  93. }
  94. [Theory]
  95. [InlineData (MouseFlags.WheeledUp | MouseFlags.ButtonCtrl, MouseFlags.WheeledLeft)]
  96. [InlineData (MouseFlags.WheeledDown | MouseFlags.ButtonCtrl, MouseFlags.WheeledRight)]
  97. public void WheeledLeft_WheeledRight (MouseFlags mouseFlags, MouseFlags expectedMouseFlagsFromEvent)
  98. {
  99. MouseFlags mouseFlagsFromEvent = MouseFlags.None;
  100. var view = new View ();
  101. view.MouseEvent += (s, e) => mouseFlagsFromEvent = e.Flags;
  102. view.NewMouseEvent (new MouseEventArgs () { Flags = mouseFlags });
  103. Assert.Equal (mouseFlagsFromEvent, expectedMouseFlagsFromEvent);
  104. }
  105. [Fact]
  106. public void NewMouseEvent_Invokes_MouseEvent_Properly ()
  107. {
  108. View view = new ()
  109. {
  110. Width = 1,
  111. Height = 1,
  112. };
  113. bool mouseEventInvoked = false;
  114. view.MouseEvent += (s, e) =>
  115. {
  116. mouseEventInvoked = true;
  117. e.Handled = true;
  118. };
  119. MouseEventArgs me = new ();
  120. view.NewMouseEvent (me);
  121. Assert.True (mouseEventInvoked);
  122. Assert.True (me.Handled);
  123. view.Dispose ();
  124. }
  125. [Theory]
  126. [SetupFakeDriver] // Required for spinner view that wants to register timeouts
  127. [MemberData (nameof (AllViewTypes))]
  128. public void AllViews_NewMouseEvent_Enabled_False_Does_Not_Set_Handled (Type viewType)
  129. {
  130. var view = CreateInstanceIfNotGeneric (viewType);
  131. if (view == null)
  132. {
  133. output.WriteLine ($"Ignoring {viewType} - It's a Generic");
  134. return;
  135. }
  136. view.Enabled = false;
  137. var me = new MouseEventArgs ();
  138. view.NewMouseEvent (me);
  139. Assert.False (me.Handled);
  140. view.Dispose ();
  141. }
  142. [Theory]
  143. [SetupFakeDriver] // Required for spinner view that wants to register timeouts
  144. [MemberData (nameof (AllViewTypes))]
  145. public void AllViews_NewMouseEvent_Clicked_Enabled_False_Does_Not_Set_Handled (Type viewType)
  146. {
  147. var view = CreateInstanceIfNotGeneric (viewType);
  148. if (view == null)
  149. {
  150. output.WriteLine ($"Ignoring {viewType} - It's a Generic");
  151. return;
  152. }
  153. view.Enabled = false;
  154. var me = new MouseEventArgs ()
  155. {
  156. Flags = MouseFlags.Button1Clicked
  157. };
  158. view.NewMouseEvent (me);
  159. Assert.False (me.Handled);
  160. view.Dispose ();
  161. }
  162. [Theory]
  163. [InlineData (MouseFlags.Button1Pressed, MouseFlags.Button1Released, MouseFlags.Button1Clicked)]
  164. [InlineData (MouseFlags.Button2Pressed, MouseFlags.Button2Released, MouseFlags.Button2Clicked)]
  165. [InlineData (MouseFlags.Button3Pressed, MouseFlags.Button3Released, MouseFlags.Button3Clicked)]
  166. [InlineData (MouseFlags.Button4Pressed, MouseFlags.Button4Released, MouseFlags.Button4Clicked)]
  167. public void WantContinuousButtonPressed_False_Button_Press_Release_DoesNotClick (MouseFlags pressed, MouseFlags released, MouseFlags clicked)
  168. {
  169. var me = new MouseEventArgs ();
  170. var view = new View ()
  171. {
  172. Width = 1,
  173. Height = 1,
  174. WantContinuousButtonPressed = false
  175. };
  176. var clickedCount = 0;
  177. view.MouseClick += (s, e) => clickedCount++;
  178. me.Flags = pressed;
  179. view.NewMouseEvent (me);
  180. Assert.Equal (0, clickedCount);
  181. me.Handled = false;
  182. me.Flags = pressed;
  183. view.NewMouseEvent (me);
  184. Assert.Equal (0, clickedCount);
  185. me.Handled = false;
  186. me.Flags = released;
  187. view.NewMouseEvent (me);
  188. Assert.Equal (0, clickedCount);
  189. me.Handled = false;
  190. me.Flags = clicked;
  191. view.NewMouseEvent (me);
  192. Assert.Equal (1, clickedCount);
  193. view.Dispose ();
  194. }
  195. [Theory]
  196. [InlineData (MouseFlags.Button1Clicked)]
  197. [InlineData (MouseFlags.Button2Clicked)]
  198. [InlineData (MouseFlags.Button3Clicked)]
  199. [InlineData (MouseFlags.Button4Clicked)]
  200. public void WantContinuousButtonPressed_True_Button_Clicked_Raises_MouseClick (MouseFlags clicked)
  201. {
  202. var me = new MouseEventArgs ();
  203. var view = new View ()
  204. {
  205. Width = 1,
  206. Height = 1,
  207. WantContinuousButtonPressed = true
  208. };
  209. var clickedCount = 0;
  210. view.MouseClick += (s, e) => clickedCount++;
  211. me.Flags = clicked;
  212. view.NewMouseEvent (me);
  213. Assert.Equal (1, clickedCount);
  214. view.Dispose ();
  215. }
  216. [Theory]
  217. [InlineData (MouseFlags.Button1Clicked)]
  218. [InlineData (MouseFlags.Button2Clicked)]
  219. [InlineData (MouseFlags.Button3Clicked)]
  220. [InlineData (MouseFlags.Button4Clicked)]
  221. public void WantContinuousButtonPressed_True_Button_Clicked_Raises_Selecting (MouseFlags clicked)
  222. {
  223. var me = new MouseEventArgs ();
  224. var view = new View ()
  225. {
  226. Width = 1,
  227. Height = 1,
  228. WantContinuousButtonPressed = true
  229. };
  230. var selectingCount = 0;
  231. view.Selecting += (s, e) => selectingCount++;
  232. me.Flags = clicked;
  233. view.NewMouseEvent (me);
  234. Assert.Equal (1, selectingCount);
  235. view.Dispose ();
  236. }
  237. [Theory]
  238. [InlineData (MouseFlags.Button1Pressed, MouseFlags.Button1Released)]
  239. [InlineData (MouseFlags.Button2Pressed, MouseFlags.Button2Released)]
  240. [InlineData (MouseFlags.Button3Pressed, MouseFlags.Button3Released)]
  241. [InlineData (MouseFlags.Button4Pressed, MouseFlags.Button4Released)]
  242. public void WantContinuousButtonPressed_True_And_WantMousePositionReports_True_Button_Press_Release_Clicks (MouseFlags pressed, MouseFlags released)
  243. {
  244. var me = new MouseEventArgs ();
  245. var view = new View ()
  246. {
  247. Width = 1,
  248. Height = 1,
  249. WantContinuousButtonPressed = true,
  250. WantMousePositionReports = true
  251. };
  252. var clickedCount = 0;
  253. view.MouseClick += (s, e) => clickedCount++;
  254. me.Flags = pressed;
  255. view.NewMouseEvent (me);
  256. Assert.Equal (0, clickedCount);
  257. me.Handled = false;
  258. me.Flags = pressed;
  259. view.NewMouseEvent (me);
  260. Assert.Equal (1, clickedCount);
  261. me.Handled = false;
  262. me.Flags = released;
  263. view.NewMouseEvent (me);
  264. Assert.Equal (1, clickedCount);
  265. view.Dispose ();
  266. }
  267. [Theory]
  268. [InlineData (MouseFlags.Button1Pressed, MouseFlags.Button1Released, MouseFlags.Button1Clicked)]
  269. [InlineData (MouseFlags.Button2Pressed, MouseFlags.Button2Released, MouseFlags.Button2Clicked)]
  270. [InlineData (MouseFlags.Button3Pressed, MouseFlags.Button3Released, MouseFlags.Button3Clicked)]
  271. [InlineData (MouseFlags.Button4Pressed, MouseFlags.Button4Released, MouseFlags.Button4Clicked)]
  272. public void WantContinuousButtonPressed_True_And_WantMousePositionReports_True_Button_Press_Release_Clicks_Repeatedly (MouseFlags pressed, MouseFlags released, MouseFlags clicked)
  273. {
  274. var me = new MouseEventArgs ();
  275. var view = new View ()
  276. {
  277. Width = 1,
  278. Height = 1,
  279. WantContinuousButtonPressed = true,
  280. WantMousePositionReports = true
  281. };
  282. var clickedCount = 0;
  283. view.MouseClick += (s, e) => clickedCount++;
  284. me.Flags = pressed;
  285. view.NewMouseEvent (me);
  286. Assert.Equal (0, clickedCount);
  287. me.Handled = false;
  288. me.Flags = pressed;
  289. view.NewMouseEvent (me);
  290. Assert.Equal (1, clickedCount);
  291. me.Handled = false;
  292. me.Flags = released;
  293. view.NewMouseEvent (me);
  294. Assert.Equal (1, clickedCount);
  295. me.Handled = false;
  296. me.Flags = clicked;
  297. view.NewMouseEvent (me);
  298. Assert.Equal (1, clickedCount);
  299. view.Dispose ();
  300. Application.ResetState (ignoreDisposed: true);
  301. }
  302. [Fact]
  303. public void WantContinuousButtonPressed_True_And_WantMousePositionReports_True_Move_InViewport_OutOfViewport_Keeps_Counting ()
  304. {
  305. var me = new MouseEventArgs ();
  306. var view = new View ()
  307. {
  308. Width = 1,
  309. Height = 1,
  310. WantContinuousButtonPressed = true,
  311. WantMousePositionReports = true
  312. };
  313. var clickedCount = 0;
  314. view.MouseClick += (s, e) => clickedCount++;
  315. // Start in Viewport
  316. me.Flags = MouseFlags.Button1Pressed;
  317. me.Position = me.Position with { X = 0 };
  318. view.NewMouseEvent (me);
  319. Assert.Equal (0, clickedCount);
  320. me.Handled = false;
  321. // Move out of Viewport
  322. me.Flags = MouseFlags.Button1Pressed;
  323. me.Position = me.Position with { X = 1 };
  324. view.NewMouseEvent (me);
  325. Assert.Equal (1, clickedCount);
  326. me.Handled = false;
  327. // Move into Viewport
  328. me.Flags = MouseFlags.Button1Pressed;
  329. me.Position = me.Position with { X = 0 };
  330. view.NewMouseEvent (me);
  331. Assert.Equal (2, clickedCount);
  332. me.Handled = false;
  333. view.Dispose ();
  334. Application.ResetState (ignoreDisposed: true);
  335. }
  336. [Theory]
  337. [InlineData (HighlightStyle.None, 0, 0)]
  338. [InlineData (HighlightStyle.Pressed | HighlightStyle.PressedOutside, 1, 1)]
  339. public void HighlightOnPress_Fires_Events_And_Highlights (HighlightStyle highlightOnPress, int expectedEnabling, int expectedDisabling)
  340. {
  341. var view = new View ()
  342. {
  343. CanFocus = true,
  344. HighlightStyle = highlightOnPress,
  345. Height = 1,
  346. Width = 1
  347. };
  348. int enablingHighlight = 0;
  349. int disablingHighlight = 0;
  350. view.Highlight += View_Highlight;
  351. view.ColorScheme = new ColorScheme (new Attribute (ColorName16.Red, ColorName16.Blue));
  352. ColorScheme originalColorScheme = view.ColorScheme;
  353. view.NewMouseEvent (new () { Flags = MouseFlags.Button1Pressed, });
  354. if (highlightOnPress != HighlightStyle.None)
  355. {
  356. Assert.NotEqual (originalColorScheme, view.ColorScheme);
  357. }
  358. else
  359. {
  360. Assert.Equal (originalColorScheme, view.ColorScheme);
  361. }
  362. view.NewMouseEvent (new () { Flags = MouseFlags.Button1Released, });
  363. Assert.Equal (originalColorScheme, view.ColorScheme);
  364. Assert.Equal (expectedEnabling, enablingHighlight);
  365. Assert.Equal (expectedDisabling, disablingHighlight);
  366. view.Dispose ();
  367. return;
  368. void View_Highlight (object sender, CancelEventArgs<HighlightStyle> e)
  369. {
  370. if (e.NewValue == HighlightStyle.None)
  371. {
  372. disablingHighlight++;
  373. }
  374. else
  375. {
  376. enablingHighlight++;
  377. }
  378. }
  379. }
  380. // TODO: Add tests for each combination of HighlightFlags
  381. [Theory]
  382. [InlineData (0)]
  383. [InlineData (1)]
  384. [InlineData (10)]
  385. public void HighlightOnPress_Move_Keeps_Highlight (int x)
  386. {
  387. var view = new View ()
  388. {
  389. CanFocus = true,
  390. HighlightStyle = HighlightStyle.Pressed | HighlightStyle.PressedOutside,
  391. Height = 1,
  392. Width = 1
  393. };
  394. int enablingHighlight = 0;
  395. int disablingHighlight = 0;
  396. view.Highlight += View_Highlight;
  397. bool inViewport = view.Viewport.Contains (x, 0);
  398. // Start at 0,0 ; in viewport
  399. view.NewMouseEvent (new () { Flags = MouseFlags.Button1Pressed });
  400. Assert.Equal (1, enablingHighlight);
  401. Assert.Equal (0, disablingHighlight);
  402. // Move to x,0
  403. view.NewMouseEvent (new () { Flags = MouseFlags.Button1Pressed });
  404. if (inViewport)
  405. {
  406. Assert.Equal (2, enablingHighlight);
  407. Assert.Equal (0, disablingHighlight);
  408. }
  409. else
  410. {
  411. Assert.Equal (2, enablingHighlight);
  412. Assert.Equal (0, disablingHighlight);
  413. }
  414. // Move backto 0,0 ; in viewport
  415. view.NewMouseEvent (new () { Flags = MouseFlags.Button1Pressed });
  416. if (inViewport)
  417. {
  418. Assert.Equal (3, enablingHighlight);
  419. Assert.Equal (0, disablingHighlight);
  420. }
  421. else
  422. {
  423. Assert.Equal (3, enablingHighlight);
  424. Assert.Equal (0, disablingHighlight);
  425. }
  426. view.Dispose ();
  427. return;
  428. void View_Highlight (object sender, CancelEventArgs<HighlightStyle> e)
  429. {
  430. if (e.NewValue == HighlightStyle.None)
  431. {
  432. disablingHighlight++;
  433. }
  434. else
  435. {
  436. enablingHighlight++;
  437. }
  438. }
  439. }
  440. }