mirror of
https://github.com/gui-cs/Terminal.Gui.git
synced 2025-12-27 08:17:53 +01:00
acb5979e6c
* Subview clean up * New Add/Remove event pattern * Using Logging * cleanup * Subview -> SubView * Test code cleanup. Killed many warnings. * Fix tznind feedback * Refactored AllViewTest helpers * Moved keyboard tests to parallel * Moved mouse tests to parallel * Moved view tests to parallel * Test code cleanup. Killed many warnings. * dupe test * Some mouse tests can't run in parallel because MouseGrabView * Made SpinnerView more testable * Moved more tests * SubViews to IReadOnlyCollection<View> * SubViews to IReadOnlyCollection<View> 2 * scrollbar tests * shortcut tests * Use InternalSubViews vs. _subviews * Nuked View.IsAdded. Added View.SuperViewChanged. * API doc updats * Unit Test tweak * Unit Test tweak
418 lines
14 KiB
C#
418 lines
14 KiB
C#
using System.Text;
|
||
using Xunit.Abstractions;
|
||
|
||
namespace Terminal.Gui.ViewTests;
|
||
|
||
public class HotKeyTests
|
||
{
|
||
[Theory]
|
||
[InlineData (KeyCode.A)]
|
||
[InlineData (KeyCode.A | KeyCode.ShiftMask)]
|
||
[InlineData (KeyCode.D1)]
|
||
[InlineData (KeyCode.D1 | KeyCode.ShiftMask)] // '!'
|
||
[InlineData ((KeyCode)'х')] // Cyrillic x
|
||
[InlineData ((KeyCode)'你')] // Chinese ni
|
||
public void AddKeyBindingsForHotKey_Sets (KeyCode key)
|
||
{
|
||
var view = new View ();
|
||
view.HotKey = KeyCode.Z;
|
||
Assert.Equal (string.Empty, view.Title);
|
||
Assert.Equal (KeyCode.Z, view.HotKey);
|
||
|
||
view.AddKeyBindingsForHotKey (KeyCode.Null, key);
|
||
|
||
// Verify key bindings were set
|
||
|
||
// As passed
|
||
Command [] commands = view.HotKeyBindings.GetCommands (key);
|
||
Assert.Contains (Command.HotKey, commands);
|
||
commands = view.HotKeyBindings.GetCommands (key | KeyCode.AltMask);
|
||
Assert.Contains (Command.HotKey, commands);
|
||
|
||
KeyCode baseKey = key & ~KeyCode.ShiftMask;
|
||
|
||
// If A...Z, with and without shift
|
||
if (baseKey is >= KeyCode.A and <= KeyCode.Z)
|
||
{
|
||
commands = view.HotKeyBindings.GetCommands (key | KeyCode.ShiftMask);
|
||
Assert.Contains (Command.HotKey, commands);
|
||
commands = view.HotKeyBindings.GetCommands (key & ~KeyCode.ShiftMask);
|
||
Assert.Contains (Command.HotKey, commands);
|
||
commands = view.HotKeyBindings.GetCommands (key | KeyCode.AltMask);
|
||
Assert.Contains (Command.HotKey, commands);
|
||
commands = view.HotKeyBindings.GetCommands ((key & ~KeyCode.ShiftMask) | KeyCode.AltMask);
|
||
Assert.Contains (Command.HotKey, commands);
|
||
}
|
||
else
|
||
{
|
||
// Non A..Z keys should not have shift bindings
|
||
if (key.HasFlag (KeyCode.ShiftMask))
|
||
{
|
||
commands = view.HotKeyBindings.GetCommands (key & ~KeyCode.ShiftMask);
|
||
Assert.Empty (commands);
|
||
}
|
||
else
|
||
{
|
||
commands = view.HotKeyBindings.GetCommands (key | KeyCode.ShiftMask);
|
||
Assert.Empty (commands);
|
||
}
|
||
}
|
||
}
|
||
|
||
[Fact]
|
||
public void AddKeyBindingsForHotKey_SetsBinding_Key ()
|
||
{
|
||
var view = new View ();
|
||
view.HotKey = KeyCode.Z;
|
||
Assert.Equal (string.Empty, view.Title);
|
||
Assert.Equal (KeyCode.Z, view.HotKey);
|
||
|
||
view.AddKeyBindingsForHotKey (view.HotKey, Key.A);
|
||
view.HotKeyBindings.TryGet (Key.A, out var binding);
|
||
Assert.Equal (Key.A, binding.Key);
|
||
}
|
||
|
||
[Fact]
|
||
public void AddKeyBindingsForHotKey_SetsBinding_Data ()
|
||
{
|
||
var view = new View ();
|
||
view.HotKey = KeyCode.Z;
|
||
Assert.Equal (KeyCode.Z, view.HotKey);
|
||
|
||
view.AddKeyBindingsForHotKey (view.HotKey, Key.A, "data");
|
||
view.HotKeyBindings.TryGet (Key.A, out var binding);
|
||
Assert.Equal ("data", binding.Data);
|
||
}
|
||
|
||
[Fact]
|
||
public void Defaults ()
|
||
{
|
||
var view = new View ();
|
||
Assert.Equal (string.Empty, view.Title);
|
||
Assert.Equal (KeyCode.Null, view.HotKey);
|
||
|
||
// Verify key bindings were set
|
||
Command [] commands = view.KeyBindings.GetCommands (KeyCode.Null);
|
||
Assert.Empty (commands);
|
||
|
||
commands = view.HotKeyBindings.GetCommands (KeyCode.Null);
|
||
Assert.Empty (commands);
|
||
|
||
Assert.Empty (view.HotKeyBindings.GetBindings ());
|
||
}
|
||
|
||
[Theory]
|
||
[InlineData (KeyCode.Null, true)] // non-shift
|
||
[InlineData (KeyCode.ShiftMask, true)]
|
||
[InlineData (KeyCode.AltMask, true)]
|
||
[InlineData (KeyCode.ShiftMask | KeyCode.AltMask, true)]
|
||
[InlineData (KeyCode.CtrlMask, false)]
|
||
[InlineData (KeyCode.ShiftMask | KeyCode.CtrlMask, false)]
|
||
public void NewKeyDownEvent_Runs_Default_HotKey_Command (KeyCode mask, bool expected)
|
||
{
|
||
var view = new View { HotKeySpecifier = (Rune)'^', Title = "^Test" };
|
||
view.CanFocus = true;
|
||
Assert.False (view.HasFocus);
|
||
view.NewKeyDownEvent (KeyCode.T | mask);
|
||
Assert.Equal (expected, view.HasFocus);
|
||
}
|
||
|
||
[Fact]
|
||
public void NewKeyDownEvent_Ignores_Focus_KeyBindings_SuperView ()
|
||
{
|
||
var view = new View ();
|
||
view.HotKeyBindings.Add (Key.A, Command.HotKey);
|
||
view.KeyDownNotHandled += (s, e) => { Assert.Fail (); };
|
||
|
||
var superView = new View ();
|
||
superView.Add (view);
|
||
|
||
var ke = Key.A;
|
||
superView.NewKeyDownEvent (ke);
|
||
}
|
||
|
||
[Fact]
|
||
public void NewKeyDownEvent_Honors_HotKey_KeyBindings_SuperView ()
|
||
{
|
||
var view = new View ();
|
||
view.HotKeyBindings.Add (Key.A, Command.HotKey);
|
||
bool hotKeyInvoked = false;
|
||
view.HandlingHotKey += (s, e) => { hotKeyInvoked = true; };
|
||
|
||
bool notHandled = false;
|
||
view.KeyDownNotHandled += (s, e) => { notHandled = true; };
|
||
|
||
var superView = new View ();
|
||
superView.Add (view);
|
||
|
||
var ke = Key.A;
|
||
superView.NewKeyDownEvent (ke);
|
||
|
||
Assert.False (notHandled);
|
||
Assert.True (hotKeyInvoked);
|
||
}
|
||
|
||
|
||
[Fact]
|
||
public void NewKeyDownEvent_InNewKeyDownEvent_Invokes_HotKey_Command_With_SuperView ()
|
||
{
|
||
var superView = new View ()
|
||
{
|
||
CanFocus = true
|
||
};
|
||
|
||
var view1 = new View
|
||
{
|
||
HotKeySpecifier = (Rune)'^',
|
||
Title = "view^1",
|
||
CanFocus = true
|
||
};
|
||
|
||
var view2 = new View
|
||
{
|
||
HotKeySpecifier = (Rune)'^',
|
||
Title = "view^2",
|
||
CanFocus = true
|
||
};
|
||
|
||
superView.Add (view1, view2);
|
||
|
||
superView.SetFocus ();
|
||
Assert.True (view1.HasFocus);
|
||
|
||
var ke = Key.D2;
|
||
superView.NewKeyDownEvent (ke);
|
||
Assert.True (view2.HasFocus);
|
||
}
|
||
|
||
[Fact]
|
||
public void Set_RemovesOldKeyBindings ()
|
||
{
|
||
var view = new View ();
|
||
view.HotKey = KeyCode.A;
|
||
Assert.Equal (string.Empty, view.Title);
|
||
Assert.Equal (KeyCode.A, view.HotKey);
|
||
|
||
// Verify key bindings were set
|
||
Command [] commands = view.HotKeyBindings.GetCommands (KeyCode.A);
|
||
Assert.Contains (Command.HotKey, commands);
|
||
|
||
commands = view.HotKeyBindings.GetCommands (KeyCode.A | KeyCode.ShiftMask);
|
||
Assert.Contains (Command.HotKey, commands);
|
||
|
||
commands = view.HotKeyBindings.GetCommands (KeyCode.A | KeyCode.AltMask);
|
||
Assert.Contains (Command.HotKey, commands);
|
||
|
||
commands = view.HotKeyBindings.GetCommands (KeyCode.A | KeyCode.ShiftMask | KeyCode.AltMask);
|
||
Assert.Contains (Command.HotKey, commands);
|
||
|
||
// Now set again
|
||
view.HotKey = KeyCode.B;
|
||
Assert.Equal (string.Empty, view.Title);
|
||
Assert.Equal (KeyCode.B, view.HotKey);
|
||
|
||
commands = view.HotKeyBindings.GetCommands (KeyCode.A);
|
||
Assert.DoesNotContain (Command.HotKey, commands);
|
||
|
||
commands = view.HotKeyBindings.GetCommands (KeyCode.A | KeyCode.ShiftMask);
|
||
Assert.DoesNotContain (Command.HotKey, commands);
|
||
|
||
commands = view.HotKeyBindings.GetCommands (KeyCode.A | KeyCode.AltMask);
|
||
Assert.DoesNotContain (Command.HotKey, commands);
|
||
|
||
commands = view.HotKeyBindings.GetCommands (KeyCode.A | KeyCode.ShiftMask | KeyCode.AltMask);
|
||
Assert.DoesNotContain (Command.HotKey, commands);
|
||
}
|
||
|
||
[Theory]
|
||
[InlineData (KeyCode.A)]
|
||
[InlineData (KeyCode.A | KeyCode.ShiftMask)]
|
||
[InlineData (KeyCode.D1)]
|
||
[InlineData (KeyCode.D1 | KeyCode.ShiftMask)]
|
||
[InlineData ((KeyCode)'!')]
|
||
[InlineData ((KeyCode)'х')] // Cyrillic x
|
||
[InlineData ((KeyCode)'你')] // Chinese ni
|
||
[InlineData ((KeyCode)'ö')] // German o umlaut
|
||
[InlineData (KeyCode.Null)]
|
||
public void Set_Sets_WithValidKey (KeyCode key)
|
||
{
|
||
var view = new View ();
|
||
view.HotKey = key;
|
||
Assert.Equal (key, view.HotKey);
|
||
}
|
||
|
||
[Theory]
|
||
[InlineData (KeyCode.A)]
|
||
[InlineData (KeyCode.A | KeyCode.ShiftMask)]
|
||
[InlineData (KeyCode.D1)]
|
||
[InlineData (KeyCode.D1 | KeyCode.ShiftMask)] // '!'
|
||
[InlineData ((KeyCode)'х')] // Cyrillic x
|
||
[InlineData ((KeyCode)'你')] // Chinese ni
|
||
[InlineData ((KeyCode)'ö')] // German o umlaut
|
||
public void Set_SetsKeyBindings (KeyCode key)
|
||
{
|
||
var view = new View ();
|
||
view.HotKey = key;
|
||
Assert.Equal (string.Empty, view.Title);
|
||
Assert.Equal (key, view.HotKey);
|
||
|
||
// Verify key bindings were set
|
||
|
||
// As passed
|
||
Command [] commands = view.HotKeyBindings.GetCommands (view.HotKey);
|
||
Assert.Contains (Command.HotKey, commands);
|
||
|
||
Key baseKey = view.HotKey.NoShift;
|
||
|
||
// If A...Z, with and without shift
|
||
if (baseKey.IsKeyCodeAtoZ)
|
||
{
|
||
commands = view.HotKeyBindings.GetCommands (view.HotKey.WithShift);
|
||
Assert.Contains (Command.HotKey, commands);
|
||
commands = view.HotKeyBindings.GetCommands (view.HotKey.NoShift);
|
||
Assert.Contains (Command.HotKey, commands);
|
||
commands = view.HotKeyBindings.GetCommands (view.HotKey.WithAlt);
|
||
Assert.Contains (Command.HotKey, commands);
|
||
commands = view.HotKeyBindings.GetCommands (view.HotKey.NoShift.WithAlt);
|
||
Assert.Contains (Command.HotKey, commands);
|
||
}
|
||
else
|
||
{
|
||
// Non A..Z keys should not have shift bindings
|
||
if (view.HotKey.IsShift)
|
||
{
|
||
commands = view.HotKeyBindings.GetCommands (view.HotKey.NoShift);
|
||
Assert.Empty (commands);
|
||
}
|
||
else
|
||
{
|
||
commands = view.HotKeyBindings.GetCommands (view.HotKey.WithShift);
|
||
Assert.Empty (commands);
|
||
}
|
||
}
|
||
}
|
||
|
||
[Fact]
|
||
public void Set_Throws_If_Modifiers_Are_Included ()
|
||
{
|
||
var view = new View ();
|
||
|
||
// A..Z must be naked (Alt is assumed)
|
||
view.HotKey = Key.A.WithAlt;
|
||
Assert.Throws<ArgumentException> (() => view.HotKey = Key.A.WithCtrl);
|
||
|
||
Assert.Throws<ArgumentException> (
|
||
() =>
|
||
view.HotKey =
|
||
KeyCode.A | KeyCode.ShiftMask | KeyCode.AltMask | KeyCode.CtrlMask
|
||
);
|
||
|
||
// All others must not have Ctrl (Alt is assumed)
|
||
view.HotKey = Key.D1.WithAlt;
|
||
Assert.Throws<ArgumentException> (() => view.HotKey = Key.D1.WithCtrl);
|
||
|
||
Assert.Throws<ArgumentException> (
|
||
() =>
|
||
view.HotKey =
|
||
KeyCode.D1 | KeyCode.ShiftMask | KeyCode.AltMask | KeyCode.CtrlMask
|
||
);
|
||
|
||
// Shift is ok (e.g. this is '!')
|
||
view.HotKey = Key.D1.WithShift;
|
||
}
|
||
|
||
[Theory]
|
||
[InlineData (KeyCode.Delete)]
|
||
[InlineData (KeyCode.Backspace)]
|
||
[InlineData (KeyCode.Tab)]
|
||
[InlineData (KeyCode.Enter)]
|
||
[InlineData (KeyCode.Esc)]
|
||
[InlineData (KeyCode.Space)]
|
||
[InlineData (KeyCode.CursorLeft)]
|
||
[InlineData (KeyCode.F1)]
|
||
[InlineData (KeyCode.Null | KeyCode.ShiftMask)]
|
||
public void Set_Throws_With_Invalid_Key (KeyCode key)
|
||
{
|
||
var view = new View ();
|
||
Assert.Throws<ArgumentException> (() => view.HotKey = key);
|
||
}
|
||
|
||
[Theory]
|
||
[InlineData ("Test", KeyCode.Null)]
|
||
[InlineData ("^Test", KeyCode.T)]
|
||
[InlineData ("T^est", KeyCode.E)]
|
||
[InlineData ("Te^st", KeyCode.S)]
|
||
[InlineData ("Tes^t", KeyCode.T)]
|
||
[InlineData ("other", KeyCode.Null)]
|
||
[InlineData ("oTher", KeyCode.Null)]
|
||
[InlineData ("^Öther", (KeyCode)'Ö')]
|
||
[InlineData ("^öther", (KeyCode)'ö')]
|
||
|
||
// BUGBUG: '!' should be supported. Line 968 of TextFormatter filters on char.IsLetterOrDigit
|
||
//[InlineData ("Test^!", (Key)'!')]
|
||
public void Title_Change_Sets_HotKey (string title, KeyCode expectedHotKey)
|
||
{
|
||
var view = new View { HotKeySpecifier = new Rune ('^'), Title = "^Hello" };
|
||
Assert.Equal (KeyCode.H, view.HotKey);
|
||
|
||
view.Title = title;
|
||
Assert.Equal (expectedHotKey, view.HotKey);
|
||
}
|
||
|
||
[Theory]
|
||
[InlineData ("^Test")]
|
||
public void Title_Empty_Sets_HotKey_To_Null (string title)
|
||
{
|
||
var view = new View { HotKeySpecifier = (Rune)'^', Title = title };
|
||
|
||
Assert.Equal (title, view.Title);
|
||
Assert.Equal (KeyCode.T, view.HotKey);
|
||
|
||
view.Title = string.Empty;
|
||
Assert.Equal ("", view.Title);
|
||
Assert.Equal (KeyCode.Null, view.HotKey);
|
||
}
|
||
|
||
|
||
[Fact]
|
||
public void HotKey_Raises_HotKeyCommand ()
|
||
{
|
||
var hotKeyRaised = false;
|
||
var acceptRaised = false;
|
||
var selectRaised = false;
|
||
Application.Top = new Toplevel ();
|
||
var view = new View
|
||
{
|
||
CanFocus = true,
|
||
HotKeySpecifier = new Rune ('_'),
|
||
Title = "_Test"
|
||
};
|
||
Application.Top.Add (view);
|
||
view.HandlingHotKey += (s, e) => hotKeyRaised = true;
|
||
view.Accepting += (s, e) => acceptRaised = true;
|
||
view.Selecting += (s, e) => selectRaised = true;
|
||
|
||
Assert.Equal (KeyCode.T, view.HotKey);
|
||
Assert.True (Application.RaiseKeyDownEvent (Key.T));
|
||
Assert.True (hotKeyRaised);
|
||
Assert.False (acceptRaised);
|
||
Assert.False (selectRaised);
|
||
|
||
hotKeyRaised = false;
|
||
Assert.True (Application.RaiseKeyDownEvent (Key.T.WithAlt));
|
||
Assert.True (hotKeyRaised);
|
||
Assert.False (acceptRaised);
|
||
Assert.False (selectRaised);
|
||
|
||
hotKeyRaised = false;
|
||
view.HotKey = KeyCode.E;
|
||
Assert.True (Application.RaiseKeyDownEvent (Key.E.WithAlt));
|
||
Assert.True (hotKeyRaised);
|
||
Assert.False (acceptRaised);
|
||
Assert.False (selectRaised);
|
||
|
||
Application.Top.Dispose ();
|
||
Application.ResetState (true);
|
||
}
|
||
}
|