//
// ComboBox.cs: ComboBox control
//
// Authors:
// Ross Ferguson (ross.c.ferguson@btinternet.com)
//
using System;
using System.Collections;
using System.Collections.Generic;
using NStack;
namespace Terminal.Gui {
///
/// Provides a drop-down list of items the user can select from.
///
public class ComboBox : View {
IListDataSource source;
///
/// Gets or sets the backing this , enabling custom rendering.
///
/// The source.
///
/// Use to set a new source.
///
public IListDataSource Source {
get => source;
set {
source = value;
// Only need to refresh list if its been added to a container view
if (SuperView != null && SuperView.Subviews.Contains (this)) {
SelectedItem = -1;
search.Text = "";
Search_Changed ("");
SetNeedsDisplay ();
}
}
}
///
/// Sets the source of the to an .
///
/// An object implementing the IList interface.
///
/// Use the property to set a new source and use custome rendering.
///
public void SetSource (IList source)
{
if (source == null) {
Source = null;
} else {
listview.SetSource (source);
Source = listview.Source;
}
}
///
/// This event is raised when the selected item in the has changed.
///
public event Action SelectedItemChanged;
///
/// This event is raised when the user Double Clicks on an item or presses ENTER to open the selected item.
///
public event Action OpenSelectedItem;
readonly IList searchset = new List ();
ustring text = "";
readonly TextField search;
readonly ListView listview;
bool autoHide = true;
int minimumHeight = 2;
///
/// Public constructor
///
public ComboBox () : this (string.Empty)
{
}
///
/// Public constructor
///
///
public ComboBox (ustring text) : base ()
{
search = new TextField ("");
listview = new ListView () { LayoutStyle = LayoutStyle.Computed, CanFocus = true, TabStop = false };
Initialize ();
Text = text;
}
///
/// Public constructor
///
///
///
public ComboBox (Rect rect, IList source) : base (rect)
{
search = new TextField ("") { Width = rect.Width };
listview = new ListView (rect, source) { LayoutStyle = LayoutStyle.Computed, ColorScheme = Colors.Base };
Initialize ();
SetSource (source);
}
private void Initialize ()
{
if (Bounds.Height < minimumHeight && (Height == null || Height is Dim.DimAbsolute)) {
Height = minimumHeight;
}
search.TextChanged += Search_Changed;
listview.Y = Pos.Bottom (search);
listview.OpenSelectedItem += (ListViewItemEventArgs a) => Selected ();
this.Add (search, listview);
// On resize
LayoutComplete += (LayoutEventArgs a) => {
if ((!autoHide && Bounds.Width > 0 && search.Frame.Width != Bounds.Width) ||
(autoHide && Bounds.Width > 0 && search.Frame.Width != Bounds.Width - 1)) {
search.Width = listview.Width = autoHide ? Bounds.Width - 1 : Bounds.Width;
listview.Height = CalculatetHeight ();
search.SetRelativeLayout (Bounds);
listview.SetRelativeLayout (Bounds);
}
};
listview.SelectedItemChanged += (ListViewItemEventArgs e) => {
if (searchset.Count > 0) {
SetValue (searchset [listview.SelectedItem]);
}
};
Added += (View v) => {
// Determine if this view is hosted inside a dialog and is the only control
for (View view = this.SuperView; view != null; view = view.SuperView) {
if (view is Dialog && SuperView != null && SuperView.Subviews.Count == 1 && SuperView.Subviews [0] == this) {
autoHide = false;
break;
}
}
SetNeedsLayout ();
SetNeedsDisplay ();
Search_Changed (Text);
};
// Things this view knows how to do
AddCommand (Command.Accept, () => ActivateSelected ());
AddCommand (Command.ToggleExpandCollapse, () => ExpandCollapse ());
AddCommand (Command.Expand, () => Expand ());
AddCommand (Command.Collapse, () => Collapse ());
AddCommand (Command.LineDown, () => MoveDown ());
AddCommand (Command.LineUp, () => MoveUp ());
AddCommand (Command.PageDown, () => PageDown ());
AddCommand (Command.PageUp, () => PageUp ());
AddCommand (Command.TopHome, () => MoveHome ());
AddCommand (Command.BottomEnd, () => MoveEnd ());
AddCommand (Command.Cancel, () => CancelSelected ());
AddCommand (Command.UnixEmulation, () => UnixEmulation ());
// Default keybindings for this view
AddKeyBinding (Key.Enter, Command.Accept);
AddKeyBinding (Key.F4, Command.ToggleExpandCollapse);
AddKeyBinding (Key.CursorDown, Command.LineDown);
AddKeyBinding (Key.CursorUp, Command.LineUp);
AddKeyBinding (Key.PageDown, Command.PageDown);
AddKeyBinding (Key.PageUp, Command.PageUp);
AddKeyBinding (Key.Home, Command.TopHome);
AddKeyBinding (Key.End, Command.BottomEnd);
AddKeyBinding (Key.Esc, Command.Cancel);
AddKeyBinding (Key.U | Key.CtrlMask, Command.UnixEmulation);
}
private bool isShow = false;
private int selectedItem = -1;
///
/// Gets the index of the currently selected item in the
///
/// The selected item or -1 none selected.
public int SelectedItem {
get => selectedItem;
set {
if (selectedItem != value && (value == -1
|| (source != null && value > -1 && value < source.Count))) {
selectedItem = value;
if (selectedItem != -1) {
SetValue (source.ToList () [selectedItem].ToString (), true);
} else {
SetValue ("", true);
}
OnSelectedChanged ();
}
}
}
///
/// Gets the drop down list state, expanded or collapsed.
///
public bool IsShow => isShow;
///
public new ColorScheme ColorScheme {
get {
return base.ColorScheme;
}
set {
listview.ColorScheme = value;
base.ColorScheme = value;
SetNeedsDisplay ();
}
}
///
///If set to true its not allow any changes in the text.
///
public bool ReadOnly {
get => search.ReadOnly;
set {
search.ReadOnly = value;
if (search.ReadOnly) {
if (search.ColorScheme != null) {
search.ColorScheme.Normal = search.ColorScheme.Focus;
}
}
}
}
///
public override bool MouseEvent (MouseEvent me)
{
if (me.X == Bounds.Right - 1 && me.Y == Bounds.Top && me.Flags == MouseFlags.Button1Pressed
&& autoHide) {
if (isShow) {
isShow = false;
HideList ();
} else {
SetSearchSet ();
isShow = true;
ShowList ();
FocusSelectedItem ();
}
return true;
} else if (me.Flags == MouseFlags.Button1Pressed) {
if (!search.HasFocus) {
search.SetFocus ();
}
return true;
}
return false;
}
private void FocusSelectedItem ()
{
listview.SelectedItem = SelectedItem > -1 ? SelectedItem : 0;
if (SelectedItem > -1) {
listview.TabStop = true;
listview.SetFocus ();
}
}
///
public override bool OnEnter (View view)
{
if (!search.HasFocus && !listview.HasFocus) {
search.SetFocus ();
}
search.CursorPosition = search.Text.RuneCount;
return base.OnEnter (view);
}
///
public override bool OnLeave (View view)
{
if (source?.Count > 0 && selectedItem > -1 && selectedItem < source.Count - 1
&& text != source.ToList () [selectedItem].ToString ()) {
SetValue (source.ToList () [selectedItem].ToString ());
}
if (autoHide && isShow && view != this && view != search && view != listview) {
isShow = false;
HideList ();
} else if (listview.TabStop) {
listview.TabStop = false;
}
return base.OnLeave (view);
}
///
/// Invokes the SelectedChanged event if it is defined.
///
///
public virtual bool OnSelectedChanged ()
{
// Note: Cannot rely on "listview.SelectedItem != lastSelectedItem" because the list is dynamic.
// So we cannot optimize. Ie: Don't call if not changed
SelectedItemChanged?.Invoke (new ListViewItemEventArgs (SelectedItem, search.Text));
return true;
}
///
/// Invokes the OnOpenSelectedItem event if it is defined.
///
///
public virtual bool OnOpenSelectedItem ()
{
var value = search.Text;
OpenSelectedItem?.Invoke (new ListViewItemEventArgs (SelectedItem, value));
return true;
}
///
public override void Redraw (Rect bounds)
{
base.Redraw (bounds);
if (!autoHide) {
return;
}
Move (Bounds.Right - 1, 0);
Driver.AddRune (Driver.DownArrow);
}
///
public override bool ProcessKey (KeyEvent e)
{
var result = InvokeKeybindings (e);
if (result != null)
return (bool)result;
return base.ProcessKey (e);
}
bool UnixEmulation ()
{
// Unix emulation
Reset ();
return true;
}
bool CancelSelected ()
{
search.SetFocus ();
search.Text = text = "";
OnSelectedChanged ();
Collapse ();
return true;
}
bool? MoveEnd ()
{
if (!isShow && search.HasFocus) {
return null;
}
if (HasItems ()) {
listview.MoveEnd ();
}
return true;
}
bool? MoveHome ()
{
if (!isShow && search.HasFocus) {
return null;
}
if (HasItems ()) {
listview.MoveHome ();
}
return true;
}
bool PageUp ()
{
if (HasItems ()) {
listview.MovePageUp ();
}
return true;
}
bool PageDown ()
{
if (HasItems ()) {
listview.MovePageDown ();
}
return true;
}
bool? MoveUp ()
{
if (search.HasFocus) { // stop odd behavior on KeyUp when search has focus
return true;
}
if (listview.HasFocus && listview.SelectedItem == 0 && searchset?.Count > 0) // jump back to search
{
search.CursorPosition = search.Text.RuneCount;
search.SetFocus ();
return true;
}
return null;
}
bool? MoveDown ()
{
if (search.HasFocus) { // jump to list
if (searchset?.Count > 0) {
listview.TabStop = true;
listview.SetFocus ();
SetValue (searchset [listview.SelectedItem]);
} else {
listview.TabStop = false;
SuperView?.FocusNext ();
}
return true;
}
return null;
}
///
/// Toggles the expand/collapse state of the sublist in the combo box
///
///
bool ExpandCollapse ()
{
if (search.HasFocus || listview.HasFocus) {
if (!isShow) {
return Expand ();
} else {
return Collapse ();
}
}
return false;
}
bool ActivateSelected ()
{
if (HasItems ()) {
Selected ();
return true;
}
return false;
}
bool HasItems ()
{
return Source?.Count > 0;
}
///
/// Collapses the drop down list. Returns true if the state chagned or false
/// if it was already collapsed and no action was taken
///
public virtual bool Collapse ()
{
if (!isShow) {
return false;
}
isShow = false;
HideList ();
return true;
}
///
/// Expands the drop down list. Returns true if the state chagned or false
/// if it was already expanded and no action was taken
///
public virtual bool Expand ()
{
if (isShow) {
return false;
}
SetSearchSet ();
isShow = true;
ShowList ();
FocusSelectedItem ();
return true;
}
///
/// The currently selected list item
///
public new ustring Text {
get {
return text;
}
set {
search.Text = text = value;
}
}
private void SetValue (object text, bool isFromSelectedItem = false)
{
search.TextChanged -= Search_Changed;
this.text = search.Text = text.ToString ();
search.CursorPosition = 0;
search.TextChanged += Search_Changed;
if (!isFromSelectedItem) {
selectedItem = GetSelectedItemFromSource (this.text);
OnSelectedChanged ();
}
}
private void Selected ()
{
isShow = false;
listview.TabStop = false;
if (listview.Source.Count == 0 || (searchset?.Count ?? 0) == 0) {
text = "";
HideList ();
return;
}
SetValue (searchset [listview.SelectedItem]);
search.CursorPosition = search.Text.RuneCount;
Search_Changed (search.Text);
OnOpenSelectedItem ();
Reset (keepSearchText: true);
HideList ();
}
private int GetSelectedItemFromSource (ustring value)
{
if (source == null) {
return -1;
}
for (int i = 0; i < source.Count; i++) {
if (source.ToList () [i].ToString () == value) {
return i;
}
}
return -1;
}
///
/// Reset to full original list
///
private void Reset (bool keepSearchText = false)
{
if (!keepSearchText) {
search.Text = text = "";
}
ResetSearchSet ();
listview.SetSource (searchset);
listview.Height = CalculatetHeight ();
if (Subviews.Count > 0) {
search.SetFocus ();
}
}
private void ResetSearchSet (bool noCopy = false)
{
searchset.Clear ();
if (autoHide || noCopy)
return;
SetSearchSet ();
}
private void SetSearchSet ()
{
if (Source == null) { return; }
// force deep copy
foreach (var item in Source.ToList ()) {
searchset.Add (item);
}
}
private void Search_Changed (ustring text)
{
if (source == null) { // Object initialization
return;
}
if (ustring.IsNullOrEmpty (search.Text) && ustring.IsNullOrEmpty (text)) {
ResetSearchSet ();
} else if (search.Text != text) {
isShow = true;
ResetSearchSet (noCopy: true);
foreach (var item in source.ToList ()) { // Iterate to preserver object type and force deep copy
if (item.ToString ().StartsWith (search.Text.ToString (), StringComparison.CurrentCultureIgnoreCase)) {
searchset.Add (item);
}
}
}
ShowList ();
}
///
/// Show the search list
///
///
/// Consider making public
private void ShowList ()
{
listview.SetSource (searchset);
listview.Clear (); // Ensure list shrinks in Dialog as you type
listview.Height = CalculatetHeight ();
this.SuperView?.BringSubviewToFront (this);
}
///
/// Hide the search list
///
///
/// Consider making public
private void HideList ()
{
var rect = listview.ViewToScreen (listview.Bounds);
Reset (SelectedItem > -1);
listview.Clear (rect);
listview.TabStop = false;
SuperView?.SendSubviewToBack (this);
SuperView?.SetNeedsDisplay (rect);
}
///
/// Internal height of dynamic search list
///
///
private int CalculatetHeight ()
{
if (Bounds.Height == 0)
return 0;
return Math.Min (Math.Max (Bounds.Height - 1, minimumHeight - 1), searchset?.Count > 0 ? searchset.Count : isShow ? Math.Max (Bounds.Height - 1, minimumHeight - 1) : 0);
}
}
}