Package heronarts.glx.ui.component

Class UILabel

java.lang.Object

heronarts.glx.ui.UIEventHandler

heronarts.glx.ui.UIObject

heronarts.glx.ui.UI2dComponent

heronarts.glx.ui.component.UILabel

All Implemented Interfaces:

LXLoopTask

Direct Known Subclasses:

UIComponentLabel, UILabel.Control, UILabel.Copyable, UIParameterLabel

public class UILabel
extends UI2dComponent

A simple text label object. Draws a string aligned top-left to its x-y position.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	UILabel.Control
static class	UILabel.Copyable

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

UI2dComponent.Scissor, UI2dComponent.Scissored, UI2dComponent.UIDragReorder

Field Summary

Fields

Modifier and Type	Field	Description
static final float	DEFAULT_HEIGHT

Fields inherited from class heronarts.glx.ui.UI2dComponent

debug, debugName, 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
UILabel()
UILabel(float x, float y, float w, float h)
UILabel(float x, float y, float w, float h, String label)
UILabel(float x, float y, float w, String label)
UILabel(float w, float h, String label)
UILabel(float w, String label)

Method Summary

Modifier and Type	Method	Description
String	getDescription()	Objects are encouraged to override this method providing a helpful String displayed to the user explaining the function of this UI component.
String	getLabel()
protected void	onDraw(UI ui, VGraphics vg)	Subclasses should override this method to perform their drawing functions.
UILabel	setBreakLines(boolean breakLines)	Sets the label to render text multi-line
UILabel	setBreakLines(boolean breakLines, boolean autoHeight)	Sets the label to render text multi-line
UILabel	setLabel(String label)
UILabel	setPadding(int padding)	Sets padding on all 4 sides
UILabel	setPadding(int topBottom, int leftRight)	Sets padding on top and sides, CSS style
UILabel	setPadding(int topPadding, int rightPadding, int bottomPadding, int leftPadding)	Sets padding on all 4 sides

Methods inherited from class heronarts.glx.ui.UI2dComponent

addToContainer, addToContainer, addToContainer, addToContainer, addToContainer, addToContainer, addToContainer, addToContainer, assertValidContainer, clipTextToWidth, clipTextToWidth, contains, dbch, drawBackground, drawBorder, drawFocus, drawFocusCorners, drawFocusCorners, drawParentBackground, getAbsoluteX, getAbsoluteY, getBackgroundColor, getBorderColor, getBorderWeight, getContainer, getDebugClassHierarchy, getDebugClassHierarchy, getFocusColor, getFocusSize, getFont, getFontColor, getHeight, getMappableParameter, getNextSibling, getParent, getPrevSibling, 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, blur, bringToFront, dispose, focus, getFocusedChild, getLX, getUI, hasDirectFocus, hasFocus, isVisible, loop, onBlur, onFocus, onUIResize, removeLoopTask, requireUIThread, setConsumeMousePress, setDebugId, toggleVisible, toString

Methods inherited from class heronarts.glx.ui.UIEventHandler

onKeyPressed, 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

Field Details

DEFAULT_HEIGHT

public static final float DEFAULT_HEIGHT

See Also:

• Constant Field Values

Constructor Details

UILabel

public UILabel()

UILabel

public UILabel(float w,
 String label)

UILabel

public UILabel(float w,
 float h,
 String label)

UILabel

public UILabel(float x,
 float y,
 float w,
 String label)

UILabel

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

UILabel

public UILabel(float x,
 float y,
 float w,
 float h,
 String label)

Method Details

setBreakLines

public UILabel setBreakLines(boolean breakLines)

Sets the label to render text multi-line

Parameters:

breakLines - Whether to break lines

Returns:

this

setBreakLines

public UILabel setBreakLines(boolean breakLines,
 boolean autoHeight)

Sets the label to render text multi-line

Parameters:

breakLines - Whether to break lines

autoHeight - Whether to automatically set height

Returns:

this

setPadding

public UILabel setPadding(int padding)

Sets padding on all 4 sides

Parameters:

padding - Padding

Returns:

this

setPadding

public UILabel setPadding(int topBottom,
 int leftRight)

Sets padding on top and sides, CSS style

Parameters:

topBottom - Top bottom padding

leftRight - Left right padding

Returns:

this

setPadding

public UILabel setPadding(int topPadding,
 int rightPadding,
 int bottomPadding,
 int leftPadding)

Sets padding on all 4 sides

Parameters:

topPadding - Top padding

rightPadding - Right padding

bottomPadding - Bottom padding

leftPadding - Left padding

Returns:

this

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

getLabel

public String getLabel()

setLabel

public UILabel setLabel(String label)

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