com.threerings.media.sprite

Class ButtonSprite

java.lang.Object

com.threerings.media.AbstractMedia

com.threerings.media.sprite.Sprite

com.threerings.media.sprite.ButtonSprite

All Implemented Interfaces:

ActionSprite, ArmingSprite, CommandSprite, DisableableSprite, Pathable, DirectionCodes, Shape

public class ButtonSprite
extends Sprite
implements CommandSprite, ArmingSprite, DisableableSprite

A sprite that acts as a button.

Field Summary

Fields

Modifier and Type	Field and Description
static int	NORMAL The normal, square button style.
static int	ROUNDED The rounded button style.

Fields inherited from class com.threerings.media.AbstractMedia

HUD_LAYER

Fields inherited from interface com.threerings.util.DirectionCodes

CARDINAL_DIRECTIONS, CCW, CW, DIRECTION_COUNT, DOWN, EAST, EASTNORTHEAST, EASTSOUTHEAST, FINE_DIRECTION_COUNT, HORIZONTAL, LEFT, NONE, NORTH, NORTHEAST, NORTHNORTHEAST, NORTHNORTHWEST, NORTHWEST, RIGHT, SOUTH, SOUTHEAST, SOUTHSOUTHEAST, SOUTHSOUTHWEST, SOUTHWEST, UP, VERTICAL, WEST, WESTNORTHWEST, WESTSOUTHWEST

Constructor Summary

Constructors

Constructor and Description
ButtonSprite(Label label, int style, Color backgroundColor, Color alternateColor, String actionCommand, Object commandArgument) Constructs a button sprite.
ButtonSprite(Label label, int style, int arcWidth, int arcHeight, Color backgroundColor, Color alternateColor, String actionCommand, Object commandArgument) Constructs a button sprite.

Method Summary

Modifier and Type	Method and Description
String	getActionCommand()
int	getArcHeight() Returns the arc height for rounded buttons.
int	getArcWidth() Returns the arc width for rounded buttons.
Color	getBackgroundColor() Returns the background color of this button.
Object	getCommandArgument()
Label	getLabel() Returns a reference to the label displayed by this sprite.
int	getStyle() Returns the style of this button.
boolean	isArmed() Checks whether or not this button appears pressed.
boolean	isEnabled()
void	paint(Graphics2D gfx) Called by the appropriate manager to request that the media render itself with the given graphics context.
void	setActionCommand(String actionCommand) Sets the action command generated by this button.
void	setArcHeight(int arcHeight) Sets the arc height for rounded buttons.
void	setArcWidth(int arcWidth) Sets the arc width for rounded buttons.
void	setArmed(boolean pressed) Render this sprite such that is is drawn "armed".
void	setBackgroundColor(Color backgroundColor) Sets the background color of this button.
void	setCommandArgument(Object commandArgument) Sets the command argument generated by this button.
void	setEnabled(boolean enabled) Sets whether or not this button is enabled.
void	setStyle(int style) Sets the style of this button.
void	updateBounds() Updates this sprite's bounds after a change to the label.

Methods inherited from class com.threerings.media.sprite.Sprite

addSpriteObserver, cancelMove, contains, fastForward, getHeight, getOrientation, getPath, getWidth, getX, getXOffset, getY, getYOffset, hitTest, inside, intersects, isMoving, move, paintPath, pathBeginning, pathCompleted, removeSpriteObserver, setLocation, setOrientation, tick, viewLocationDidChange

Methods inherited from class com.threerings.media.AbstractMedia

contains, contains, contains, contains, getBounds, getBounds2D, getPathIterator, getPathIterator, getRenderOrder, init, intersects, intersects, invalidate, queueNotification, renderCompareTo, setRenderOrder, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.threerings.media.util.Pathable

getBounds

Field Detail

NORMAL

public static final int NORMAL

The normal, square button style.

See Also:

Constant Field Values

ROUNDED

public static final int ROUNDED

The rounded button style.

See Also:

Constant Field Values

Constructor Detail

ButtonSprite

public ButtonSprite(Label label,
                    int style,
                    Color backgroundColor,
                    Color alternateColor,
                    String actionCommand,
                    Object commandArgument)

Constructs a button sprite.

Parameters:

label - the label to render on the button

style - the style of button to render (NORMAL or ROUNDED)

backgroundColor - the background color of the button

alternateColor - the alternate (outline) color

actionCommand - the button's command

commandArgument - the button's command argument

ButtonSprite

public ButtonSprite(Label label,
                    int style,
                    int arcWidth,
                    int arcHeight,
                    Color backgroundColor,
                    Color alternateColor,
                    String actionCommand,
                    Object commandArgument)

Constructs a button sprite.

Parameters:

label - the label to render on the button

style - the style of button to render (NORMAL or ROUNDED)

arcWidth - the width of the corner arcs for rounded buttons

arcHeight - the height of the corner arcs for rounded buttons

backgroundColor - the background color of the button

alternateColor - the alternate (outline) color

actionCommand - the button's command

commandArgument - the button's command argument

Method Detail

getLabel

public Label getLabel()

Returns a reference to the label displayed by this sprite.

updateBounds

public void updateBounds()

Updates this sprite's bounds after a change to the label.

setStyle

public void setStyle(int style)

Sets the style of this button.

getStyle

public int getStyle()

Returns the style of this button.

setArcWidth

public void setArcWidth(int arcWidth)

Sets the arc width for rounded buttons.

getArcWidth

public int getArcWidth()

Returns the arc width for rounded buttons.

setArcHeight

public void setArcHeight(int arcHeight)

Sets the arc height for rounded buttons.

getArcHeight

public int getArcHeight()

Returns the arc height for rounded buttons.

setBackgroundColor

public void setBackgroundColor(Color backgroundColor)

Sets the background color of this button.

getBackgroundColor

public Color getBackgroundColor()

Returns the background color of this button.

setActionCommand

public void setActionCommand(String actionCommand)

Sets the action command generated by this button.

getActionCommand

public String getActionCommand()

Specified by:

getActionCommand in interface ActionSprite

Returns:

the action command to submit if this sprite is clicked.

setCommandArgument

public void setCommandArgument(Object commandArgument)

Sets the command argument generated by this button.

getCommandArgument

public Object getCommandArgument()

Specified by:

getCommandArgument in interface CommandSprite

Returns:

the argument to the action command.

setEnabled

public void setEnabled(boolean enabled)

Sets whether or not this button is enabled.

isEnabled

public boolean isEnabled()

Specified by:

isEnabled in interface DisableableSprite

Returns:

true if this sprite is currently enabled.

setArmed

public void setArmed(boolean pressed)

Description copied from interface: ArmingSprite

Render this sprite such that is is drawn "armed".

Specified by:

setArmed in interface ArmingSprite

isArmed

public boolean isArmed()

Checks whether or not this button appears pressed.

paint

public void paint(Graphics2D gfx)

Description copied from class: AbstractMedia

Called by the appropriate manager to request that the media render itself with the given graphics context. The media may wish to inspect the clipping region that has been set on the graphics context to render itself more efficiently. This method will only be called after it has been established that this media's bounds intersect the clipping region.

Overrides:

paint in class Sprite