Package heronarts.glx.ui.component

Class UIDropMenu

java.lang.Object

heronarts.glx.ui.UIEventHandler

heronarts.glx.ui.UIObject

heronarts.glx.ui.UI2dComponent

heronarts.glx.ui.component.UIParameterComponent

heronarts.glx.ui.component.UIDropMenu

All Implemented Interfaces:

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

Direct Known Subclasses:

UIMidiSelector, UIViewSelector

public class UIDropMenu
extends UIParameterComponent
implements UIFocus, UIControlTarget, UIModulationTarget, LXParameterListener

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	UIDropMenu.Direction

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

Method Summary

Modifier and Type	Method	Description
void	dispose()
protected void	drawDisabledBackground(UI ui, VGraphics vg)
static void	drawTriangle(UI ui, UI2dComponent component, VGraphics vg, float textOffsetY)
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 int	getFocusSize()	Focus size for hashes drawn on the outline of the object.
LXCompoundModulation.Target	getModulationTarget()
DiscreteParameter	getParameter()
void	onDraw(UI ui, VGraphics vg)	Subclasses should override this method to perform their drawing functions.
void	onKeyPressed(KeyEvent keyEvent, char keyChar, int keyCode)	Subclasses override to receive key events
void	onMousePressed(MouseEvent mouseEvent, float x, float y)	Subclasses override to receive mouse events
void	onParameterChanged(LXParameter p)	Invoked when the value of a parameter is changed.
UIDropMenu	setDirection(UIDropMenu.Direction direction)	Sets the direction that this drop menu opens, up or down
UIDropMenu	setEnabled(boolean enabled)
UIDropMenu	setMenuWidth(float menuWidth)
UIDropMenu	setOptions(String[] options)	Sets the list of string options to display in the menu
UIDropMenu	setParameter(DiscreteParameter parameter)

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

getContextActions, getOscAddress, onMouseReleased, 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, drawBorder, drawComponentBackground, drawFocus, drawFocusCorners, drawFocusCorners, drawParentBackground, getAbsoluteX, getAbsoluteY, getBackgroundColor, getBorderColor, getBorderWeight, getBottomMargin, getContainer, getDebugClassHierarchy, getDebugClassHierarchy, getFocusColor, 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, 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, onMouseScroll

Methods inherited from class java.lang.Object

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

Constructor Details

UIDropMenu

public UIDropMenu(float x,
 float y,
 float w)

UIDropMenu

public UIDropMenu(float x,
 float y,
 float w,
 DiscreteParameter parameter)

UIDropMenu

public UIDropMenu(float w)

UIDropMenu

public UIDropMenu(float w,
 DiscreteParameter parameter)

UIDropMenu

public UIDropMenu(float w,
 float h)

UIDropMenu

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

UIDropMenu

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

UIDropMenu

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

Method Details

setMenuWidth

public UIDropMenu setMenuWidth(float menuWidth)

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

setEnabled

public UIDropMenu setEnabled(boolean enabled)

setParameter

public UIDropMenu setParameter(DiscreteParameter parameter)

onParameterChanged

public void onParameterChanged(LXParameter p)

Description copied from interface: LXParameterListener

Invoked when the value of a parameter is changed.

Specified by:

onParameterChanged in interface LXParameterListener

Parameters:

p - The parameter that has changed its value

setDirection

public UIDropMenu setDirection(UIDropMenu.Direction direction)

Sets the direction that this drop menu opens, up or down

Parameters:

direction - Direction menu should open

Returns:

this

setOptions

public UIDropMenu setOptions(String[] options)

Sets the list of string options to display in the menu

Parameters:

options - Options array

Returns:

this

getFocusSize

protected int getFocusSize()

Description copied from class: UI2dComponent

Focus size for hashes drawn on the outline of the object. May be overridden.

Overrides:

getFocusSize in class UI2dComponent

Returns:

Focus hash line size

drawDisabledBackground

protected void drawDisabledBackground(UI ui,
 VGraphics vg)

onDraw

public 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

drawTriangle

public static void drawTriangle(UI ui,
 UI2dComponent component,
 VGraphics vg,
 float textOffsetY)

onMousePressed

public void onMousePressed(MouseEvent mouseEvent,
 float x,
 float y)

Description copied from class: UIEventHandler

Subclasses override to receive mouse events

Overrides:

onMousePressed in class UIParameterComponent

Parameters:

mouseEvent - Mouse event

x - x-coordinate

y - y-coordinate

onKeyPressed

public 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

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 UIObject