mirror of
https://github.com/gui-cs/Terminal.Gui.git
synced 2025-12-27 00:07:58 +01:00
* Fixed MouseGrabView bug. Added extensive test coverage for `Keyboard`, `Mouse`, `Timeout`, and `Popover` functionalities, including edge cases and concurrent access. Introduced parameterized and data-driven tests to reduce redundancy and improve clarity. Refactored codebase for modularity and maintainability, introducing new namespaces and reorganizing classes. Enhanced `MouseImpl`, `KeyboardImpl`, and `Runnable` implementations with improved event handling, thread safety, and support for the Terminal.Gui Cancellable Work Pattern (CWP). Removed deprecated code and legacy tests, such as `LogarithmicTimeout` and `SmoothAcceleratingTimeout`. Fixed bugs related to mouse grabbing during drag operations and unbalanced `ApplicationImpl.Begin/End` calls. Improved documentation and code readability with modern C# features. * Code cleanup. * Update Tests/UnitTestsParallelizable/Application/Runnable/RunnableIntegrationTests.cs Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Improve null handling and simplify test setup In `MouseImpl.cs`, added an early `return` after the `UngrabMouse()` call within the `if (view is null)` block to prevent further execution when `view` is `null`, improving null reference handling. In `RunnableIntegrationTests.cs`, removed the initialization of the `IApplication` object (`app`) from the `MultipleRunnables_IndependentResults` test method, simplifying the test setup and focusing on runnable behavior. * Code cleanup * API doc link cleanup --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
220 lines
6.6 KiB
C#
220 lines
6.6 KiB
C#
namespace ApplicationTests.Mouse;
|
|
|
|
/// <summary>
|
|
/// Tests for the <see cref="IMouse"/> interface and <see cref="MouseImpl"/> implementation.
|
|
/// These tests demonstrate the decoupled mouse handling that enables parallel test execution.
|
|
/// </summary>
|
|
public class MouseTests
|
|
{
|
|
[Fact]
|
|
public void Mouse_Instance_CreatedSuccessfully ()
|
|
{
|
|
// Arrange & Act
|
|
MouseImpl mouse = new ();
|
|
|
|
// Assert
|
|
Assert.NotNull (mouse);
|
|
Assert.False (mouse.IsMouseDisabled);
|
|
Assert.Null (mouse.LastMousePosition);
|
|
}
|
|
|
|
[Fact]
|
|
public void Mouse_LastMousePosition_CanBeSetAndRetrieved ()
|
|
{
|
|
// Arrange
|
|
MouseImpl mouse = new ();
|
|
Point expectedPosition = new (10, 20);
|
|
|
|
// Act
|
|
mouse.LastMousePosition = expectedPosition;
|
|
Point? actualPosition = mouse.LastMousePosition;
|
|
|
|
// Assert
|
|
Assert.Equal (expectedPosition, actualPosition);
|
|
}
|
|
|
|
[Fact]
|
|
public void Mouse_IsMouseDisabled_CanBeSetAndRetrieved ()
|
|
{
|
|
// Arrange
|
|
MouseImpl mouse = new ();
|
|
|
|
// Act
|
|
mouse.IsMouseDisabled = true;
|
|
|
|
// Assert
|
|
Assert.True (mouse.IsMouseDisabled);
|
|
}
|
|
|
|
[Fact]
|
|
public void Mouse_CachedViewsUnderMouse_InitializedEmpty ()
|
|
{
|
|
// Arrange
|
|
MouseImpl mouse = new ();
|
|
|
|
// Assert
|
|
Assert.NotNull (mouse.CachedViewsUnderMouse);
|
|
Assert.Empty (mouse.CachedViewsUnderMouse);
|
|
}
|
|
|
|
[Fact]
|
|
public void Mouse_ResetState_ClearsEventAndCachedViews ()
|
|
{
|
|
// Arrange
|
|
MouseImpl mouse = new ();
|
|
var eventFired = false;
|
|
mouse.MouseEvent += (sender, args) => eventFired = true;
|
|
mouse.CachedViewsUnderMouse.Add (new View ());
|
|
|
|
// Act
|
|
mouse.ResetState ();
|
|
|
|
// Assert - CachedViewsUnderMouse should be cleared
|
|
Assert.Empty (mouse.CachedViewsUnderMouse);
|
|
|
|
// Event handlers should be cleared
|
|
MouseEventArgs mouseEvent = new () { ScreenPosition = new Point (0, 0), Flags = MouseFlags.Button1Pressed };
|
|
mouse.RaiseMouseEvent (mouseEvent);
|
|
Assert.False (eventFired, "Event should not fire after ResetState");
|
|
}
|
|
|
|
[Fact]
|
|
public void Mouse_RaiseMouseEvent_DoesNotUpdateLastPositionWhenNotInitialized ()
|
|
{
|
|
// Arrange
|
|
MouseImpl mouse = new ();
|
|
MouseEventArgs mouseEvent = new () { ScreenPosition = new Point (5, 10), Flags = MouseFlags.Button1Pressed };
|
|
|
|
// Act - Application is not initialized, so LastMousePosition should not be set
|
|
mouse.RaiseMouseEvent (mouseEvent);
|
|
|
|
// Assert
|
|
// Since Application.Initialized is false, LastMousePosition should remain null
|
|
// This behavior matches the original implementation
|
|
Assert.Null (mouse.LastMousePosition);
|
|
}
|
|
|
|
[Fact]
|
|
public void Mouse_MouseEvent_CanBeSubscribedAndUnsubscribed ()
|
|
{
|
|
// Arrange
|
|
MouseImpl mouse = new ();
|
|
var eventCount = 0;
|
|
EventHandler<MouseEventArgs> handler = (sender, args) => eventCount++;
|
|
|
|
// Act - Subscribe
|
|
mouse.MouseEvent += handler;
|
|
MouseEventArgs mouseEvent = new () { ScreenPosition = new Point (0, 0), Flags = MouseFlags.Button1Pressed };
|
|
mouse.RaiseMouseEvent (mouseEvent);
|
|
|
|
// Assert - Event fired once
|
|
Assert.Equal (1, eventCount);
|
|
|
|
// Act - Unsubscribe
|
|
mouse.MouseEvent -= handler;
|
|
mouse.RaiseMouseEvent (mouseEvent);
|
|
|
|
// Assert - Event count unchanged
|
|
Assert.Equal (1, eventCount);
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
/// Tests that the mouse coordinates passed to the focused view are correct when the mouse is clicked. With
|
|
/// Frames; Frame != Viewport
|
|
/// </summary>
|
|
[Theory]
|
|
|
|
// click on border
|
|
[InlineData (0, 0, 0, 0, 0, 0)]
|
|
[InlineData (0, 1, 0, 0, 0, 0)]
|
|
[InlineData (0, 0, 1, 0, 0, 0)]
|
|
[InlineData (0, 9, 0, 0, 0, 0)]
|
|
[InlineData (0, 0, 9, 0, 0, 0)]
|
|
|
|
// outside border
|
|
[InlineData (0, 10, 0, 0, 0, 0)]
|
|
[InlineData (0, 0, 10, 0, 0, 0)]
|
|
|
|
// view is offset from origin ; click is on border
|
|
[InlineData (1, 1, 1, 0, 0, 0)]
|
|
[InlineData (1, 2, 1, 0, 0, 0)]
|
|
[InlineData (1, 1, 2, 0, 0, 0)]
|
|
[InlineData (1, 10, 1, 0, 0, 0)]
|
|
[InlineData (1, 1, 10, 0, 0, 0)]
|
|
|
|
// outside border
|
|
[InlineData (1, -1, 0, 0, 0, 0)]
|
|
[InlineData (1, 0, -1, 0, 0, 0)]
|
|
[InlineData (1, 10, 10, 0, 0, 0)]
|
|
[InlineData (1, 11, 11, 0, 0, 0)]
|
|
|
|
// view is at origin, click is inside border
|
|
[InlineData (0, 1, 1, 0, 0, 1)]
|
|
[InlineData (0, 2, 1, 1, 0, 1)]
|
|
[InlineData (0, 1, 2, 0, 1, 1)]
|
|
[InlineData (0, 8, 1, 7, 0, 1)]
|
|
[InlineData (0, 1, 8, 0, 7, 1)]
|
|
[InlineData (0, 8, 8, 7, 7, 1)]
|
|
|
|
// view is offset from origin ; click inside border
|
|
// our view is 10x10, but has a border, so it's bounds is 8x8
|
|
[InlineData (1, 2, 2, 0, 0, 1)]
|
|
[InlineData (1, 3, 2, 1, 0, 1)]
|
|
[InlineData (1, 2, 3, 0, 1, 1)]
|
|
[InlineData (1, 9, 2, 7, 0, 1)]
|
|
[InlineData (1, 2, 9, 0, 7, 1)]
|
|
[InlineData (1, 9, 9, 7, 7, 1)]
|
|
[InlineData (1, 10, 10, 7, 7, 0)]
|
|
|
|
//01234567890123456789
|
|
// |12345678|
|
|
// |xxxxxxxx
|
|
public void MouseCoordinatesTest_Border (
|
|
int offset,
|
|
int clickX,
|
|
int clickY,
|
|
int expectedX,
|
|
int expectedY,
|
|
int expectedClickedCount
|
|
)
|
|
{
|
|
Size size = new (10, 10);
|
|
Point pos = new (offset, offset);
|
|
|
|
int clickedCount = 0;
|
|
|
|
using IApplication? application = Application.Create ();
|
|
|
|
application.Begin (new Window ()
|
|
{
|
|
Id = "top",
|
|
});
|
|
application.TopRunnableView!.X = 0;
|
|
application.TopRunnableView.Y = 0;
|
|
application.TopRunnableView.Width = size.Width * 2;
|
|
application.TopRunnableView.Height = size.Height * 2;
|
|
application.TopRunnableView.BorderStyle = LineStyle.None;
|
|
|
|
var view = new View { Id = "view", X = pos.X, Y = pos.Y, Width = size.Width, Height = size.Height };
|
|
|
|
// Give the view a border. With PR #2920, mouse clicks are only passed if they are inside the view's Viewport.
|
|
view.BorderStyle = LineStyle.Single;
|
|
view.CanFocus = true;
|
|
|
|
application.TopRunnableView.Add (view);
|
|
|
|
var mouseEvent = new MouseEventArgs { Position = new (clickX, clickY), ScreenPosition = new (clickX, clickY), Flags = MouseFlags.Button1Clicked };
|
|
|
|
view.MouseEvent += (_s, e) =>
|
|
{
|
|
Assert.Equal (expectedX, e.Position.X);
|
|
Assert.Equal (expectedY, e.Position.Y);
|
|
clickedCount += e.IsSingleDoubleOrTripleClicked ? 1 : 0;
|
|
};
|
|
|
|
application.Mouse.RaiseMouseEvent (mouseEvent);
|
|
Assert.Equal (expectedClickedCount, clickedCount);
|
|
}
|
|
}
|