MouseTests.cs 16 KB

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