X-Git-Url: http://git.nikiroo.be/?a=blobdiff_plain;f=src%2Fjexer%2FTList.java;h=38a994c8215bbba2a53e3c85d0b15bd46c099146;hb=738dd8c426dcc6ed2508d68b7985f68d66549889;hp=da60af18745737dbc5ed5ecaf7d3a9a08730f430;hpb=a69ed767c9c07cf35cf1c5f7821fc009cfe79cd2;p=nikiroo-utils.git diff --git a/src/jexer/TList.java b/src/jexer/TList.java deleted file mode 100644 index da60af1..0000000 --- a/src/jexer/TList.java +++ /dev/null @@ -1,483 +0,0 @@ -/* - * Jexer - Java Text User Interface - * - * The MIT License (MIT) - * - * Copyright (C) 2019 Kevin Lamonte - * - * Permission is hereby granted, free of charge, to any person obtaining a - * copy of this software and associated documentation files (the "Software"), - * to deal in the Software without restriction, including without limitation - * the rights to use, copy, modify, merge, publish, distribute, sublicense, - * and/or sell copies of the Software, and to permit persons to whom the - * Software is furnished to do so, subject to the following conditions: - * - * The above copyright notice and this permission notice shall be included in - * all copies or substantial portions of the Software. - * - * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR - * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, - * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL - * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER - * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING - * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER - * DEALINGS IN THE SOFTWARE. - * - * @author Kevin Lamonte [kevin.lamonte@gmail.com] - * @version 1 - */ -package jexer; - -import java.util.ArrayList; -import java.util.Collections; -import java.util.List; - -import jexer.bits.CellAttributes; -import jexer.event.TKeypressEvent; -import jexer.event.TMouseEvent; -import static jexer.TKeypress.*; - -/** - * TList shows a list of strings, and lets the user select one. - */ -public class TList extends TScrollableWidget { - - // ------------------------------------------------------------------------ - // Variables -------------------------------------------------------------- - // ------------------------------------------------------------------------ - - /** - * The list of strings to display. - */ - private List strings; - - /** - * Selected string. - */ - private int selectedString = -1; - - /** - * Maximum width of a single line. - */ - private int maxLineWidth; - - /** - * The action to perform when the user selects an item (double-clicks or - * enter). - */ - protected TAction enterAction = null; - - /** - * The action to perform when the user selects an item (single-click). - */ - protected TAction singleClickAction = null; - - /** - * The action to perform when the user navigates with keyboard. - */ - protected TAction moveAction = null; - - // ------------------------------------------------------------------------ - // Constructors ----------------------------------------------------------- - // ------------------------------------------------------------------------ - - /** - * Public constructor. - * - * @param parent parent widget - * @param strings list of strings to show - * @param x column relative to parent - * @param y row relative to parent - * @param width width of text area - * @param height height of text area - */ - public TList(final TWidget parent, final List strings, final int x, - final int y, final int width, final int height) { - - this(parent, strings, x, y, width, height, null); - } - - /** - * Public constructor. - * - * @param parent parent widget - * @param strings list of strings to show. This is allowed to be null - * and set later with setList() or by subclasses. - * @param x column relative to parent - * @param y row relative to parent - * @param width width of text area - * @param height height of text area - * @param enterAction action to perform when an item is selected - */ - public TList(final TWidget parent, final List strings, final int x, - final int y, final int width, final int height, - final TAction enterAction) { - - super(parent, x, y, width, height); - this.enterAction = enterAction; - this.strings = new ArrayList(); - if (strings != null) { - this.strings.addAll(strings); - } - - hScroller = new THScroller(this, 0, getHeight() - 1, getWidth() - 1); - vScroller = new TVScroller(this, getWidth() - 1, 0, getHeight() - 1); - reflowData(); - } - - /** - * Public constructor. - * - * @param parent parent widget - * @param strings list of strings to show. This is allowed to be null - * and set later with setList() or by subclasses. - * @param x column relative to parent - * @param y row relative to parent - * @param width width of text area - * @param height height of text area - * @param enterAction action to perform when an item is selected - * @param moveAction action to perform when the user navigates to a new - * item with arrow/page keys - */ - public TList(final TWidget parent, final List strings, final int x, - final int y, final int width, final int height, - final TAction enterAction, final TAction moveAction) { - - super(parent, x, y, width, height); - this.enterAction = enterAction; - this.moveAction = moveAction; - this.strings = new ArrayList(); - if (strings != null) { - this.strings.addAll(strings); - } - - hScroller = new THScroller(this, 0, getHeight() - 1, getWidth() - 1); - vScroller = new TVScroller(this, getWidth() - 1, 0, getHeight() - 1); - reflowData(); - } - - // ------------------------------------------------------------------------ - // Event handlers --------------------------------------------------------- - // ------------------------------------------------------------------------ - - /** - * Handle mouse press events. - * - * @param mouse mouse button press event - */ - @Override - public void onMouseDown(final TMouseEvent mouse) { - if (mouse.isMouseWheelUp()) { - verticalDecrement(); - return; - } - if (mouse.isMouseWheelDown()) { - verticalIncrement(); - return; - } - - if ((mouse.getX() < getWidth() - 1) - && (mouse.getY() < getHeight() - 1) - ) { - if (getVerticalValue() + mouse.getY() < strings.size()) { - selectedString = getVerticalValue() + mouse.getY(); - dispatchSingleClick(); - } - return; - } - - // Pass to children - super.onMouseDown(mouse); - } - - /** - * Handle mouse double click. - * - * @param mouse mouse double click event - */ - @Override - public void onMouseDoubleClick(final TMouseEvent mouse) { - if ((mouse.getX() < getWidth() - 1) - && (mouse.getY() < getHeight() - 1) - ) { - if (getVerticalValue() + mouse.getY() < strings.size()) { - selectedString = getVerticalValue() + mouse.getY(); - dispatchEnter(); - } - return; - } - - // Pass to children - super.onMouseDoubleClick(mouse); - } - - /** - * Handle keystrokes. - * - * @param keypress keystroke event - */ - @Override - public void onKeypress(final TKeypressEvent keypress) { - if (keypress.equals(kbLeft)) { - horizontalDecrement(); - } else if (keypress.equals(kbRight)) { - horizontalIncrement(); - } else if (keypress.equals(kbUp)) { - if (strings.size() > 0) { - if (selectedString >= 0) { - if (selectedString > 0) { - if (selectedString - getVerticalValue() == 0) { - verticalDecrement(); - } - selectedString--; - } - } else { - selectedString = strings.size() - 1; - } - } - if (selectedString >= 0) { - dispatchMove(); - } - } else if (keypress.equals(kbDown)) { - if (strings.size() > 0) { - if (selectedString >= 0) { - if (selectedString < strings.size() - 1) { - selectedString++; - if (selectedString - getVerticalValue() == getHeight() - 1) { - verticalIncrement(); - } - } - } else { - selectedString = 0; - } - } - if (selectedString >= 0) { - dispatchMove(); - } - } else if (keypress.equals(kbPgUp)) { - bigVerticalDecrement(); - if (selectedString >= 0) { - selectedString -= getHeight() - 1; - if (selectedString < 0) { - selectedString = 0; - } - } - if (selectedString >= 0) { - dispatchMove(); - } - } else if (keypress.equals(kbPgDn)) { - bigVerticalIncrement(); - if (selectedString >= 0) { - selectedString += getHeight() - 1; - if (selectedString > strings.size() - 1) { - selectedString = strings.size() - 1; - } - } - if (selectedString >= 0) { - dispatchMove(); - } - } else if (keypress.equals(kbHome)) { - toTop(); - if (strings.size() > 0) { - selectedString = 0; - } - if (selectedString >= 0) { - dispatchMove(); - } - } else if (keypress.equals(kbEnd)) { - toBottom(); - if (strings.size() > 0) { - selectedString = strings.size() - 1; - } - if (selectedString >= 0) { - dispatchMove(); - } - } else if (keypress.equals(kbTab)) { - getParent().switchWidget(true); - } else if (keypress.equals(kbShiftTab) || keypress.equals(kbBackTab)) { - getParent().switchWidget(false); - } else if (keypress.equals(kbEnter)) { - if (selectedString >= 0) { - dispatchEnter(); - } - } else { - // Pass other keys (tab etc.) on - super.onKeypress(keypress); - } - } - - // ------------------------------------------------------------------------ - // TScrollableWidget ------------------------------------------------------ - // ------------------------------------------------------------------------ - - /** - * Resize for a new width/height. - */ - @Override - public void reflowData() { - - // Reset the lines - selectedString = -1; - maxLineWidth = 0; - - for (int i = 0; i < strings.size(); i++) { - String line = strings.get(i); - if (line.length() > maxLineWidth) { - maxLineWidth = line.length(); - } - } - - setBottomValue(strings.size() - getHeight() + 1); - if (getBottomValue() < 0) { - setBottomValue(0); - } - - setRightValue(maxLineWidth - getWidth() + 1); - if (getRightValue() < 0) { - setRightValue(0); - } - } - - /** - * Draw the list. - */ - @Override - public void draw() { - CellAttributes color = null; - int begin = getVerticalValue(); - int topY = 0; - for (int i = begin; i < strings.size(); i++) { - String line = strings.get(i); - if (getHorizontalValue() < line.length()) { - line = line.substring(getHorizontalValue()); - } else { - line = ""; - } - if (i == selectedString) { - if (isAbsoluteActive()) { - color = getTheme().getColor("tlist.selected"); - } else { - color = getTheme().getColor("tlist.selected.inactive"); - } - } else if (isAbsoluteActive()) { - color = getTheme().getColor("tlist"); - } else { - color = getTheme().getColor("tlist.inactive"); - } - String formatString = "%-" + Integer.toString(getWidth() - 1) + "s"; - putStringXY(0, topY, String.format(formatString, line), color); - topY++; - if (topY >= getHeight() - 1) { - break; - } - } - - if (isAbsoluteActive()) { - color = getTheme().getColor("tlist"); - } else { - color = getTheme().getColor("tlist.inactive"); - } - - // Pad the rest with blank lines - for (int i = topY; i < getHeight() - 1; i++) { - hLineXY(0, i, getWidth() - 1, ' ', color); - } - } - - // ------------------------------------------------------------------------ - // TList ------------------------------------------------------------------ - // ------------------------------------------------------------------------ - - /** - * Get the selection index. - * - * @return -1 if nothing is selected, otherwise the index into the list - */ - public final int getSelectedIndex() { - return selectedString; - } - - /** - * Set the selected string index. - * - * @param index -1 to unselect, otherwise the index into the list - */ - public final void setSelectedIndex(final int index) { - selectedString = index; - } - - /** - * Get the selected string. - * - * @return the selected string, or null of nothing is selected yet - */ - public final String getSelected() { - if ((selectedString >= 0) && (selectedString <= strings.size() - 1)) { - return strings.get(selectedString); - } - return null; - } - - /** - * Get the maximum selection index value. - * - * @return -1 if the list is empty - */ - public final int getMaxSelectedIndex() { - return strings.size() - 1; - } - - /** - * Get a copy of the list of strings to display. - * - * @return the list of strings - */ - public final List getList() { - return new ArrayList(strings); - } - - /** - * Set the new list of strings to display. - * - * @param list new list of strings - */ - public final void setList(final List list) { - strings.clear(); - strings.addAll(list); - reflowData(); - } - - /** - * Perform user selection action. - */ - public void dispatchEnter() { - assert (selectedString >= 0); - assert (selectedString < strings.size()); - if (enterAction != null) { - enterAction.DO(); - } - } - - /** - * Perform list movement action. - */ - public void dispatchMove() { - assert (selectedString >= 0); - assert (selectedString < strings.size()); - if (moveAction != null) { - moveAction.DO(); - } - } - - /** - * Perform single-click action. - */ - public void dispatchSingleClick() { - assert (selectedString >= 0); - assert (selectedString < strings.size()); - if (singleClickAction != null) { - singleClickAction.DO(); - } - } - -}