heronarts.p3lx.ui.component

Class UIContextButton

java.lang.Object

heronarts.p3lx.ui.UIEventHandler

heronarts.p3lx.ui.UIObject

heronarts.p3lx.ui.UI2dComponent

heronarts.p3lx.ui.component.UIContextButton

All Implemented Interfaces:

LXLoopTask, UIFocus, UIKeyFocus, UIMouseFocus, UITabFocus

public class UIContextButton
extends UI2dComponent
implements UIFocus

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UIContextButton.Direction Direction that a context menu opens from a button

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

Method Summary

Modifier and Type	Method and Description
UIContextMenu	getContextMenu() Accessor for the underlying context menu object
void	onDraw(UI ui, PGraphics pg) 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 mx, float my) Subclasses override to receive mouse events
void	onMouseReleased(MouseEvent mouseEvent, float mx, float my) Subclasses override to receive mouse events
UIContextButton	setContextActions(UIContextActions.Action[] contextActions) Sets an array of actions that will be shown in the context menu that opens when the button is clicked
UIContextButton	setContextMenuWidth(float contextMenuWidth) Sets the width of the context menu opened by this button
UIContextButton	setDirection(UIContextButton.Direction direction) Sets the direction in which the context menu opens
UIContextButton	setLabel(String label) Sets the label visible on the button

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, onFocus, onUIResize, removeLoopTask, toggleVisible

Methods inherited from class heronarts.p3lx.ui.UIEventHandler

onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragged, onMouseMoved, onMouseOut, onMouseOver, onMouseWheel

Methods inherited from class java.lang.Object

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

Constructor Detail

UIContextButton

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

Method Detail

getContextMenu

public UIContextMenu getContextMenu()

Accessor for the underlying context menu object

Returns:

Context menu object opened by this button

setContextMenuWidth

public UIContextButton setContextMenuWidth(float contextMenuWidth)

Sets the width of the context menu opened by this button

Parameters:

contextMenuWidth - Width of context menu

Returns:

this

setContextActions

public UIContextButton setContextActions(UIContextActions.Action[] contextActions)

Sets an array of actions that will be shown in the context menu that opens when the button is clicked

Parameters:

contextActions - Set of context actions shown when button is clicked

Returns:

this

setLabel

public UIContextButton setLabel(String label)

Sets the label visible on the button

Parameters:

label - Label

Returns:

this

setDirection

public UIContextButton setDirection(UIContextButton.Direction direction)

Sets the direction in which the context menu opens

Parameters:

direction - Direction to open

Returns:

this

onDraw

public void onDraw(UI ui,
                   PGraphics pg)

Description copied from class: UIObject

Subclasses should override this method to perform their drawing functions.

Overrides:

onDraw in class UIObject

Parameters:

ui - UI context

pg - Graphics context

onMousePressed

public void onMousePressed(MouseEvent mouseEvent,
                           float mx,
                           float my)

Description copied from class: UIEventHandler

Subclasses override to receive mouse events

Overrides:

onMousePressed in class UIEventHandler

Parameters:

mouseEvent - Mouse event

mx - x-coordinate

my - y-coordinate

onMouseReleased

public void onMouseReleased(MouseEvent mouseEvent,
                            float mx,
                            float my)

Description copied from class: UIEventHandler

Subclasses override to receive mouse events

Overrides:

onMouseReleased in class UIEventHandler

Parameters:

mouseEvent - Mouse event

mx - x-coordinate

my - 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