MouseTests.cs 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532
  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. Application.Begin (top);
  86. Assert.Equal (new Point (4, 4), testView.Frame.Location);
  87. Application.RaiseMouseEvent (new () { ScreenPosition = new (xy, xy), Flags = MouseFlags.Button1Pressed });
  88. Application.RaiseMouseEvent (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_Selecting (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 selectingCount = 0;
  227. view.Selecting += (s, e) => selectingCount++;
  228. me.Flags = clicked;
  229. view.NewMouseEvent (me);
  230. Assert.Equal (1, selectingCount);
  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. Application.ResetState (ignoreDisposed: true);
  326. }
  327. [Theory]
  328. [InlineData (HighlightStyle.None, 0, 0)]
  329. [InlineData (HighlightStyle.Pressed | HighlightStyle.PressedOutside, 1, 1)]
  330. public void HighlightOnPress_Fires_Events_And_Highlights (HighlightStyle highlightOnPress, int expectedEnabling, int expectedDisabling)
  331. {
  332. var view = new View ()
  333. {
  334. CanFocus = true,
  335. HighlightStyle = highlightOnPress,
  336. Height = 1,
  337. Width = 1
  338. };
  339. int enablingHighlight = 0;
  340. int disablingHighlight = 0;
  341. view.Highlight += View_Highlight;
  342. view.ColorScheme = new ColorScheme (new Attribute (ColorName16.Red, ColorName16.Blue));
  343. ColorScheme originalColorScheme = view.ColorScheme;
  344. view.NewMouseEvent (new () { Flags = MouseFlags.Button1Pressed, });
  345. if (highlightOnPress != HighlightStyle.None)
  346. {
  347. Assert.NotEqual (originalColorScheme, view.ColorScheme);
  348. }
  349. else
  350. {
  351. Assert.Equal (originalColorScheme, view.ColorScheme);
  352. }
  353. view.NewMouseEvent (new () { Flags = MouseFlags.Button1Released, });
  354. Assert.Equal (originalColorScheme, view.ColorScheme);
  355. Assert.Equal (expectedEnabling, enablingHighlight);
  356. Assert.Equal (expectedDisabling, disablingHighlight);
  357. view.Dispose ();
  358. return;
  359. void View_Highlight (object sender, CancelEventArgs<HighlightStyle> e)
  360. {
  361. if (e.NewValue == HighlightStyle.None)
  362. {
  363. disablingHighlight++;
  364. }
  365. else
  366. {
  367. enablingHighlight++;
  368. }
  369. }
  370. }
  371. // TODO: Add tests for each combination of HighlightFlags
  372. [Theory]
  373. [InlineData (0)]
  374. [InlineData (1)]
  375. [InlineData (10)]
  376. public void HighlightOnPress_Move_Keeps_Highlight (int x)
  377. {
  378. var view = new View ()
  379. {
  380. CanFocus = true,
  381. HighlightStyle = HighlightStyle.Pressed | HighlightStyle.PressedOutside,
  382. Height = 1,
  383. Width = 1
  384. };
  385. int enablingHighlight = 0;
  386. int disablingHighlight = 0;
  387. view.Highlight += View_Highlight;
  388. bool inViewport = view.Viewport.Contains (x, 0);
  389. // Start at 0,0 ; in viewport
  390. view.NewMouseEvent (new () { Flags = MouseFlags.Button1Pressed });
  391. Assert.Equal (1, enablingHighlight);
  392. Assert.Equal (0, disablingHighlight);
  393. // Move to x,0
  394. view.NewMouseEvent (new () { Flags = MouseFlags.Button1Pressed });
  395. if (inViewport)
  396. {
  397. Assert.Equal (2, enablingHighlight);
  398. Assert.Equal (0, disablingHighlight);
  399. }
  400. else
  401. {
  402. Assert.Equal (2, enablingHighlight);
  403. Assert.Equal (0, disablingHighlight);
  404. }
  405. // Move backto 0,0 ; in viewport
  406. view.NewMouseEvent (new () { Flags = MouseFlags.Button1Pressed });
  407. if (inViewport)
  408. {
  409. Assert.Equal (3, enablingHighlight);
  410. Assert.Equal (0, disablingHighlight);
  411. }
  412. else
  413. {
  414. Assert.Equal (3, enablingHighlight);
  415. Assert.Equal (0, disablingHighlight);
  416. }
  417. view.Dispose ();
  418. return;
  419. void View_Highlight (object sender, CancelEventArgs<HighlightStyle> e)
  420. {
  421. if (e.NewValue == HighlightStyle.None)
  422. {
  423. disablingHighlight++;
  424. }
  425. else
  426. {
  427. enablingHighlight++;
  428. }
  429. }
  430. }
  431. }