heronarts.p3lx.ui

Class UI2dContainer

java.lang.Object

heronarts.p3lx.ui.UIEventHandler

heronarts.p3lx.ui.UIObject

heronarts.p3lx.ui.UI2dComponent

heronarts.p3lx.ui.UI2dContainer

All Implemented Interfaces:

LXLoopTask, UIContainer, Iterable<UIObject>

Direct Known Subclasses:

UI2dContext, UIAbstractGlobalModulator.UIModulation, UIAudio.UIOutputControls, UIButtonGroup, UIClipButton, UIClipLauncher, UIClipView, UICollapsibleSection, UIColorPicker.UIColorOverlay, UIContentPicker, UIDevice, UIDeviceModulators, UIDialogBox, UIFixture, UIFixture.Section, UIItemList.BasicList, UIMixer, UIMixerStrip, UIMixerStripControls, UIModelManager, UIModulator, UIPalette.UISavedSwatch, UIPreferences, UIProject.UIScheduler, UISceneLauncher, UISceneStrip, UIToolbarSection, UIVariableLFO.UIPeriodControl

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

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UI2dContainer.ArrowKeyFocus
static class	UI2dContainer.Layout

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

Method Summary

Modifier and Type	Method and Description
UI2dContainer	addChildren(UI2dComponent... children)
protected UI2dContainer	addTopLevelComponent(UI2dComponent child)
UI2dComponent	getChild(int i)
List<UIObject>	getChildren()
float	getContentHeight() Returns the height of the content container
UIObject	getContentTarget() Returns the object that elements are added to when placed in this container.
float	getContentWidth() Returns the width of the content container
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	onKeyPressed(KeyEvent keyEvent, char keyChar, int keyCode) Subclasses override to receive key events
protected void	reflow()
UI2dContainer	removeAllChildren()
UI2dContainer	setArrowKeyFocus(UI2dContainer.ArrowKeyFocus keyFocus)
UI2dContainer	setChildMargin(float childMargin) Deprecated.
UI2dContainer	setChildSpacing(float childSpacing) Sets the spacing between child objects when a layout is in use
UI2dContainer	setChildSpacing(float childSpacingY, float childSpacingX) Sets the spacing between child objects when a layout is in use
UI2dContainer	setContentHeight(float h)
UI2dContainer	setContentSize(float w, float h)
protected UI2dContainer	setContentTarget(UI2dContainer contentTarget)
UI2dContainer	setContentWidth(float w)
UI2dContainer	setLayout(UI2dContainer.Layout layout)
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.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, getDescription, getFocusedChild, getLX, getUI, hasDirectFocus, hasFocus, isVisible, keyEventConsumed, loop, mousePressConsumed, onBlur, onDraw, onFocus, onUIResize, removeLoopTask, toggleVisible

Methods inherited from class heronarts.p3lx.ui.UIEventHandler

onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragged, onMouseMoved, onMouseOut, onMouseOver, onMousePressed, onMouseReleased, 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

UI2dContainer

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

Method Detail

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)

setChildMargin

@Deprecated
public UI2dContainer setChildMargin(float childMargin)

Deprecated.

Deprecated. Use setChildSpacing(float) instead

Parameters:

childMargin - Spacing between child objects

Returns:

this

setChildSpacing

public UI2dContainer setChildSpacing(float childSpacing)

Sets the spacing between child objects when a layout is in use

Parameters:

childSpacing - Spacing between child objects

Returns:

this

setChildSpacing

public UI2dContainer setChildSpacing(float childSpacingY,
                                     float childSpacingX)

Sets the spacing between child objects when a layout is in use

Parameters:

childSpacingY - Vertical spacing between child objects

childSpacingX - Horizontal spacing between child objects

Returns:

this

setMinWidth

public UI2dContainer setMinWidth(float minWidth)

setMinHeight

public UI2dContainer setMinHeight(float minHeight)

setLayout

public UI2dContainer setLayout(UI2dContainer.Layout layout)

setArrowKeyFocus

public UI2dContainer setArrowKeyFocus(UI2dContainer.ArrowKeyFocus keyFocus)

addChildren

public UI2dContainer addChildren(UI2dComponent... children)

reflow

protected void reflow()

setContentTarget

protected UI2dContainer setContentTarget(UI2dContainer contentTarget)

addTopLevelComponent

protected UI2dContainer addTopLevelComponent(UI2dComponent child)

getContentTarget

public UIObject 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

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

iterator

public Iterator<UIObject> iterator()

Specified by:

iterator in interface Iterable<UIObject>

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