using Xunit.Abstractions;
// Alias Console to MockConsole so we don't accidentally use Console
namespace Terminal.Gui.ViewTests;
public class KeyboardEventTests (ITestOutputHelper output) : TestsAllViews
{
///
/// This tests that when a new key down event is sent to the view will fire the 3 key-down related
/// events: KeyDown, InvokingKeyBindings, and ProcessKeyDown. Note that KeyUp is independent.
///
[Theory]
[MemberData (nameof (AllViewTypes))]
public void AllViews_KeyDown_All_EventsFire (Type viewType)
{
var view = CreateInstanceIfNotGeneric (viewType);
if (view == null)
{
output.WriteLine ($"ERROR: Skipping generic view: {viewType}");
return;
}
output.WriteLine ($"Testing {viewType}");
var keyDown = false;
view.KeyDown += (s, a) =>
{
a.Handled = false; // don't handle it so the other events are called
keyDown = true;
};
var invokingKeyBindings = false;
view.InvokingKeyBindings += (s, a) =>
{
a.Handled = false; // don't handle it so the other events are called
invokingKeyBindings = true;
};
var keyDownProcessed = false;
view.ProcessKeyDown += (s, a) =>
{
a.Handled = true;
keyDownProcessed = true;
};
Assert.True (view.NewKeyDownEvent (Key.A)); // this will be true because the ProcessKeyDown event handled it
Assert.True (keyDown);
Assert.True (invokingKeyBindings);
Assert.True (keyDownProcessed);
view.Dispose ();
}
///
/// This tests that when a new key up event is sent to the view the view will fire the 1 key-up related event:
/// KeyUp
///
[Theory]
[MemberData (nameof (AllViewTypes))]
public void AllViews_KeyUp_All_EventsFire (Type viewType)
{
var view = CreateInstanceIfNotGeneric (viewType);
if (view == null)
{
output.WriteLine ($"ERROR: Generic view {viewType}");
return;
}
output.WriteLine ($"Testing {view.GetType ().Name}");
var keyUp = false;
view.KeyUp += (s, a) =>
{
a.Handled = true;
keyUp = true;
};
Assert.True (view.NewKeyUpEvent (Key.A)); // this will be true because the KeyUp event handled it
Assert.True (keyUp);
view.Dispose ();
}
[Theory]
[InlineData (true, false, false)]
[InlineData (true, true, false)]
[InlineData (true, true, true)]
public void Events_Are_Called_With_Only_Key_Modifiers (bool shift, bool alt, bool control)
{
var keyDown = false;
var keyPressed = false;
var keyUp = false;
var view = new OnKeyTestView ();
view.CancelVirtualMethods = false;
view.KeyDown += (s, e) =>
{
Assert.Equal (KeyCode.Null, e.KeyCode & ~KeyCode.CtrlMask & ~KeyCode.AltMask & ~KeyCode.ShiftMask);
Assert.Equal (shift, e.IsShift);
Assert.Equal (alt, e.IsAlt);
Assert.Equal (control, e.IsCtrl);
Assert.False (keyDown);
Assert.False (view.OnKeyDownContinued);
keyDown = true;
};
view.ProcessKeyDown += (s, e) => { keyPressed = true; };
view.KeyUp += (s, e) =>
{
Assert.Equal (KeyCode.Null, e.KeyCode & ~KeyCode.CtrlMask & ~KeyCode.AltMask & ~KeyCode.ShiftMask);
Assert.Equal (shift, e.IsShift);
Assert.Equal (alt, e.IsAlt);
Assert.Equal (control, e.IsCtrl);
Assert.False (keyUp);
Assert.False (view.OnKeyUpContinued);
keyUp = true;
};
//view.ProcessKeyDownEvent (new (Key.Null | (shift ? Key.ShiftMask : 0) | (alt ? Key.AltMask : 0) | (control ? Key.CtrlMask : 0)));
//Assert.True (keyDown);
//Assert.True (view.OnKeyDownWasCalled);
//Assert.True (view.OnProcessKeyDownWasCalled);
view.NewKeyDownEvent (
new (
KeyCode.Null
| (shift ? KeyCode.ShiftMask : 0)
| (alt ? KeyCode.AltMask : 0)
| (control ? KeyCode.CtrlMask : 0)
)
);
Assert.True (keyPressed);
Assert.True (view.OnKeyDownContinued);
Assert.True (view.OnKeyPressedContinued);
view.NewKeyUpEvent (
new (
KeyCode.Null
| (shift ? KeyCode.ShiftMask : 0)
| (alt ? KeyCode.AltMask : 0)
| (control ? KeyCode.CtrlMask : 0)
)
);
Assert.True (keyUp);
Assert.True (view.OnKeyUpContinued);
}
[Fact]
public void InvokingKeyBindings_Handled_Cancels ()
{
var view = new View ();
var keyPressInvoked = false;
var invokingKeyBindingsInvoked = false;
var processKeyPressInvoked = false;
var setHandledTo = false;
view.KeyDown += (s, e) =>
{
keyPressInvoked = true;
Assert.False (e.Handled);
Assert.Equal (KeyCode.N, e.KeyCode);
};
view.InvokingKeyBindings += (s, e) =>
{
invokingKeyBindingsInvoked = true;
e.Handled = setHandledTo;
Assert.Equal (setHandledTo, e.Handled);
Assert.Equal (KeyCode.N, e.KeyCode);
};
view.ProcessKeyDown += (s, e) =>
{
processKeyPressInvoked = true;
processKeyPressInvoked = true;
Assert.False (e.Handled);
Assert.Equal (KeyCode.N, e.KeyCode);
};
view.NewKeyDownEvent (Key.N);
Assert.True (keyPressInvoked);
Assert.True (invokingKeyBindingsInvoked);
Assert.True (processKeyPressInvoked);
keyPressInvoked = false;
invokingKeyBindingsInvoked = false;
processKeyPressInvoked = false;
setHandledTo = true;
view.NewKeyDownEvent (Key.N);
Assert.True (keyPressInvoked);
Assert.True (invokingKeyBindingsInvoked);
Assert.False (processKeyPressInvoked);
}
[Fact]
public void InvokingKeyBindings_Handled_True_Stops_Processing ()
{
var keyDown = false;
var invokingKeyBindings = false;
var keyPressed = false;
var view = new OnKeyTestView ();
Assert.True (view.CanFocus);
view.CancelVirtualMethods = false;
view.KeyDown += (s, e) =>
{
Assert.Equal (KeyCode.A, e.KeyCode);
Assert.False (keyDown);
Assert.False (view.OnKeyDownContinued);
e.Handled = false;
keyDown = true;
};
view.InvokingKeyBindings += (s, e) =>
{
Assert.Equal (KeyCode.A, e.KeyCode);
Assert.False (keyPressed);
Assert.False (view.OnInvokingKeyBindingsContinued);
e.Handled = true;
invokingKeyBindings = true;
};
view.ProcessKeyDown += (s, e) =>
{
Assert.Equal (KeyCode.A, e.KeyCode);
Assert.False (keyPressed);
Assert.False (view.OnKeyPressedContinued);
e.Handled = true;
keyPressed = true;
};
view.NewKeyDownEvent (Key.A);
Assert.True (keyDown);
Assert.True (invokingKeyBindings);
Assert.False (keyPressed);
Assert.True (view.OnKeyDownContinued);
Assert.False (view.OnInvokingKeyBindingsContinued);
Assert.False (view.OnKeyPressedContinued);
}
[Fact]
public void KeyDown_Handled_True_Stops_Processing ()
{
var keyDown = false;
var invokingKeyBindings = false;
var keyPressed = false;
var view = new OnKeyTestView ();
Assert.True (view.CanFocus);
view.CancelVirtualMethods = false;
view.KeyDown += (s, e) =>
{
Assert.Equal (KeyCode.A, e.KeyCode);
Assert.False (keyDown);
Assert.False (view.OnKeyDownContinued);
e.Handled = true;
keyDown = true;
};
view.InvokingKeyBindings += (s, e) =>
{
Assert.Equal (KeyCode.A, e.KeyCode);
Assert.False (keyPressed);
Assert.False (view.OnInvokingKeyBindingsContinued);
e.Handled = true;
invokingKeyBindings = true;
};
view.ProcessKeyDown += (s, e) =>
{
Assert.Equal (KeyCode.A, e.KeyCode);
Assert.False (keyPressed);
Assert.False (view.OnKeyPressedContinued);
e.Handled = true;
keyPressed = true;
};
view.NewKeyDownEvent (Key.A);
Assert.True (keyDown);
Assert.False (invokingKeyBindings);
Assert.False (keyPressed);
Assert.False (view.OnKeyDownContinued);
Assert.False (view.OnInvokingKeyBindingsContinued);
Assert.False (view.OnKeyPressedContinued);
}
[Fact]
public void KeyPress_Handled_Cancels ()
{
var view = new View ();
var invokingKeyBindingsInvoked = false;
var processKeyPressInvoked = false;
var setHandledTo = false;
view.KeyDown += (s, e) =>
{
e.Handled = setHandledTo;
Assert.Equal (setHandledTo, e.Handled);
Assert.Equal (KeyCode.N, e.KeyCode);
};
view.InvokingKeyBindings += (s, e) =>
{
invokingKeyBindingsInvoked = true;
Assert.False (e.Handled);
Assert.Equal (KeyCode.N, e.KeyCode);
};
view.ProcessKeyDown += (s, e) =>
{
processKeyPressInvoked = true;
Assert.False (e.Handled);
Assert.Equal (KeyCode.N, e.KeyCode);
};
view.NewKeyDownEvent (Key.N);
Assert.True (invokingKeyBindingsInvoked);
Assert.True (processKeyPressInvoked);
invokingKeyBindingsInvoked = false;
processKeyPressInvoked = false;
setHandledTo = true;
view.NewKeyDownEvent (Key.N);
Assert.False (invokingKeyBindingsInvoked);
Assert.False (processKeyPressInvoked);
}
[Fact]
public void KeyPressed_Handled_True_Stops_Processing ()
{
var keyDown = false;
var invokingKeyBindings = false;
var keyPressed = false;
var view = new OnKeyTestView ();
Assert.True (view.CanFocus);
view.CancelVirtualMethods = false;
view.KeyDown += (s, e) =>
{
Assert.Equal (KeyCode.A, e.KeyCode);
Assert.False (keyDown);
Assert.False (view.OnKeyDownContinued);
e.Handled = false;
keyDown = true;
};
view.InvokingKeyBindings += (s, e) =>
{
Assert.Equal (KeyCode.A, e.KeyCode);
Assert.False (keyPressed);
Assert.False (view.OnInvokingKeyBindingsContinued);
e.Handled = false;
invokingKeyBindings = true;
};
view.ProcessKeyDown += (s, e) =>
{
Assert.Equal (KeyCode.A, e.KeyCode);
Assert.False (keyPressed);
Assert.False (view.OnKeyPressedContinued);
e.Handled = true;
keyPressed = true;
};
view.NewKeyDownEvent (Key.A);
Assert.True (keyDown);
Assert.True (invokingKeyBindings);
Assert.True (keyPressed);
Assert.True (view.OnKeyDownContinued);
Assert.True (view.OnInvokingKeyBindingsContinued);
Assert.False (view.OnKeyPressedContinued);
}
[Fact]
public void KeyUp_Handled_True_Stops_Processing ()
{
var keyUp = false;
var view = new OnKeyTestView ();
Assert.True (view.CanFocus);
view.CancelVirtualMethods = false;
view.KeyUp += (s, e) =>
{
Assert.Equal (KeyCode.A, e.KeyCode);
Assert.False (keyUp);
Assert.False (view.OnKeyPressedContinued);
e.Handled = true;
keyUp = true;
};
view.NewKeyUpEvent (Key.A);
Assert.True (keyUp);
Assert.False (view.OnKeyUpContinued);
Assert.False (view.OnKeyDownContinued);
Assert.False (view.OnInvokingKeyBindingsContinued);
Assert.False (view.OnKeyPressedContinued);
}
[Theory]
[InlineData (null, null)]
[InlineData (true, true)]
[InlineData (false, false)]
public void OnInvokingKeyBindings_Returns_Nullable_Properly (bool? toReturn, bool? expected)
{
var view = new KeyBindingsTestView ();
view.CommandReturns = toReturn;
bool? result = view.OnInvokingKeyBindings (Key.A, KeyBindingScope.HotKey | KeyBindingScope.Focused);
Assert.Equal (expected, result);
}
/// A view that overrides the OnKey* methods so we can test that they are called.
public class KeyBindingsTestView : View
{
public KeyBindingsTestView ()
{
CanFocus = true;
AddCommand (Command.HotKey, () => CommandReturns);
KeyBindings.Add (Key.A, Command.HotKey);
}
public bool? CommandReturns { get; set; }
}
/// A view that overrides the OnKey* methods so we can test that they are called.
public class OnKeyTestView : View
{
public OnKeyTestView () { CanFocus = true; }
public bool CancelVirtualMethods { set; private get; }
public bool OnInvokingKeyBindingsContinued { get; set; }
public bool OnKeyDownContinued { get; set; }
public bool OnKeyPressedContinued { get; set; }
public bool OnKeyUpContinued { get; set; }
public override string Text { get; set; }
public override bool? OnInvokingKeyBindings (Key keyEvent, KeyBindingScope scope)
{
bool? handled = base.OnInvokingKeyBindings (keyEvent, scope);
if (handled != null && (bool)handled)
{
return true;
}
OnInvokingKeyBindingsContinued = true;
return CancelVirtualMethods;
}
public override bool OnKeyDown (Key keyEvent)
{
if (base.OnKeyDown (keyEvent))
{
return true;
}
OnKeyDownContinued = true;
return CancelVirtualMethods;
}
public override bool OnKeyUp (Key keyEvent)
{
if (base.OnKeyUp (keyEvent))
{
return true;
}
OnKeyUpContinued = true;
return CancelVirtualMethods;
}
public override bool OnProcessKeyDown (Key keyEvent)
{
if (base.OnProcessKeyDown (keyEvent))
{
return true;
}
OnKeyPressedContinued = true;
return CancelVirtualMethods;
}
}
}