Package heronarts.glx.ui.component

Class UIIntegerBox

java.lang.Object

heronarts.glx.ui.UIEventHandler

heronarts.glx.ui.UIObject

heronarts.glx.ui.UI2dComponent

heronarts.glx.ui.component.UIParameterComponent

heronarts.glx.ui.component.UIInputBox

heronarts.glx.ui.component.UINumberBox

heronarts.glx.ui.component.UIIntegerBox

All Implemented Interfaces:

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

Direct Known Subclasses:

UIEnumBox

public class UIIntegerBox
extends UINumberBox
implements UIControlTarget, UIModulationTarget

Nested Class Summary

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

UIInputBox.EditState, UIInputBox.FillStyle, UIInputBox.ProgressIndicator

Nested classes/interfaces inherited from class heronarts.glx.ui.UI2dComponent

UI2dComponent.Scissor, UI2dComponent.Scissored, UI2dComponent.UIDragReorder

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

UIContextActions.Action, UIContextActions.ContextAction

Field Summary

Fields

Modifier and Type	Field	Description
protected DiscreteParameter	parameter

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

hasShiftMultiplier, shiftMultiplier

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

editable, editing, enabled, fillColor, fillStyle, hasFill, mouseEditable, returnKeyEdit

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

DEFAULT_HEIGHT, useCommandEngine

Fields inherited from class heronarts.glx.ui.UI2dComponent

borderRoundingBottomLeft, borderRoundingBottomRight, borderRoundingTopLeft, borderRoundingTopRight, debug, debugName, hasBorderRounding, height, marginBottom, marginLeft, marginRight, marginTop, redraw, scissor, textAlignHorizontal, textAlignVertical, textOffsetX, textOffsetY, width, x, y

Fields inherited from class heronarts.glx.ui.UIObject

children, hasFocus, visible

Constructor Summary

Constructors

Constructor	Description
UIIntegerBox()
UIIntegerBox(float x, float y, float w, float h)
UIIntegerBox(float x, float y, float w, float h, DiscreteParameter parameter)
UIIntegerBox(float w, float h, DiscreteParameter parameter)
UIIntegerBox(float w, DiscreteParameter parameter)

Method Summary

Modifier and Type	Method	Description
protected void	decrementValue(KeyEvent keyEvent)	Subclasses may optionally override to decrement value in response to arrows.
void	dispose()
LXNormalizedParameter	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()
LXCompoundModulation.Target	getModulationTarget()
DiscreteParameter	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(String editBuffer)
UIIntegerBox	setParameter(DiscreteParameter parameter)
UIIntegerBox	setRange(int minValue, int maxValue)	Sets the range of the input box, inclusive
UIIntegerBox	setValue(int value)
protected UIIntegerBox	setValue(int value, boolean pushToParameter)
UIIntegerBox	setWrappable(boolean wrappable)	Sets whether the box is wrappable, only applies when there is not a parameter set.

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

drawBorder, getContextActions, onMousePressed, setFill, setFillColor, setFillStyle, setModulationTarget, setShiftMultiplier

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

disableImmediateAppend, disableImmediateEdit, disableReturnKeyEdit, edit, edit, editAppend, enableImmediateAppend, enableImmediateEdit, enableReturnKeyEdit, getEditBuffer, getEditRange, getInitialEditBufferValue, isEditable, isEnabled, onBlur, onDraw, onDrawText, onEditChange, onEditFinished, onKeyPressed, onMouseDragged, onMouseReleased, setEditable, setEnabled, setMouseEditable, setProgressColor, setProgressColor, setProgressColor, setProgressIndicator, setValueCommand

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

getOscAddress, setEnableContextActions, setModulationRangeCommand, setNormalizedCommand, setUseCommandEngine

Methods inherited from class heronarts.glx.ui.UI2dComponent

addAfterSibling, addBeforeSibling, addToContainer, addToContainer, addToContainer, addToContainer, addToContainer, addToContainer, addToContainer, addToContainer, assertValidContainer, clipTextToWidth, clipTextToWidth, contains, dbch, drawBackground, drawComponentBackground, drawFocus, drawFocusCorners, drawFocusCorners, drawParentBackground, getAbsoluteX, getAbsoluteY, getBackgroundColor, getBorderColor, getBorderWeight, getBottomMargin, getContainer, getDebugClassHierarchy, getDebugClassHierarchy, getFocusColor, getFocusSize, getFont, getFontColor, getHeight, getLeftMargin, getMappableParameter, getNextSibling, getNextSibling, getParent, getPrevSibling, getPrevSibling, getRightMargin, getTopMargin, getWidth, getX, getY, hasBackground, hasBorder, hasFont, hasFontColor, isMappable, onResize, redraw, removeFromContainer, removeFromContainer, setBackground, setBackgroundColor, setBackgroundColor, setBorder, setBorderColor, setBorderColor, setBorderRounding, setBorderRounding, setBorderWeight, setBottomMargin, setContainerIndex, setContainerPosition, setDebug, setDebug, setDescription, setFocusBackground, setFocusBackgroundColor, setFocusBackgroundColor, setFocusColor, setFocusColor, setFocusCorners, setFont, setFontColor, setFontColor, setFontColor, setHeight, setLeftMargin, setMappable, setMargin, setMargin, setMargin, setPosition, setPosition, setPosition, setPosition, setRightMargin, setSize, setTextAlignment, setTextAlignment, setTextOffset, setTopMargin, setVisible, setWidth, setX, setY, vgRoundedRect, vgRoundedRect, vgRoundedRect

Methods inherited from class heronarts.glx.ui.UIObject

addListener, addListener, addLoopTask, addLoopTask, blur, bringToFront, focus, getFocusedChild, getLX, getUI, hasDirectFocus, hasFocus, isVisible, isVisible, loop, onFocus, onUIResize, removeLoopTask, requireUIThread, setConsumeMousePress, setDebugId, setMouseCursor, toggleVisible, toString

Methods inherited from class heronarts.glx.ui.UIEventHandler

onGamepadAxisChanged, onGamepadButtonPressed, onGamepadButtonReleased, onKeyReleased, onMouseMoved, onMouseOut, onMouseOver, onMouseScroll

Methods inherited from class java.lang.Object

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

Field Details

parameter

protected DiscreteParameter parameter

Constructor Details

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)

UIIntegerBox

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

Method Details

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 DiscreteParameter getParameter()

Specified by:

getParameter in class UIParameterComponent

setParameter

public UIIntegerBox setParameter(DiscreteParameter parameter)

setWrappable

public UIIntegerBox setWrappable(boolean wrappable)

Sets whether the box is wrappable, only applies when there is not a parameter set.

Parameters:

wrappable - Whether box is wrappable when no parameter set

Returns:

This

setRange

public UIIntegerBox setRange(int minValue,
 int maxValue)

Sets the range of the input box, inclusive

Parameters:

minValue - Minimum value (inclusive)

maxValue - Maximum value (inclusive)

Returns:

this

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(String editBuffer)

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 LXNormalizedParameter getControlTarget()

Specified by:

getControlTarget in interface UIControlTarget

getModulationTarget

public LXCompoundModulation.Target getModulationTarget()

Specified by:

getModulationTarget in interface UIModulationTarget

dispose

public void dispose()

Overrides:

dispose in class UINumberBox