Files
Terminal.Gui/UICatalog/Scenarios/TreeViewFileSystem.cs
Tig dcb3b359ad Fixes #2926 - Refactor KeyEvent and KeyEventEventArgs to simplify (#2927)
* Adds basic MainLoop unit tests

* Remove WinChange action from Curses

* Remove WinChange action from Curses

* Remove ProcessInput action from Windows MainLoop

* Simplified MainLoop/ConsoleDriver by making MainLoop internal and moving impt fns to Application

* Modernized Terminal resize events

* Modernized Terminal resize events

* Removed un used property

* for _isWindowsTerminal devenv->wininit; not sure what changed

* Modernized mouse/keyboard events (Action->EventHandler)

* Updated OnMouseEvent API docs

* Using WT_SESSION to detect WT

* removes hacky GetParentProcess

* Updates to fix #2634 (clear last line)

* removes hacky GetParentProcess2

* Addressed mac resize issue

* Addressed mac resize issue

* Removes ConsoleDriver.PrepareToRun, has Init return MainLoop

* Removes unneeded Attribute methods

* Removed GetProcesssName

* Removed GetProcesssName

* Refactored KeyEvent and KeyEventEventArgs into a single class

* Revert "Refactored KeyEvent and KeyEventEventArgs into a single class"

This reverts commit 88a00658db.

* Fixed key repeat issue; reverted stupidity on 1049/1047 confusion

* Updated CSI API Docs

* merge

* Rearranged Event.cs to Keyboard.cs and Mouse.cs

* Renamed KeyEventEventArgs KeyEventArgs

* temp renamed KeyEvent OldKeyEvent

* Merged KeyEvent into KeyEventArgs

* Renamed Application.ProcessKey members

* Renamed Application.ProcessKey members

* Renamed Application.ProcessKey members

* Added Responder.KeyPressed

* Removed unused references

* Fixed arg naming

* InvokeKeybindings->InvokeKeyBindings

* InvokeKeybindings->InvokeKeyBindings

* Fixed unit tests fail

* More progress on refactoring key input; still broken and probably wrong

* Moved OnKeyPressed out of Responder and made ProcessKeyPrssed non-virtual

* Updated API docs

* Moved key handling from Responder to View

* Updated API docs

* Updated HotKey API docs

* Updated shortcut API docs

* Fixed responder unit tests

* Removed Shortcut from View as it is not used

* Removed unneeded OnHotKey override from Button

* Fixed BackTab logic

* Button now uses Key Bindings exclusively

* Button now uses Key Bindings exclusively

* Updated keyboard.md docs

* Fixed unit tests to account for Toplevel handling default button

* Added View.InvokeCommand API

* Modernized RadioGroup

* Removed ColdKey

* Modernized (partially) StatusBar

* Worked around FileDialog issue with Ctrl-F

* Fixed driver unit test; view must be focused to reciev key pressed

* Application code cleanup

* Start on updaing menu

* Menu now mostly works

* Menu Select refinement

* Fixed known menu bugs!

* Enabled HotKey to cause focus- experimental

* Fixes #3022 & adds unit test to prove it

* Actually Fixes #3022 & adds unit test to prove it

* Working through hotkey issues

* Misc fixes

* removed hot/cold key stuff from Keys scenario

* Fixed scenarios

* Simplified shortcut string handling

* Modernized Checkbox

* Modernized TileView

* Updated API docs

* Updated API docs

* attempting to publish v2 docs

* Revert "attempting to publish v2 docs"

This reverts commit 59dcec111b.

* Playing with api docs

* Removed Key.BackTab

* Removed Caps/Scroll/Numlock

* Partial removal of keymodifiers - unit tests pass

* Partial removal of keymodifiers - broke netdriver somewhere

* WindowsDriver & added KeyEventArgsTests

* Fixing menu shortcut/hotkeys - broke Menu.cs into separate files

* Fixed MenuBar!

* Finished modernizing Menu/MenuBar

* Removed Key.a-z. Broke lots of stuff

* checkout@v4

* progress on key mapping and formatting

* VK tests are still failing

* Fixed some unit tests

* Added Hotkey and Keybinding unit tests

* fixed unit test

* All unit tests pass again...

* Fixed broken unit tests

* KeyEventArgs.KeyValue -> AsRune

* Fixed bugs. Still some broken

* Added KeyEventArgs.IsAlpha. Added KeyEventArgs.cast ops. Fixed bugs. Unit tests pass

* Fixed WindowsDriver

* Oops.

* Refactoring based on bdisp's help. Not complete!

* removed calling into subviews from OnKeyBindings

* removed calling into subviews from OnKeyBindings

* Improved View KeyEvent unit tests

* More hotkey unit tests

* BIg change - Got rid of KeyPress w/in Application/Drivers

* Unit tests now pass again

* Refreshed API docs

* Better HotKey logic. More progress. Getting close.

* Fixed handling of shifted chars like ö

* Minor code cleanup

* Minor code cleanup2

* Why is build Action failing?

* Why is build Action failing??

* upgraded to .net8 to try to fix weird CI/CD build errors

* upgraded to .net8 to try to fix weird CI/CD build errors2

* Disabling TextViewTests to diagnose build errors

* reenable TextViewTests to diagnose build errors

* Arrrrrrg

* Merged v2_develop

* Fixed uppercase accented keys in WindowsDriver

* Fixed key binding api docs

* Experimental impl of CommandScope.SubViews for MenuBar

* Removed dead code from application.cs

* Removed dead code from application.cs

* Removed dead code from ConsoleDriver.cs

* Cleaned up some key binding stuff

* Disabled Alt to activate menu for now

* Updated label commands

* Fixed menu bugs. Upgraded menu unit tests

* Fixed unit tests

* Working on NetDriver

* fixed netdriver

* Fixed issues called out by @bdisp CR

* fixed CursesDriver

* added todo to netdriver

* Cherry picked treeview test fix 1b415e5

* Fix NetDriver.

* CommandScope->KeyBindingScope

* Address some tznind feedback

* Refactored KeyBindings big time!

* Added key consts to KeyEventArgs and renamed Key to ConsoleDriverKey

* Fixed some API docs

* Moved ConsoleDriverKey to ConsoleDriver.cs

* Renamed Key->ConsoleDriverKey

* Renamed Key->ConsoleDriverKey

* Renamed Key->ConsoleDriverKey

* renamed file I forgot to rename before

* Updated name and API docs of KeyEventArgs.isAlpha

* Fixed issues with OnKeyUp not doing the right thing.

* Fixed MainLoop.Running never being used

* Fixed MainLoop.Running never being used - unit tests

* Claned up BUGBUG comments

* Disabled a unit test to see why ci/cd tests are failing

* Removed defunct commented code

* Removed more defunct commented code

* Re-eanbled unit test; jsut removing one test case...

* Disabled more...

* Renambed Global->Applicaton and updated scope API docs

* Disabled more unit tests...

* Removed dead code

* Disabled more unit tests...2

* Disabled more unit tests...3

* Renambed Global->Applicaton and updated scope API docs 2

* Added more KeyBinding scope tests

* Added more KeyBinding scope tests2

* ConsoleDriverKey too long. Key too ambiguous. Settled on KeyCode. (Partialy because eventually I want to intro a class named Key).

* KeyEventArgs improvements. cast to Rune must be explicit as it's lossy

* Fixed warnings

* Renamed KeyEventArgs to Key... progress on fixing broken stuff that resulted

* Fix ConsoleKeyMapping bugs.

* Fix NetDriver issue from converting a lower case to a upper case.

* Started migration to Key from KeyCode - e.g. made HotKeys all consistent.

* Fixed build warnings

* Added key defns to Key

* KeyBindings now uses Key vs. KeyCode

* Verified by tweaking UICatalog

* Fixed treeview test ... again

* Renamed ProcessKeyDown/Up to NewKeyDown/Up and OnKeyPressed to OnProcessKeyDown to make things more clear

* Added test AllViews_KeyDown_All_EventsFire unit tests and fixed a few Views that were wrong

* fixed stupid KeyUp event bug

* If key not handled, return false for datefield

* dotnet test --no-restore --verbosity diag

* dotnet test --blame

* run tests on windows

* Fix TestVKPacket unit test and move it to ConsoleKeyMappingTests.cs file.

* Remove unnecessary commented code.

* Tweaked unit tests and removed Key.BareKey

* Fixed little details and updated api docs

* updated api docs

* AddKeyBindingsForHotKey: KeyCode->Key

* Cleaned up more old KeyCode usages. Added TODOs

---------

Co-authored-by: BDisp <bd.bdisp@gmail.com>
2023-12-16 12:04:23 -07:00

401 lines
13 KiB
C#

using System;
using System.Collections.Generic;
using System.IO;
using System.IO.Abstractions;
using System.Linq;
using System.Text;
using Terminal.Gui;
namespace UICatalog.Scenarios {
[ScenarioMetadata (Name: "File System Explorer", Description: "Hierarchical file system explorer demonstrating TreeView.")]
[ScenarioCategory ("Controls"), ScenarioCategory ("TreeView"), ScenarioCategory ("Files and IO")]
public class TreeViewFileSystem : Scenario {
/// <summary>
/// A tree view where nodes are files and folders
/// </summary>
TreeView<IFileSystemInfo> treeViewFiles;
MenuItem miShowLines;
private MenuItem _miPlusMinus;
private MenuItem _miArrowSymbols;
private MenuItem _miNoSymbols;
private MenuItem _miColoredSymbols;
private MenuItem _miInvertSymbols;
private MenuItem _miBasicIcons;
private MenuItem _miUnicodeIcons;
private MenuItem _miNerdIcons;
private MenuItem _miFullPaths;
private MenuItem _miLeaveLastRow;
private MenuItem _miHighlightModelTextOnly;
private MenuItem _miCustomColors;
private MenuItem _miCursor;
private MenuItem _miMultiSelect;
private DetailsFrame _detailsFrame;
private FileSystemIconProvider _iconProvider = new ();
public override void Setup ()
{
Win.Title = this.GetName ();
Win.Y = 1; // menu
Win.Height = Dim.Fill ();
Application.Top.LayoutSubviews ();
var menu = new MenuBar (new MenuBarItem [] {
new MenuBarItem ("_File", new MenuItem [] {
new MenuItem ("_Quit", $"{Application.QuitKey}", () => Quit()),
}),
new MenuBarItem ("_View", new MenuItem [] {
_miFullPaths = new MenuItem ("_Full Paths", "", () => SetFullName()){Checked = false, CheckType = MenuItemCheckStyle.Checked},
_miMultiSelect = new MenuItem ("_Multi Select", "", () => SetMultiSelect()){Checked = true, CheckType = MenuItemCheckStyle.Checked},
}),
new MenuBarItem ("_Style", new MenuItem [] {
miShowLines = new MenuItem ("_Show Lines", "", () => ShowLines()){
Checked = true, CheckType = MenuItemCheckStyle.Checked
},
null /*separator*/,
_miPlusMinus = new MenuItem ("_Plus Minus Symbols", "+ -", () => SetExpandableSymbols((Rune)'+',(Rune)'-')){Checked = true, CheckType = MenuItemCheckStyle.Radio},
_miArrowSymbols = new MenuItem ("_Arrow Symbols", "> v", () => SetExpandableSymbols((Rune)'>',(Rune)'v')){Checked = false, CheckType = MenuItemCheckStyle.Radio},
_miNoSymbols = new MenuItem ("_No Symbols", "", () => SetExpandableSymbols(default,null)){Checked = false, CheckType = MenuItemCheckStyle.Radio},
null /*separator*/,
_miColoredSymbols = new MenuItem ("_Colored Symbols", "", () => ShowColoredExpandableSymbols()){Checked = false, CheckType = MenuItemCheckStyle.Checked},
_miInvertSymbols = new MenuItem ("_Invert Symbols", "", () => InvertExpandableSymbols()){Checked = false, CheckType = MenuItemCheckStyle.Checked},
null /*separator*/,
_miBasicIcons = new MenuItem ("_Basic Icons",null, SetNoIcons){Checked = false, CheckType = MenuItemCheckStyle.Radio},
_miUnicodeIcons = new MenuItem ("_Unicode Icons", null, SetUnicodeIcons){Checked = false, CheckType = MenuItemCheckStyle.Radio},
_miNerdIcons = new MenuItem ("_Nerd Icons", null, SetNerdIcons){Checked = false, CheckType = MenuItemCheckStyle.Radio},
null /*separator*/,
_miLeaveLastRow = new MenuItem ("_Leave Last Row", "", () => SetLeaveLastRow()){Checked = true, CheckType = MenuItemCheckStyle.Checked},
_miHighlightModelTextOnly = new MenuItem ("_Highlight Model Text Only", "", () => SetCheckHighlightModelTextOnly()){Checked = false, CheckType = MenuItemCheckStyle.Checked},
null /*separator*/,
_miCustomColors = new MenuItem ("C_ustom Colors Hidden Files", "Yellow/Red", () => SetCustomColors()){Checked = false, CheckType = MenuItemCheckStyle.Checked},
null /*separator*/,
_miCursor = new MenuItem ("Curs_or (MultiSelect only)", "", () => SetCursor()){Checked = false, CheckType = MenuItemCheckStyle.Checked},
}),
});
Application.Top.Add (menu);
treeViewFiles = new TreeView<IFileSystemInfo> () {
X = 0,
Y = 0,
Width = Dim.Percent (50),
Height = Dim.Fill (),
};
treeViewFiles.DrawLine += TreeViewFiles_DrawLine;
_detailsFrame = new DetailsFrame (_iconProvider) {
X = Pos.Right (treeViewFiles),
Y = 0,
Width = Dim.Fill (),
Height = Dim.Fill (),
};
Win.Add (_detailsFrame);
treeViewFiles.MouseClick += TreeViewFiles_MouseClick;
treeViewFiles.KeyDown += TreeViewFiles_KeyPress;
treeViewFiles.SelectionChanged += TreeViewFiles_SelectionChanged;
SetupFileTree ();
Win.Add (treeViewFiles);
treeViewFiles.GoToFirst ();
treeViewFiles.Expand ();
SetupScrollBar ();
treeViewFiles.SetFocus ();
UpdateIconCheckedness ();
}
private void SetNoIcons ()
{
_iconProvider.UseUnicodeCharacters = false;
_iconProvider.UseNerdIcons = false;
UpdateIconCheckedness ();
}
private void SetUnicodeIcons ()
{
_iconProvider.UseUnicodeCharacters = true;
UpdateIconCheckedness ();
}
private void SetNerdIcons ()
{
_iconProvider.UseNerdIcons = true;
UpdateIconCheckedness ();
}
private void UpdateIconCheckedness ()
{
_miBasicIcons.Checked = !_iconProvider.UseNerdIcons && !_iconProvider.UseUnicodeCharacters;
_miUnicodeIcons.Checked = _iconProvider.UseUnicodeCharacters;
_miNerdIcons.Checked = _iconProvider.UseNerdIcons;
treeViewFiles.SetNeedsDisplay ();
}
private void TreeViewFiles_SelectionChanged (object sender, SelectionChangedEventArgs<IFileSystemInfo> e)
{
ShowPropertiesOf (e.NewValue);
}
private void TreeViewFiles_DrawLine (object sender, DrawTreeViewLineEventArgs<IFileSystemInfo> e)
{
// Render directory icons in yellow
if (e.Model is IDirectoryInfo d) {
if (_iconProvider.UseNerdIcons || _iconProvider.UseUnicodeCharacters) {
if (e.IndexOfModelText > 0 && e.IndexOfModelText < e.RuneCells.Count) {
var cell = e.RuneCells [e.IndexOfModelText];
cell.ColorScheme = new ColorScheme (
new Terminal.Gui.Attribute (
Color.BrightYellow,
cell.ColorScheme.Normal.Background)
);
}
}
}
}
private void TreeViewFiles_KeyPress (object sender, Key obj)
{
if (obj.KeyCode == (KeyCode.R | KeyCode.CtrlMask)) {
var selected = treeViewFiles.SelectedObject;
// nothing is selected
if (selected == null)
return;
var location = treeViewFiles.GetObjectRow (selected);
//selected object is offscreen or somehow not found
if (location == null || location < 0 || location > treeViewFiles.Frame.Height)
return;
ShowContextMenu (new Point (
5 + treeViewFiles.Frame.X,
location.Value + treeViewFiles.Frame.Y + 2),
selected);
}
}
private void TreeViewFiles_MouseClick (object sender, MouseEventEventArgs obj)
{
// if user right clicks
if (obj.MouseEvent.Flags.HasFlag (MouseFlags.Button3Clicked)) {
var rightClicked = treeViewFiles.GetObjectOnRow (obj.MouseEvent.Y);
// nothing was clicked
if (rightClicked == null)
return;
ShowContextMenu (new Point (
obj.MouseEvent.X + treeViewFiles.Frame.X,
obj.MouseEvent.Y + treeViewFiles.Frame.Y + 2),
rightClicked);
}
}
private void ShowContextMenu (Point screenPoint, IFileSystemInfo forObject)
{
var menu = new ContextMenu ();
menu.Position = screenPoint;
menu.MenuItems = new MenuBarItem (new [] { new MenuItem ("Properties", null, () => ShowPropertiesOf (forObject)) });
Application.Invoke (menu.Show);
}
class DetailsFrame : FrameView {
private IFileSystemInfo fileInfo;
private FileSystemIconProvider _iconProvider;
public DetailsFrame (FileSystemIconProvider iconProvider)
{
Title = "Details";
Visible = true;
CanFocus = true;
_iconProvider = iconProvider;
}
public IFileSystemInfo FileInfo {
get => fileInfo; set {
fileInfo = value;
System.Text.StringBuilder sb = null;
if (fileInfo is IFileInfo f) {
Title = $"{_iconProvider.GetIconWithOptionalSpace (f)}{f.Name}".Trim ();
sb = new System.Text.StringBuilder ();
sb.AppendLine ($"Path:\n {f.FullName}\n");
sb.AppendLine ($"Size:\n {f.Length:N0} bytes\n");
sb.AppendLine ($"Modified:\n {f.LastWriteTime}\n");
sb.AppendLine ($"Created:\n {f.CreationTime}");
}
if (fileInfo is IDirectoryInfo dir) {
Title = $"{_iconProvider.GetIconWithOptionalSpace (dir)}{dir.Name}".Trim ();
sb = new System.Text.StringBuilder ();
sb.AppendLine ($"Path:\n {dir?.FullName}\n");
sb.AppendLine ($"Modified:\n {dir.LastWriteTime}\n");
sb.AppendLine ($"Created:\n {dir.CreationTime}\n");
}
Text = sb.ToString ();
}
}
}
private void ShowPropertiesOf (IFileSystemInfo fileSystemInfo)
{
_detailsFrame.FileInfo = fileSystemInfo;
}
private void SetupScrollBar ()
{
// When using scroll bar leave the last row of the control free (for over-rendering with scroll bar)
treeViewFiles.Style.LeaveLastRow = true;
var scrollBar = new ScrollBarView (treeViewFiles, true);
scrollBar.ChangedPosition += (s, e) => {
treeViewFiles.ScrollOffsetVertical = scrollBar.Position;
if (treeViewFiles.ScrollOffsetVertical != scrollBar.Position) {
scrollBar.Position = treeViewFiles.ScrollOffsetVertical;
}
treeViewFiles.SetNeedsDisplay ();
};
scrollBar.OtherScrollBarView.ChangedPosition += (s, e) => {
treeViewFiles.ScrollOffsetHorizontal = scrollBar.OtherScrollBarView.Position;
if (treeViewFiles.ScrollOffsetHorizontal != scrollBar.OtherScrollBarView.Position) {
scrollBar.OtherScrollBarView.Position = treeViewFiles.ScrollOffsetHorizontal;
}
treeViewFiles.SetNeedsDisplay ();
};
treeViewFiles.DrawContent += (s, e) => {
scrollBar.Size = treeViewFiles.ContentHeight;
scrollBar.Position = treeViewFiles.ScrollOffsetVertical;
scrollBar.OtherScrollBarView.Size = treeViewFiles.GetContentWidth (true);
scrollBar.OtherScrollBarView.Position = treeViewFiles.ScrollOffsetHorizontal;
scrollBar.Refresh ();
};
}
private void SetupFileTree ()
{
// setup how to build tree
var fs = new FileSystem ();
var rootDirs = DriveInfo.GetDrives ().Select (d => fs.DirectoryInfo.New (d.RootDirectory.FullName));
treeViewFiles.TreeBuilder = new FileSystemTreeBuilder ();
treeViewFiles.AddObjects (rootDirs);
// Determines how to represent objects as strings on the screen
treeViewFiles.AspectGetter = AspectGetter;
_iconProvider.IsOpenGetter = treeViewFiles.IsExpanded;
}
private string AspectGetter (IFileSystemInfo f)
{
return (_iconProvider.GetIconWithOptionalSpace (f) + f.Name).Trim ();
}
private void ShowLines ()
{
miShowLines.Checked = !miShowLines.Checked;
treeViewFiles.Style.ShowBranchLines = (bool)miShowLines.Checked;
treeViewFiles.SetNeedsDisplay ();
}
private void SetExpandableSymbols (Rune expand, Rune? collapse)
{
_miPlusMinus.Checked = expand.Value == '+';
_miArrowSymbols.Checked = expand.Value == '>';
_miNoSymbols.Checked = expand.Value == default;
treeViewFiles.Style.ExpandableSymbol = expand;
treeViewFiles.Style.CollapseableSymbol = collapse;
treeViewFiles.SetNeedsDisplay ();
}
private void ShowColoredExpandableSymbols ()
{
_miColoredSymbols.Checked = !_miColoredSymbols.Checked;
treeViewFiles.Style.ColorExpandSymbol = (bool)_miColoredSymbols.Checked;
treeViewFiles.SetNeedsDisplay ();
}
private void InvertExpandableSymbols ()
{
_miInvertSymbols.Checked = !_miInvertSymbols.Checked;
treeViewFiles.Style.InvertExpandSymbolColors = (bool)_miInvertSymbols.Checked;
treeViewFiles.SetNeedsDisplay ();
}
private void SetFullName ()
{
_miFullPaths.Checked = !_miFullPaths.Checked;
if (_miFullPaths.Checked == true) {
treeViewFiles.AspectGetter = (f) => f.FullName;
} else {
treeViewFiles.AspectGetter = (f) => f.Name;
}
treeViewFiles.SetNeedsDisplay ();
}
private void SetLeaveLastRow ()
{
_miLeaveLastRow.Checked = !_miLeaveLastRow.Checked;
treeViewFiles.Style.LeaveLastRow = (bool)_miLeaveLastRow.Checked;
}
private void SetCursor ()
{
_miCursor.Checked = !_miCursor.Checked;
treeViewFiles.DesiredCursorVisibility = _miCursor.Checked == true ? CursorVisibility.Default : CursorVisibility.Invisible;
}
private void SetMultiSelect ()
{
_miMultiSelect.Checked = !_miMultiSelect.Checked;
treeViewFiles.MultiSelect = (bool)_miMultiSelect.Checked;
}
private void SetCustomColors ()
{
var hidden = new ColorScheme {
Focus = new Terminal.Gui.Attribute (Color.BrightRed, treeViewFiles.ColorScheme.Focus.Background),
Normal = new Terminal.Gui.Attribute (Color.BrightYellow, treeViewFiles.ColorScheme.Normal.Background),
};
_miCustomColors.Checked = !_miCustomColors.Checked;
if (_miCustomColors.Checked == true) {
treeViewFiles.ColorGetter = (m) => {
if (m is IDirectoryInfo && m.Attributes.HasFlag (FileAttributes.Hidden)) return hidden;
if (m is IFileInfo && m.Attributes.HasFlag (FileAttributes.Hidden)) return hidden;
return null;
};
} else {
treeViewFiles.ColorGetter = null;
}
treeViewFiles.SetNeedsDisplay ();
}
private void SetCheckHighlightModelTextOnly ()
{
treeViewFiles.Style.HighlightModelTextOnly = !treeViewFiles.Style.HighlightModelTextOnly;
_miHighlightModelTextOnly.Checked = treeViewFiles.Style.HighlightModelTextOnly;
treeViewFiles.SetNeedsDisplay ();
}
private void Quit ()
{
Application.RequestStop ();
}
}
}