namespace Terminal.Gui;
///
/// Represents the "inside part" of a scroll bar, minus the arrows.
///
public class Scroll : View
{
///
public Scroll ()
{
WantContinuousButtonPressed = true;
CanFocus = false;
Orientation = Orientation.Vertical;
Width = Dim.Auto (DimAutoStyle.Content, 1);
Height = Dim.Auto (DimAutoStyle.Content, 1);
_slider = new ()
{
Id = "slider",
Width = Dim.Auto (DimAutoStyle.Content),
Height = Dim.Auto (DimAutoStyle.Content)
};
Add (_slider);
Added += Scroll_Added;
Removed += Scroll_Removed;
Initialized += Scroll_Initialized;
DrawContent += Scroll_DrawContent;
MouseEvent += Scroll_MouseEvent;
_slider.DrawContent += Scroll_DrawContent;
_slider.MouseEvent += Slider_MouseEvent;
}
private readonly View _slider;
private int _lastLocation = -1;
private bool _wasSliderMouse;
private Orientation _orientation;
///
/// Determines the Orientation of the scroll.
///
public Orientation Orientation
{
get => _orientation;
set
{
_orientation = value;
AdjustSlider();
}
}
private int _position;
///
/// The position, relative to , to set the scrollbar at.
///
public int Position
{
get => _position;
set
{
int barSize = Orientation == Orientation.Vertical ? ContentSize.Height : ContentSize.Width;
if (value < 0 || (value > 0 && value + barSize > Size))
{
return;
}
StateEventArgs args = OnPositionChanging (_position, value);
if (args.Cancel)
{
return;
}
int oldPos = _position;
_position = value;
OnPositionChanged (oldPos);
if (!_wasSliderMouse)
{
AdjustSlider ();
}
}
}
/// This event is raised when the position on the scrollbar has changed.
public event EventHandler> PositionChanged;
/// This event is raised when the position on the scrollbar is changing.
public event EventHandler> PositionChanging;
private int _size;
///
/// The size of content the scroll represents.
///
public int Size
{
get => _size;
set
{
int oldSize = _size;
_size = value;
OnSizeChanged (oldSize);
AdjustSlider ();
}
}
/// This event is raised when the size of the scroll has changed.
public event EventHandler> SizeChanged;
///
protected override void Dispose (bool disposing)
{
Added -= Scroll_Added;
Initialized -= Scroll_Initialized;
DrawContent -= Scroll_DrawContent;
MouseEvent -= Scroll_MouseEvent;
_slider.DrawContent -= Scroll_DrawContent;
_slider.MouseEvent -= Slider_MouseEvent;
base.Dispose (disposing);
}
/// Virtual method to invoke the event handler.
protected virtual void OnPositionChanged (int oldPos) { PositionChanged?.Invoke (this, new (oldPos, Position)); }
/// Virtual method to invoke the cancelable event handler.
protected virtual StateEventArgs OnPositionChanging (int oldPos, int newPos)
{
StateEventArgs args = new (oldPos, newPos);
PositionChanging?.Invoke (this, args);
return args;
}
/// Virtual method to invoke the event handler.
protected void OnSizeChanged (int oldSize) { SizeChanged?.Invoke (this, new (oldSize, Size)); }
private int GetPositionFromSliderLocation (int location)
{
if (ContentSize.Height == 0 || ContentSize.Width == 0)
{
return 0;
}
int barSize = Orientation == Orientation.Vertical ? ContentSize.Height : ContentSize.Width;
// Ensure the Position is valid if the slider is at end
if ((Orientation == Orientation.Vertical && location + _slider.Frame.Height == barSize)
|| (Orientation == Orientation.Horizontal && location + _slider.Frame.Width == barSize))
{
return Size - barSize;
}
return Math.Min (location * Size / barSize, Size - barSize);
}
private (int Location, int Dimension) GetSliderLocationDimensionFromPosition ()
{
if (ContentSize.Height == 0 || ContentSize.Width == 0)
{
return new (0, 0);
}
int barSize = Orientation == Orientation.Vertical ? ContentSize.Height : ContentSize.Width;
int location;
int dimension;
if (Size > 0)
{
dimension = Math.Min (Math.Max (barSize * barSize / Size, 1), barSize);
// Ensure the Position is valid
if (Position > 0 && Position + barSize > Size)
{
Position = Size - barSize;
}
location = Math.Min (Position * barSize / Size, barSize - dimension);
if (Position == Size - barSize && location + dimension < barSize)
{
location = barSize - dimension;
}
}
else
{
location = 0;
dimension = barSize;
}
return new (location, dimension);
}
private void Parent_LayoutComplete (object sender, LayoutEventArgs e)
{
if (!_wasSliderMouse)
{
AdjustSlider ();
}
else
{
_wasSliderMouse = false;
}
}
private void Parent_MouseEnter (object sender, MouseEventEventArgs e) { OnMouseEnter (e.MouseEvent); }
private void Parent_MouseLeave (object sender, MouseEventEventArgs e) { OnMouseLeave (e.MouseEvent); }
private void Scroll_Added (object sender, SuperViewChangedEventArgs e)
{
View parent = e.Parent is Adornment adornment ? adornment.Parent : e.Parent;
parent.LayoutComplete += Parent_LayoutComplete;
parent.MouseEnter += Parent_MouseEnter;
parent.MouseLeave += Parent_MouseLeave;
}
private void Scroll_DrawContent (object sender, DrawEventArgs e) { SetColorSchemeWithSuperview (sender as View); }
private void Scroll_Initialized (object sender, EventArgs e)
{
AdjustSlider ();
}
private void Scroll_MouseEvent (object sender, MouseEventEventArgs e)
{
MouseEvent me = e.MouseEvent;
int location = Orientation == Orientation.Vertical ? me.Position.Y : me.Position.X;
int barSize = Orientation == Orientation.Vertical ? ContentSize.Height : ContentSize.Width;
(int topLeft, int bottomRight) sliderPos = _orientation == Orientation.Vertical
? new (_slider.Frame.Y, _slider.Frame.Bottom - 1)
: new (_slider.Frame.X, _slider.Frame.Right - 1);
if (me.Flags == MouseFlags.Button1Pressed && location < sliderPos.topLeft)
{
Position = Math.Max (Position - barSize, 0);
}
else if (me.Flags == MouseFlags.Button1Pressed && location > sliderPos.bottomRight)
{
Position = Math.Min (Position + barSize, Size - barSize);
}
else if ((me.Flags == MouseFlags.WheeledDown && Orientation == Orientation.Vertical)
|| (me.Flags == MouseFlags.WheeledRight && Orientation == Orientation.Horizontal))
{
Position = Math.Min (Position + 1, Size - barSize);
}
else if ((me.Flags == MouseFlags.WheeledUp && Orientation == Orientation.Vertical)
|| (me.Flags == MouseFlags.WheeledLeft && Orientation == Orientation.Horizontal))
{
Position = Math.Max (Position - 1, 0);
}
}
private void Scroll_Removed (object sender, SuperViewChangedEventArgs e)
{
if (e.Parent is { })
{
View parent = e.Parent is Adornment adornment ? adornment.Parent : e.Parent;
parent.LayoutComplete -= Parent_LayoutComplete;
parent.MouseEnter -= Parent_MouseEnter;
parent.MouseLeave -= Parent_MouseLeave;
}
}
// TODO: Just override GetNormalColor instead of having this method
private static void SetColorSchemeWithSuperview (View view)
{
if (view.SuperView is { })
{
View parent = view.SuperView is Adornment adornment ? adornment.Parent : view.SuperView;
if (view.Id == "slider")
{
view.ColorScheme = new () { Normal = new (parent.ColorScheme.Normal.Foreground, parent.ColorScheme.Normal.Foreground) };
}
else
{
view.ColorScheme = parent.ColorScheme;
}
}
}
private void SetSliderText ()
{
TextDirection = Orientation == Orientation.Vertical ? TextDirection.TopBottom_LeftRight : TextDirection.LeftRight_TopBottom;
Text = string.Concat (
Enumerable.Repeat (
Glyphs.Stipple.ToString (),
ContentSize.Width * ContentSize.Height));
_slider.TextDirection = Orientation == Orientation.Vertical ? TextDirection.TopBottom_LeftRight : TextDirection.LeftRight_TopBottom;
_slider.Text = string.Concat (
Enumerable.Repeat (
Glyphs.ContinuousMeterSegment.ToString (),
_slider.ContentSize.Width * _slider.ContentSize.Height));
}
private void AdjustSlider ()
{
if (!IsInitialized)
{
return;
}
(int Location, int Dimension) slider = GetSliderLocationDimensionFromPosition ();
_slider.X = Orientation == Orientation.Vertical ? 0 : slider.Location;
_slider.Y = Orientation == Orientation.Vertical ? slider.Location : 0;
_slider.SetContentSize (
new (
Orientation == Orientation.Vertical ? ContentSize.Width : slider.Dimension,
Orientation == Orientation.Vertical ? slider.Dimension : ContentSize.Height
));
SetSliderText ();
}
private void Slider_MouseEvent (object sender, MouseEventEventArgs e)
{
MouseEvent me = e.MouseEvent;
int location = Orientation == Orientation.Vertical ? me.Position.Y : me.Position.X;
int barSize = Orientation == Orientation.Vertical ? ContentSize.Height : ContentSize.Width;
int offset = _lastLocation > -1 ? location - _lastLocation : 0;
if (me.Flags == MouseFlags.Button1Pressed)
{
if (Application.MouseGrabView != sender as View)
{
Application.GrabMouse (sender as View);
_lastLocation = location;
}
}
else if (me.Flags == (MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition))
{
if (Orientation == Orientation.Vertical)
{
if (_slider.Frame.Y + offset >= 0 && _slider.Frame.Y + offset + _slider.Frame.Height <= barSize)
{
_wasSliderMouse = true;
_slider.Y = _slider.Frame.Y + offset;
Position = GetPositionFromSliderLocation (_slider.Frame.Y);
}
}
else
{
if (_slider.Frame.X + offset >= 0 && _slider.Frame.X + offset + _slider.Frame.Width <= barSize)
{
_wasSliderMouse = true;
_slider.X = _slider.Frame.X + offset;
Position = GetPositionFromSliderLocation (_slider.Frame.X);
}
}
}
else if (me.Flags == MouseFlags.Button1Released)
{
_lastLocation = -1;
if (Application.MouseGrabView == sender as View)
{
Application.UngrabMouse ();
}
}
else if ((me.Flags == MouseFlags.WheeledDown && Orientation == Orientation.Vertical)
|| (me.Flags == MouseFlags.WheeledRight && Orientation == Orientation.Horizontal))
{
Position = Math.Min (Position + 1, Size - barSize);
}
else if ((me.Flags == MouseFlags.WheeledUp && Orientation == Orientation.Vertical)
|| (me.Flags == MouseFlags.WheeledLeft && Orientation == Orientation.Horizontal))
{
Position = Math.Max (Position - 1, 0);
}
else
{
return;
}
e.Handled = true;
}
}