heronarts.p3lx.ui.component

Class UIItemList.BasicList

java.lang.Object

heronarts.p3lx.ui.UIEventHandler

heronarts.p3lx.ui.UIObject

heronarts.p3lx.ui.UI2dComponent

heronarts.p3lx.ui.UI2dContainer

heronarts.p3lx.ui.component.UIItemList.BasicList

All Implemented Interfaces:

LXLoopTask, UIItemList, UIContainer, UIFocus, UIKeyFocus, UIMouseFocus, UITabFocus, Iterable<UIObject>

Enclosing interface:

UIItemList

public static class UIItemList.BasicList
extends UI2dContainer
implements UIItemList, UIFocus

Nested Class Summary

Nested classes/interfaces inherited from class heronarts.p3lx.ui.UI2dContainer

UI2dContainer.ArrowKeyFocus, UI2dContainer.Layout

Nested classes/interfaces inherited from interface heronarts.p3lx.ui.component.UIItemList

UIItemList.BasicList, UIItemList.Impl, UIItemList.Item, UIItemList.Listener, UIItemList.ScrollList, UIItemList.Section

Field Summary

Fields inherited from class heronarts.p3lx.ui.UI2dComponent

bottomMargin, height, leftMargin, rightMargin, textAlignHorizontal, textAlignVertical, textOffsetX, textOffsetY, topMargin, width, x, y

Fields inherited from class heronarts.p3lx.ui.UIObject

children, hasFocus, mousePressContextMenu, visible

Constructor Summary

Constructors

Constructor and Description
BasicList(UI ui, float x, float y, float w, float h)

Method Summary

Modifier and Type	Method and Description
UIItemList	addItem(int index, UIItemList.Item item) Adds an item to the list at the given index
UIItemList	addItem(UIItemList.Item item) Adds an item to the list
UIItemList	addListener(UIItemList.Listener listener) Adds a listener to receive notifications about list operations
UIItemList	addSection(UIItemList.Section section) Add a section to the list
UIItemList	clearItems() Clears all items in the list
void	drawFocus(UI ui, PGraphics pg) Draws focus on this object.
int	getFocusedIndex() Returns the index of the currently focused item in the list
UIItemList.Item	getFocusedItem() Retrieves the currently focused item in the list.
List<? extends UIItemList.Item>	getItems() Get the items in the list
UIItemList	moveItem(UIItemList.Item item, int index) Moves an item to another location in the list
void	onBlur() Subclasses override when element loses focus
void	onDraw(UI ui, PGraphics pg) Subclasses should override this method to perform their drawing functions.
void	onFocus(Event event) Subclasses override when element is focused
void	onKeyPressed(KeyEvent keyEvent, char keyChar, int keyCode) Subclasses override to receive key events
void	onKeyReleased(KeyEvent keyEvent, char keyChar, int keyCode) Subclasses override to receive key events
void	onMouseClicked(MouseEvent mouseEvent, float mx, float my) Subclasses override to receive mouse events
void	onMouseDragged(MouseEvent mouseEvent, float mx, float my, float dx, float dy) Subclasses override to receive mouse events
void	onMousePressed(MouseEvent mouseEvent, float mx, float my) Subclasses override to receive mouse events
void	onMouseReleased(MouseEvent mouseEvent, float mx, float my) Subclasses override to receive mouse events
UIItemList	removeItem(UIItemList.Item item) Removes an item from the list
UIItemList	removeListener(UIItemList.Listener listener) Removes a listener from receiving notifications about list operations
UIItemList	setControlSurfaceFocus(int index, int length) Sets a control focus range that is highlighted in the list
UIItemList	setFocusIndex(int focusIndex) Sets the index of the focused item in the list.
UIItemList	setItems(List<? extends UIItemList.Item> items) Sets the items in the list and redraws it
UIItemList	setMomentary(boolean momentary) Sets whether the item list is momentary.
UIItemList	setRenamable(boolean isRenamable) Sets whether renaming items is allowed
UIItemList	setReorderable(boolean reorderable) Sets whether the list is reorderable.
UIItemList	setShowCheckboxes(boolean showCheckboxes) Sets whether a column of checkboxes should be shown on the item list, to the left of the labels.
UIItemList	setSingleClickActivate(boolean singleClickActivate) Sets whether single-clicks on an item should activate them.

Methods inherited from class heronarts.p3lx.ui.UI2dContainer

addChildren, addTopLevelComponent, getChild, getChildren, getContentHeight, getContentTarget, getContentWidth, iterator, newHorizontalContainer, newHorizontalContainer, newHorizontalContainer, newVerticalContainer, newVerticalContainer, newVerticalContainer, reflow, removeAllChildren, setArrowKeyFocus, setChildMargin, setChildSpacing, setChildSpacing, setContentHeight, setContentSize, setContentTarget, setContentWidth, setLayout, setMinHeight, setMinWidth, setPadding, setPadding, setPadding

Methods inherited from class heronarts.p3lx.ui.UI2dComponent

addToContainer, addToContainer, breakTextToWidth, clipTextToWidth, contains, drawBackground, drawBorder, drawFocusCorners, drawFocusCorners, getBackgroundColor, getBorderColor, getBorderRounding, getBorderWeight, getContainer, getFocusColor, getFocusSize, getFont, getFontColor, getHeight, getNextSibling, getParent, getPrevSibling, getWidth, getX, getY, hasBackground, hasBorder, hasFont, hasFontColor, isMappable, onResize, redraw, removeFromContainer, setBackground, setBackgroundColor, setBorder, setBorderColor, setBorderRounding, setBorderWeight, setBottomMargin, setContainerIndex, setDescription, setFocusBackground, setFocusBackgroundColor, setFocusColor, setFocusCorners, setFont, setFontColor, setFontColor, setHeight, setLeftMargin, setMappable, setMargin, setMargin, setMargin, setPosition, setPosition, setPosition, setPosition, setRightMargin, setSize, setTextAlignment, setTextAlignment, setTextOffset, setTopMargin, setVisible, setWidth, setX, setY

Methods inherited from class heronarts.p3lx.ui.UIObject

addLoopTask, beginDraw, blur, bringToFront, consumeKeyEvent, consumeMousePress, consumeMouseWheelEvent, endDraw, focus, getDescription, getFocusedChild, getLX, getUI, hasDirectFocus, hasFocus, isVisible, keyEventConsumed, loop, mousePressConsumed, onUIResize, removeLoopTask, toggleVisible

Methods inherited from class heronarts.p3lx.ui.UIEventHandler

onKeyTyped, onMouseMoved, onMouseOut, onMouseOver, onMouseWheel

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

BasicList

public BasicList(UI ui,
                 float x,
                 float y,
                 float w,
                 float h)

Method Detail

setFocusIndex

public UIItemList setFocusIndex(int focusIndex)

Description copied from interface: UIItemList

Sets the index of the focused item in the list. Checks the bounds and adjusts the scroll position if necessary.

Specified by:

setFocusIndex in interface UIItemList

Parameters:

focusIndex - Index of item to focus

Returns:

this

getFocusedIndex

public int getFocusedIndex()

Description copied from interface: UIItemList

Returns the index of the currently focused item in the list

Specified by:

getFocusedIndex in interface UIItemList

Returns:

Index of focused item

getFocusedItem

public UIItemList.Item getFocusedItem()

Description copied from interface: UIItemList

Retrieves the currently focused item in the list.

Specified by:

getFocusedItem in interface UIItemList

Returns:

Focused item, or null if none is focused

addSection

public UIItemList addSection(UIItemList.Section section)

Description copied from interface: UIItemList

Add a section to the list

Specified by:

addSection in interface UIItemList

Parameters:

section - Section

Returns:

this

addItem

public UIItemList addItem(int index,
                          UIItemList.Item item)

Description copied from interface: UIItemList

Adds an item to the list at the given index

Specified by:

addItem in interface UIItemList

Parameters:

index - Index to add the item at

item - Item to add

Returns:

this

addItem

public UIItemList addItem(UIItemList.Item item)

Description copied from interface: UIItemList

Adds an item to the list

Specified by:

addItem in interface UIItemList

Parameters:

item - Item to add

Returns:

this

moveItem

public UIItemList moveItem(UIItemList.Item item,
                           int index)

Description copied from interface: UIItemList

Moves an item to another location in the list

Specified by:

moveItem in interface UIItemList

Parameters:

item - Item to move

index - Index to move to

Returns:

this

removeItem

public UIItemList removeItem(UIItemList.Item item)

Description copied from interface: UIItemList

Removes an item from the list

Specified by:

removeItem in interface UIItemList

Parameters:

item - Item to remove

Returns:

this

setItems

public UIItemList setItems(List<? extends UIItemList.Item> items)

Description copied from interface: UIItemList

Sets the items in the list and redraws it

Specified by:

setItems in interface UIItemList

Parameters:

items - Items

Returns:

this

clearItems

public UIItemList clearItems()

Description copied from interface: UIItemList

Clears all items in the list

Specified by:

clearItems in interface UIItemList

Returns:

this

getItems

public List<? extends UIItemList.Item> getItems()

Description copied from interface: UIItemList

Get the items in the list

Specified by:

getItems in interface UIItemList

Returns:

list of items

setSingleClickActivate

public UIItemList setSingleClickActivate(boolean singleClickActivate)

Description copied from interface: UIItemList

Sets whether single-clicks on an item should activate them. Default behavior requires double-click or ENTER keypress

Specified by:

setSingleClickActivate in interface UIItemList

Parameters:

singleClickActivate - Whether to activate on a single click

Returns:

this

setShowCheckboxes

public UIItemList setShowCheckboxes(boolean showCheckboxes)

Description copied from interface: UIItemList

Sets whether a column of checkboxes should be shown on the item list, to the left of the labels. Useful for a secondary selection state.

Specified by:

setShowCheckboxes in interface UIItemList

Parameters:

showCheckboxes - Whether to show checkboxes

Returns:

this

setRenamable

public UIItemList setRenamable(boolean isRenamable)

Description copied from interface: UIItemList

Sets whether renaming items is allowed

Specified by:

setRenamable in interface UIItemList

Parameters:

isRenamable - If items may be renamed

Returns:

this

setMomentary

public UIItemList setMomentary(boolean momentary)

Description copied from interface: UIItemList

Sets whether the item list is momentary. If so, then clicking on an item or pressing ENTER/SPACE sends a deactivate action after the click ends.

Specified by:

setMomentary in interface UIItemList

Parameters:

momentary - Whether items are momentary

Returns:

this

setReorderable

public UIItemList setReorderable(boolean reorderable)

Description copied from interface: UIItemList

Sets whether the list is reorderable. If so, then pressing the modifier key with the up or down arrows will reorder the items.

Specified by:

setReorderable in interface UIItemList

Parameters:

reorderable - Whether items are reorderable

Returns:

this

setControlSurfaceFocus

public UIItemList setControlSurfaceFocus(int index,
                                         int length)

Description copied from interface: UIItemList

Sets a control focus range that is highlighted in the list

Specified by:

setControlSurfaceFocus in interface UIItemList

Parameters:

index - Start of the surface focus

length - Length of the surface focus block

Returns:

this

addListener

public UIItemList addListener(UIItemList.Listener listener)

Description copied from interface: UIItemList

Adds a listener to receive notifications about list operations

Specified by:

addListener in interface UIItemList

Parameters:

listener - Listener

Returns:

this

removeListener

public UIItemList removeListener(UIItemList.Listener listener)

Description copied from interface: UIItemList

Removes a listener from receiving notifications about list operations

Specified by:

removeListener in interface UIItemList

Parameters:

listener - Listener

Returns:

this

drawFocus

public void drawFocus(UI ui,
                      PGraphics pg)

Description copied from class: UI2dComponent

Draws focus on this object. May be overridden by subclasses to provide custom focus-drawing behavior.

Overrides:

drawFocus in class UI2dComponent

Parameters:

ui - UI

pg - PGraphics

onDraw

public void onDraw(UI ui,
                   PGraphics pg)

Description copied from class: UIObject

Subclasses should override this method to perform their drawing functions.

Overrides:

onDraw in class UIObject

Parameters:

ui - UI context

pg - Graphics context

onMouseClicked

public void onMouseClicked(MouseEvent mouseEvent,
                           float mx,
                           float my)

Description copied from class: UIEventHandler

Subclasses override to receive mouse events

Overrides:

onMouseClicked in class UIEventHandler

Parameters:

mouseEvent - Mouse event

mx - x-coordinate

my - y-coordinate

onMouseDragged

public void onMouseDragged(MouseEvent mouseEvent,
                           float mx,
                           float my,
                           float dx,
                           float dy)

Description copied from class: UIEventHandler

Subclasses override to receive mouse events

Overrides:

onMouseDragged in class UIEventHandler

Parameters:

mouseEvent - Mouse event

mx - x-coordinate

my - y-coordinate

dx - movement in x

dy - movement in y

onMousePressed

public void onMousePressed(MouseEvent mouseEvent,
                           float mx,
                           float my)

Description copied from class: UIEventHandler

Subclasses override to receive mouse events

Overrides:

onMousePressed in class UIEventHandler

Parameters:

mouseEvent - Mouse event

mx - x-coordinate

my - y-coordinate

onMouseReleased

public void onMouseReleased(MouseEvent mouseEvent,
                            float mx,
                            float my)

Description copied from class: UIEventHandler

Subclasses override to receive mouse events

Overrides:

onMouseReleased in class UIEventHandler

Parameters:

mouseEvent - Mouse event

mx - x-coordinate

my - y-coordinate

onBlur

public void onBlur()

Description copied from class: UIObject

Subclasses override when element loses focus

Overrides:

onBlur in class UIObject

onKeyPressed

public void onKeyPressed(KeyEvent keyEvent,
                         char keyChar,
                         int keyCode)

Description copied from class: UIEventHandler

Subclasses override to receive key events

Overrides:

onKeyPressed in class UI2dContainer

Parameters:

keyEvent - Key event

keyChar - Key character

keyCode - Key code value

onKeyReleased

public void onKeyReleased(KeyEvent keyEvent,
                          char keyChar,
                          int keyCode)

Description copied from class: UIEventHandler

Subclasses override to receive key events

Overrides:

onKeyReleased in class UIEventHandler

Parameters:

keyEvent - Key event

keyChar - Key character

keyCode - Key code value

onFocus

public void onFocus(Event event)

Description copied from class: UIObject

Subclasses override when element is focused

Overrides:

onFocus in class UIObject

Parameters:

event - Event that caused focus