*
* The MIT License (MIT)
*
- * Copyright (C) 2017 Kevin Lamonte
+ * 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"),
private int maxLineWidth;
/**
- * The action to perform when the user selects an item (clicks or enter).
+ * The action to perform when the user selects an item (double-clicks or
+ * enter).
*/
- private TAction enterAction = null;
+ 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.
*/
- private TAction moveAction = null;
+ protected TAction moveAction = null;
// ------------------------------------------------------------------------
// Constructors -----------------------------------------------------------
public TList(final TWidget parent, final List<String> strings, final int x,
final int y, final int width, final int height) {
- this(parent, strings, x, y, width, height, null);
+ this(parent, strings, x, y, width, height, null, null, null);
}
/**
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<String>();
- 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();
+ this(parent, strings, x, y, width, height, enterAction, null, null);
}
/**
final int y, final int width, final int height,
final TAction enterAction, final TAction moveAction) {
+ this(parent, strings, x, y, width, height, enterAction, moveAction,
+ 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
+ * @param moveAction action to perform when the user navigates to a new
+ * item with arrow/page keys
+ * @param singleClickAction action to perform when the user clicks on an
+ * item
+ */
+ public TList(final TWidget parent, final List<String> strings, final int x,
+ final int y, final int width, final int height,
+ final TAction enterAction, final TAction moveAction,
+ final TAction singleClickAction) {
+
super(parent, x, y, width, height);
this.enterAction = enterAction;
this.moveAction = moveAction;
+ this.singleClickAction = singleClickAction;
this.strings = new ArrayList<String>();
if (strings != null) {
this.strings.addAll(strings);
}
if ((mouse.getX() < getWidth() - 1)
- && (mouse.getY() < getHeight() - 1)) {
+ && (mouse.getY() < getHeight() - 1)
+ ) {
if (getVerticalValue() + mouse.getY() < strings.size()) {
selectedString = getVerticalValue() + mouse.getY();
+ dispatchSingleClick();
}
return;
}
@Override
public void onMouseDoubleClick(final TMouseEvent mouse) {
if ((mouse.getX() < getWidth() - 1)
- && (mouse.getY() < getHeight() - 1)) {
+ && (mouse.getY() < getHeight() - 1)
+ ) {
if (getVerticalValue() + mouse.getY() < strings.size()) {
selectedString = getVerticalValue() + mouse.getY();
dispatchEnter();
}
/**
- * Draw the files list.
+ * Draw the list.
*/
@Override
public void draw() {
color = getTheme().getColor("tlist.inactive");
}
String formatString = "%-" + Integer.toString(getWidth() - 1) + "s";
- getScreen().putStringXY(0, topY, String.format(formatString, line),
- color);
+ putStringXY(0, topY, String.format(formatString, line), color);
topY++;
if (topY >= getHeight() - 1) {
break;
// Pad the rest with blank lines
for (int i = topY; i < getHeight() - 1; i++) {
- getScreen().hLineXY(0, i, getWidth() - 1, ' ', color);
+ hLineXY(0, i, getWidth() - 1, ' ', color);
}
}
selectedString = index;
}
+ /**
+ * Get a selectable string by index.
+ *
+ * @param idx index into list
+ * @return the string at idx in the list
+ */
+ public final String getListItem(final int idx) {
+ return strings.get(idx);
+ }
+
/**
* Get the selected string.
*
return strings.size() - 1;
}
+ /**
+ * Get a copy of the list of strings to display.
+ *
+ * @return the list of strings
+ */
+ public final List<String> getList() {
+ return new ArrayList<String>(strings);
+ }
+
/**
* Set the new list of strings to display.
*
}
}
+ /**
+ * Perform single-click action.
+ */
+ public void dispatchSingleClick() {
+ assert (selectedString >= 0);
+ assert (selectedString < strings.size());
+ if (singleClickAction != null) {
+ singleClickAction.DO();
+ }
+ }
+
}