Package heronarts.glx.ui

Class UI2dContainer

java.lang.Object

heronarts.glx.ui.UIEventHandler

heronarts.glx.ui.UIObject

heronarts.glx.ui.UI2dComponent

heronarts.glx.ui.UI2dContainer

All Implemented Interfaces:

UIContainer, LXLoopTask, Iterable<UIObject>

Direct Known Subclasses:

UI2dContext, UI2dScrollContainer, UI2dScrollPane, UIAudio.GraphicMeter, UIAudio.UIOutputControls, UIBottomTray, UIButtonGroup, UIChannelDevice.PlaylistControls, UIClipButton, UIClipEnvelope.UIClipLaneMetadata, UIClipGridStrip, UIClipInspector, UIClipLauncher, UICollapsibleSection, UIColorPicker.UIColorOverlay, UIContentPicker, UIContextMenu, UICredits, UIDevice, UIDeviceBin, UIDeviceBin.UIPatternBin, UIDeviceModulators, UIDialogBox, UIFixture, UIFixture.Section, UIFixturePicker, UIImagePattern.ImageControls, UIItemList.BasicList, UIItemList.ScrollList, UILane, UIMidiTemplates, UIMixer, UIMixerStrip, UIMixerStripControls, UIModelManager, UIModulationMappings, UIModulationMappings.UIModulation, UIModulator, UIModulatorPicker, UIOscManager.UIOutput, UIPalette.SavedSwatch, UIPalette.Swatch, UIPane, UIPatternLauncher, UIPatternLauncher.PatternButton, UIPerformanceContainer, UIPerformancePane.Section, UIPreferences, UIProject.UIScheduler, UISceneLauncher, UISceneStrip, UISolidPattern.UILinkedColorColumn, UIStatusBar, UITimeline, UITimeline.Body.SideBar, UIToolbar, UIToolbarSection, UIVariableLFO.UIPeriodControl, UIWave

public class UI2dContainer
extends UI2dComponent
implements UIContainer, Iterable<UIObject>

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	UI2dContainer.ArrowKeyFocus
static enum	UI2dContainer.Layout
static enum	UI2dContainer.Position

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

UI2dComponent.Scissor, UI2dComponent.Scissored, UI2dComponent.UIDragReorder

Field Summary

Fields

Modifier and Type	Field	Description
protected float	bottomPadding
protected float	childSpacingX
protected float	childSpacingY
protected float	leftPadding
protected float	rightPadding
protected float	topPadding

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

Method Summary

Modifier and Type	Method	Description
UI2dContainer	addChildren(UI2dComponent... children)
protected UI2dContainer	addTopLevelComponent(UI2dComponent child)
float	getBottomPadding()
UI2dComponent	getChild(int i)
List<UIObject>	getChildren()
float	getChildSpacingX()
float	getChildSpacingY()
float	getContentHeight()	Returns the height of the content container
UI2dContainer	getContentTarget()	Returns the object that elements are added to when placed in this container.
float	getContentWidth()	Returns the width of the content container
float	getLeftPadding()
float	getRightPadding()
float	getScrollHeight()	Returns the height of scrolling content.
float	getScrollWidth()	Returns the width of scrolling content.
float	getTopPadding()
boolean	hasDragToReorder()
boolean	isEmpty()
Iterator<UIObject>	iterator()
static UI2dContainer	newHorizontalContainer(float height)
static UI2dContainer	newHorizontalContainer(float height, float childSpacing)
static UI2dContainer	newHorizontalContainer(float height, float childSpacing, UI2dComponent... children)
static UI2dContainer	newVerticalContainer(float width)
static UI2dContainer	newVerticalContainer(float width, float childSpacing)
static UI2dContainer	newVerticalContainer(float width, float childSpacing, UI2dComponent... children)
protected void	onDraw(UI ui, VGraphics vg)	Subclasses should override this method to perform their drawing functions.
protected void	onKeyPressed(KeyEvent keyEvent, char keyChar, int keyCode)	Subclasses override to receive key events
protected void	onReflow()
protected final void	reflow()
UI2dContainer	removeAllChildren()
UI2dContainer	removeAllChildren(boolean dispose)
UI2dContainer	setArrowKeyFocus(UI2dContainer.ArrowKeyFocus keyFocus)
UI2dContainer	setChildMargin(float childMargin)	Deprecated.
UI2dContainer	setChildSpacing(float childSpacing)
UI2dContainer	setChildSpacing(float childSpacingY, float childSpacingX)
UI2dContainer	setChildSpacingX(float childSpacingX)
UI2dContainer	setChildSpacingY(float childSpacingY)
UI2dContainer	setContentHeight(float h)
UI2dContainer	setContentSize(float w, float h)
protected UI2dContainer	setContentTarget(UI2dContainer contentTarget)
UI2dContainer	setContentWidth(float w)
UI2dContainer	setDragToReorder(boolean dragToReorder)
UI2dContainer	setLayout(UI2dContainer.Layout layout)
UI2dContainer	setLayout(UI2dContainer.Layout layout, float childSpacing)
UI2dContainer	setMinHeight(float minHeight)
UI2dContainer	setMinWidth(float minWidth)
UI2dContainer	setPadding(float padding)
UI2dContainer	setPadding(float yPadding, float xPadding)
UI2dContainer	setPadding(float topPadding, float rightPadding, float bottomPadding, float leftPadding)

Methods inherited from class heronarts.glx.ui.UI2dComponent

addAfterSibling, addBeforeSibling, addToContainer, addToContainer, addToContainer, addToContainer, addToContainer, addToContainer, addToContainer, addToContainer, assertValidContainer, clipTextToWidth, clipTextToWidth, contains, dbch, drawBackground, drawBorder, 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, dispose, focus, getDescription, getFocusedChild, getLX, getUI, hasDirectFocus, hasFocus, isVisible, isVisible, loop, onBlur, onFocus, onUIResize, removeLoopTask, requireUIThread, setConsumeMousePress, setDebugId, setMouseCursor, toggleVisible, toString

Methods inherited from class heronarts.glx.ui.UIEventHandler

onGamepadAxisChanged, onGamepadButtonPressed, onGamepadButtonReleased, onKeyReleased, onMouseDragged, onMouseMoved, onMouseOut, onMouseOver, onMousePressed, onMouseReleased, onMouseScroll

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Details

topPadding

protected float topPadding

rightPadding

protected float rightPadding

bottomPadding

protected float bottomPadding

leftPadding

protected float leftPadding

childSpacingX

protected float childSpacingX

childSpacingY

protected float childSpacingY

Constructor Details

UI2dContainer

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

Method Details

newHorizontalContainer

public static UI2dContainer newHorizontalContainer(float height)

newHorizontalContainer

public static UI2dContainer newHorizontalContainer(float height,
 float childSpacing)

newHorizontalContainer

public static UI2dContainer newHorizontalContainer(float height,
 float childSpacing,
 UI2dComponent... children)

newVerticalContainer

public static UI2dContainer newVerticalContainer(float width)

newVerticalContainer

public static UI2dContainer newVerticalContainer(float width,
 float childSpacing)

newVerticalContainer

public static UI2dContainer newVerticalContainer(float width,
 float childSpacing,
 UI2dComponent... children)

setPadding

public UI2dContainer setPadding(float padding)

setPadding

public UI2dContainer setPadding(float yPadding,
 float xPadding)

setPadding

public UI2dContainer setPadding(float topPadding,
 float rightPadding,
 float bottomPadding,
 float leftPadding)

getTopPadding

public float getTopPadding()

getRightPadding

public float getRightPadding()

getBottomPadding

public float getBottomPadding()

getLeftPadding

public float getLeftPadding()

getChildSpacingX

public float getChildSpacingX()

getChildSpacingY

public float getChildSpacingY()

setChildMargin

@Deprecated
public UI2dContainer setChildMargin(float childMargin)

Deprecated.

Deprecated. Use setChildSpacing(float) instead

Parameters:

childMargin - Child margin

Returns:

this

setChildSpacing

public UI2dContainer setChildSpacing(float childSpacing)

setChildSpacingX

public UI2dContainer setChildSpacingX(float childSpacingX)

setChildSpacingY

public UI2dContainer setChildSpacingY(float childSpacingY)

setChildSpacing

public UI2dContainer setChildSpacing(float childSpacingY,
 float childSpacingX)

setMinWidth

public UI2dContainer setMinWidth(float minWidth)

setMinHeight

public UI2dContainer setMinHeight(float minHeight)

setLayout

public UI2dContainer setLayout(UI2dContainer.Layout layout,
 float childSpacing)

setLayout

public UI2dContainer setLayout(UI2dContainer.Layout layout)

setDragToReorder

public UI2dContainer setDragToReorder(boolean dragToReorder)

hasDragToReorder

public boolean hasDragToReorder()

setArrowKeyFocus

public UI2dContainer setArrowKeyFocus(UI2dContainer.ArrowKeyFocus keyFocus)

addChildren

public UI2dContainer addChildren(UI2dComponent... children)

reflow

protected final void reflow()

onReflow

protected void onReflow()

setContentTarget

protected UI2dContainer setContentTarget(UI2dContainer contentTarget)

addTopLevelComponent

protected UI2dContainer addTopLevelComponent(UI2dComponent child)

getContentTarget

public UI2dContainer getContentTarget()

Returns the object that elements are added to when placed in this container. In most cases, it will be "this" - but some elements have special subcontainers.

Specified by:

getContentTarget in interface UIContainer

Returns:

Element

getScrollWidth

public float getScrollWidth()

Returns the width of scrolling content. By default this is the same as the width of the container itself, but if the container scrolls then the scroll width may be a larger value.

Returns:

Width of scrollable content

getScrollHeight

public float getScrollHeight()

Returns the height of scrolling content. By default this is the same as the height of the container itself, but if the container scrolls then the scroll height may be a larger value.

Returns:

Height of scrollable content

getContentWidth

public float getContentWidth()

Description copied from interface: UIContainer

Returns the width of the content container

Specified by:

getContentWidth in interface UIContainer

Returns:

width of content section

getContentHeight

public float getContentHeight()

Description copied from interface: UIContainer

Returns the height of the content container

Specified by:

getContentHeight in interface UIContainer

Returns:

height of the content section

setContentWidth

public UI2dContainer setContentWidth(float w)

setContentHeight

public UI2dContainer setContentHeight(float h)

setContentSize

public UI2dContainer setContentSize(float w,
 float h)

removeAllChildren

public UI2dContainer removeAllChildren()

removeAllChildren

public UI2dContainer removeAllChildren(boolean dispose)

iterator

public Iterator<UIObject> iterator()

Specified by:

iterator in interface Iterable<UIObject>

isEmpty

public boolean isEmpty()

getChildren

public List<UIObject> getChildren()

getChild

public UI2dComponent getChild(int i)

onKeyPressed

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

Description copied from class: UIEventHandler

Subclasses override to receive key events

Overrides:

onKeyPressed in class UIEventHandler

Parameters:

keyEvent - Key event

keyChar - Key character

keyCode - Key code value

onDraw

protected void onDraw(UI ui,
 VGraphics vg)

Description copied from class: UI2dComponent

Subclasses should override this method to perform their drawing functions.

Overrides:

onDraw in class UI2dComponent

Parameters:

ui - UI context

vg - Graphics context