heronarts.p3lx.ui.component

Class UIIntegerBox

java.lang.Object

heronarts.p3lx.ui.UIEventHandler

heronarts.p3lx.ui.UIObject

heronarts.p3lx.ui.UI2dComponent

heronarts.p3lx.ui.component.UIParameterComponent

heronarts.p3lx.ui.component.UIInputBox

heronarts.p3lx.ui.component.UINumberBox

heronarts.p3lx.ui.component.UIIntegerBox

All Implemented Interfaces:

LXLoopTask, UIContextActions, UIControlTarget, UIFocus, UIKeyFocus, UIMouseFocus, UITabFocus

Direct Known Subclasses:

UIEnumBox

public class UIIntegerBox
extends UINumberBox
implements UIControlTarget

Nested Class Summary

Nested classes/interfaces inherited from class heronarts.p3lx.ui.component.UIInputBox

UIInputBox.FillStyle, UIInputBox.ProgressIndicator

Nested classes/interfaces inherited from interface heronarts.p3lx.ui.UIContextActions

UIContextActions.Action

Field Summary

Fields

Modifier and Type	Field and Description
protected int	editMultiplier
protected DiscreteParameter	parameter

Fields inherited from class heronarts.p3lx.ui.component.UINumberBox

hasShiftMultiplier, shiftMultiplier

Fields inherited from class heronarts.p3lx.ui.component.UIInputBox

editable, editBuffer, editing, enabled, fillColor, fillStyle, hasFill, progressFillStyle, returnKeyEdit

Fields inherited from class heronarts.p3lx.ui.component.UIParameterComponent

DEFAULT_HEIGHT, useCommandEngine

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
UIIntegerBox()
UIIntegerBox(float w, DiscreteParameter parameter)
UIIntegerBox(float w, float h, DiscreteParameter parameter)
UIIntegerBox(float x, float y, float w, float h)

Method Summary

Modifier and Type	Method and Description
protected void	decrementValue(KeyEvent keyEvent) Subclasses may optionally override to decrement value in response to arrows.
LXParameter	getControlTarget()
String	getDescription() Objects are encouraged to override this method providing a helpful String displayed to the user explaining the function of this UI component.
protected double	getFillWidthNormalized()
LXParameter	getParameter()
int	getValue()
String	getValueString()
protected void	incrementMouseValue(MouseEvent mouseEvent, int offset) Subclasses may optionally implement to change value based upon mouse click+drag in the box.
protected void	incrementValue(KeyEvent keyEvent) Subclasses may optionally override to decrement value in response to arrows.
protected boolean	isValidCharacter(char keyChar)
protected void	onValueChange(int value) Subclasses may override to handle value changes
protected void	saveEditBuffer()
UIIntegerBox	setEditMultiplier(int editMultiplier)
UIIntegerBox	setParameter(DiscreteParameter parameter)
UIIntegerBox	setRange(int minValue, int maxValue)
UIIntegerBox	setValue(int value)
protected UIIntegerBox	setValue(int value, boolean pushToParameter)

Methods inherited from class heronarts.p3lx.ui.component.UINumberBox

setFill, setFillColor, setFillStyle, setShiftMultiplier

Methods inherited from class heronarts.p3lx.ui.component.UIInputBox

edit, enableImmediateEdit, enableMousePressEdit, enableReturnKeyEdit, getEditBufferValue, isEditable, isEnabled, onBlur, onDraw, onKeyPressed, onMouseDragged, onMousePressed, onMouseReleased, setEditable, setEnabled, setProgressColor, setProgressColor, setProgressFillStyle, setProgressIndicator, setValueCommand

Methods inherited from class heronarts.p3lx.ui.component.UIParameterComponent

getContextActions, getOscAddress, setNormalizedCommand, setUseCommandEngine

Methods inherited from class heronarts.p3lx.ui.UI2dComponent

addToContainer, addToContainer, breakTextToWidth, clipTextToWidth, contains, drawBackground, drawBorder, drawFocus, 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, getFocusedChild, getLX, getUI, hasDirectFocus, hasFocus, isVisible, keyEventConsumed, loop, mousePressConsumed, onFocus, onUIResize, removeLoopTask, toggleVisible

Methods inherited from class heronarts.p3lx.ui.UIEventHandler

onKeyReleased, onKeyTyped, onMouseClicked, onMouseMoved, onMouseOut, onMouseOver, onMouseWheel

Methods inherited from class java.lang.Object

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

Field Detail

parameter

protected DiscreteParameter parameter

editMultiplier

protected int editMultiplier

Constructor Detail

UIIntegerBox

public UIIntegerBox()

UIIntegerBox

public UIIntegerBox(float x,
                    float y,
                    float w,
                    float h)

UIIntegerBox

public UIIntegerBox(float w,
                    DiscreteParameter parameter)

UIIntegerBox

public UIIntegerBox(float w,
                    float h,
                    DiscreteParameter parameter)

Method Detail

getDescription

public String getDescription()

Description copied from class: UIObject

Objects are encouraged to override this method providing a helpful String displayed to the user explaining the function of this UI component. If no help is available, return null rather than an empty String.

Overrides:

getDescription in class UIObject

Returns:

Helpful contextual string explaining function of this element

getParameter

public LXParameter getParameter()

Specified by:

getParameter in class UIParameterComponent

setParameter

public UIIntegerBox setParameter(DiscreteParameter parameter)

setRange

public UIIntegerBox setRange(int minValue,
                             int maxValue)

setEditMultiplier

public UIIntegerBox setEditMultiplier(int editMultiplier)

getFillWidthNormalized

protected double getFillWidthNormalized()

Overrides:

getFillWidthNormalized in class UIInputBox

getValue

public int getValue()

getValueString

public String getValueString()

Specified by:

getValueString in class UIInputBox

setValue

public UIIntegerBox setValue(int value)

setValue

protected UIIntegerBox setValue(int value,
                                boolean pushToParameter)

onValueChange

protected void onValueChange(int value)

Subclasses may override to handle value changes

Parameters:

value - New value being set

saveEditBuffer

protected void saveEditBuffer()

Specified by:

saveEditBuffer in class UIInputBox

isValidCharacter

protected boolean isValidCharacter(char keyChar)

Specified by:

isValidCharacter in class UIInputBox

incrementValue

protected void incrementValue(KeyEvent keyEvent)

Description copied from class: UIInputBox

Subclasses may optionally override to decrement value in response to arrows. Increment is invoked for the right or up keys.

Overrides:

incrementValue in class UIInputBox

Parameters:

keyEvent - Key event

decrementValue

protected void decrementValue(KeyEvent keyEvent)

Description copied from class: UIInputBox

Subclasses may optionally override to decrement value in response to arrows. Decrement is invoked for the left or down arrow keys.

Overrides:

decrementValue in class UIInputBox

Parameters:

keyEvent - Key event

incrementMouseValue

protected void incrementMouseValue(MouseEvent mouseEvent,
                                   int offset)

Description copied from class: UIInputBox

Subclasses may optionally implement to change value based upon mouse click+drag in the box.

Overrides:

incrementMouseValue in class UIInputBox

Parameters:

mouseEvent - Mouse event

offset - Units of mouse movement, positive or negative

getControlTarget

public LXParameter getControlTarget()

Specified by:

getControlTarget in interface UIControlTarget