xal.extension.widgets.swing.wheelswitch.comp

Class SimpleButton

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JLabel

xal.extension.widgets.swing.wheelswitch.comp.ResizableTextLabel

xal.extension.widgets.swing.wheelswitch.comp.GradientLabel

xal.extension.widgets.swing.wheelswitch.comp.SimpleButton

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible, javax.swing.SwingConstants

Direct Known Subclasses:

ArrowButton, Digit

public class SimpleButton
extends GradientLabel

A very simple implementation of a button. It supports three action modes identified by: DEFAULT_ACTION_MODE - the button fires one event when the user clicks (presses and releases) the left mouse button inside the area of the button. CHAIN_ACTION_MODE - the button fires one event when the user presses the left mouse button inside the area of the button and continues firing events at a constant rate until the user releases the button or moves outside the button area. NULL_ACTION_MODE - the button fires no events at all.

See Also:

GradientLabel, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SimpleButton.PanelFlushBorder A clean border that visually raises the component above its surroundings.

Nested classes/interfaces inherited from class xal.extension.widgets.swing.wheelswitch.comp.ResizableTextLabel

ResizableTextLabel.ResizableAdapter

Nested classes/interfaces inherited from class javax.swing.JLabel

javax.swing.JLabel.AccessibleJLabel

Nested classes/interfaces inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
static int	CHAIN_ACTION_MODE DOCUMENT ME!
static int	DEFAULT_ACTION_MODE DOCUMENT ME!
static int	FAST_ACTION_MODE DOCUMENT ME!
protected static java.lang.String	MOUSE_CHAIN
protected static java.lang.String	MOUSE_CLICKED
protected static java.lang.String	MOUSE_PRESSED
protected static java.lang.String	MOUSE_RELEASED
static int	NULL_ACTION_MODE DOCUMENT ME!

Fields inherited from class javax.swing.JLabel

labelFor

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
SimpleButton() Creates a simple button without text .
SimpleButton(javax.swing.Icon icon) Creates a simple button with Icon.
SimpleButton(java.lang.String text) Creates a simple button with text.

Method Summary

Modifier and Type	Method and Description
void	addActionListener(java.awt.event.ActionListener l) Adds an action listener to the list of registered listeners for this button.
void	addNotify() DOCUMENT ME!
protected void	fireActionPerformed(java.awt.event.ActionEvent e) Fires an action event to all its listeners
int	getActionMode() Returns the currently set action mode.
java.awt.Color	getBackground() Overriden for rendering purposes.
java.awt.Color	getBackgroundStart() Overriden for rendering purposes.
javax.swing.border.Border	getBorder() Overriden for rendering purposes.
int	getFireRate() Gets the rate of event firing in the CHAIN_MODE
java.awt.Color	getForeground() Overriden for rendering purposes.
java.awt.Color	getPressedBackground() Gets the background color displayed when the button is pressed.
java.awt.Color	getPressedBackgroundStart() Gets the starting background gradient color displayed when the button is pressed.
javax.swing.border.Border	getPressedBorder() Gets the border displayed when the button is pressed.
java.awt.Color	getPressedForeground() Gets the foreground color displayed when the button is pressed.
java.awt.Color	getRolloverBackground() Gets the background color displayed when the mouse cursor is over the button and rollover is enabled.
java.awt.Color	getRolloverBackgroundStart() Gets the start of background gradient color displayed when the mouse cursor is over the button and rollover is enabled.
javax.swing.border.Border	getRolloverBorder() Gets the border displayed when the mouse cursor is over the button and rollover is enabled.
java.awt.Color	getRolloverForeground() Gets the foreground color displayed when the mouse cursor is over the button and rollover is enabled.
boolean	isPressed() Gets the property specifiing whether the button is being pressed.
boolean	isRollover() Gets the property specifiing whether the mouse is being moved over the button.
boolean	isRolloverEnabled() Returns wether this SimpleButton visually indicates when mouse is over it.
protected void	paintBorder(java.awt.Graphics g) This method was overloaded to enable advanced graphical features of the SimpleButton
void	paintComponent(java.awt.Graphics g) This method was overloaded to enable advanced graphical features of the SimpleButton
void	removeActionListener(java.awt.event.ActionListener l) Removes an action listener from the list of registered listeners for this button.
void	removeNotify() DOCUMENT ME!
void	setActionMode(int newMode) Sets the action mode of the SimpleButton.
void	setBackground(java.awt.Color newColor) Overriden for rendering purposes.
void	setBackgroundStart(java.awt.Color newColor) Overriden for rendering purposes.
void	setBorder(javax.swing.border.Border newBorder) Overriden for rendering purposes.
void	setFireRate(int newRate) Sets the rate of event firing in the CHAIN_MODE
void	setForeground(java.awt.Color newColor) Overriden for rendering purposes.
protected void	setPressed(boolean newPressed) Returns the property specifiing whether the button is being pressed.
void	setPressedBackground(java.awt.Color newColor) Sets the background color displayed when the button is pressed.
void	setPressedBackgroundStart(java.awt.Color newColor) Sets the starting background gradient color displayed when the button is pressed.
void	setPressedBorder(javax.swing.border.Border newBorder) Sets the border displayed when the button is pressed.
void	setPressedForeground(java.awt.Color newColor) Sets the foreground color displayed when the button is pressed.
protected void	setRollover(boolean newRollover) Sets the property specifiing whether the mouse is being moved over the button.
void	setRolloverBackground(java.awt.Color newColor) Sets the background color displayed when the mouse cursor is over the button and rollover is enabled.
void	setRolloverBackgroundStart(java.awt.Color newColor) Sets the start of background gradient color displayed when the mouse cursor is over the button and rollover is enabled.
void	setRolloverBorder(javax.swing.border.Border newBorder) Sets the border displayed when the mouse cursor is over the button and rollover is enabled.
void	setRolloverEnabled(boolean enabled) Enables or disables visual indication when mouse is over this SimpleButton.
void	setRolloverForeground(java.awt.Color newColor) Sets the foreground color displayed when the mouse cursor is over the button and rollover is enabled.
void	setVisible(boolean visible) DOCUMENT ME!

Methods inherited from class xal.extension.widgets.swing.wheelswitch.comp.GradientLabel

isGradientEnabled, setGradientEnabled, setGradientPoints

Methods inherited from class xal.extension.widgets.swing.wheelswitch.comp.ResizableTextLabel

getColumns, getMinimumSize, getPreferredSize, isEnhanced, isResizable, resize, setColumns, setEnhanced, setMinimumSize, setPreferredSize, setResizable, setText

Methods inherited from class javax.swing.JLabel

checkHorizontalKey, checkVerticalKey, getAccessibleContext, getDisabledIcon, getDisplayedMnemonic, getDisplayedMnemonicIndex, getHorizontalAlignment, getHorizontalTextPosition, getIcon, getIconTextGap, getLabelFor, getText, getUI, getUIClassID, getVerticalAlignment, getVerticalTextPosition, imageUpdate, paramString, setDisabledIcon, setDisplayedMnemonic, setDisplayedMnemonic, setDisplayedMnemonicIndex, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setIconTextGap, setLabelFor, setUI, setVerticalAlignment, setVerticalTextPosition, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setNextFocusableComponent, setOpaque, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

MOUSE_PRESSED

protected static final java.lang.String MOUSE_PRESSED

See Also:

Constant Field Values

MOUSE_CLICKED

protected static final java.lang.String MOUSE_CLICKED

See Also:

Constant Field Values

MOUSE_RELEASED

protected static final java.lang.String MOUSE_RELEASED

See Also:

Constant Field Values

MOUSE_CHAIN

protected static final java.lang.String MOUSE_CHAIN

See Also:

Constant Field Values

NULL_ACTION_MODE

public static final int NULL_ACTION_MODE

DOCUMENT ME!

See Also:

Constant Field Values

DEFAULT_ACTION_MODE

public static final int DEFAULT_ACTION_MODE

DOCUMENT ME!

See Also:

Constant Field Values

CHAIN_ACTION_MODE

public static final int CHAIN_ACTION_MODE

DOCUMENT ME!

See Also:

Constant Field Values

FAST_ACTION_MODE

public static final int FAST_ACTION_MODE

DOCUMENT ME!

See Also:

Constant Field Values

Constructor Detail

SimpleButton

public SimpleButton(java.lang.String text)

Creates a simple button with text.

Parameters:

text - java.lang.String to be displayed on the button.

SimpleButton

public SimpleButton(javax.swing.Icon icon)

Creates a simple button with Icon.

Parameters:

icon - javax.swing.Icon to be displayed on the button.

SimpleButton

public SimpleButton()

Creates a simple button without text .

Method Detail

setActionMode

public void setActionMode(int newMode)

Sets the action mode of the SimpleButton. DEFAULT_ACTION_MODE fires ActionEvent when left mouse button is clicked. CHAIN_ACTION_MODE fires a series of ActionEvent while left mouse button is being pressed at the fireRate. FAST_ACTION_MODE fires ActionEvent when left mouse button is pressed. NULL_ACTION_MODE fires no ActionEvents on mouse actions but pressing the ENTER key still triggers ActionEvents.

Parameters:

newMode - to be set.

Throws:

java.lang.IllegalArgumentException - if the value entered is not one of DEFAULT_ACTION_MODE, CHAIN_ACTION_MODE, FAST_ACTION_MODE or NULL_ACTION_MODE.

getActionMode

public int getActionMode()

Returns the currently set action mode.

Returns:

int used action mode.

setBackground

public void setBackground(java.awt.Color newColor)

Overriden for rendering purposes.

Overrides:

setBackground in class GradientLabel

Parameters:

newColor - Color

See Also:

GradientLabel.setBackground(Color)

getBackground

public java.awt.Color getBackground()

Overriden for rendering purposes.

Overrides:

getBackground in class java.awt.Component

Returns:

Color

See Also:

Component.getBackground()

setForeground

public void setForeground(java.awt.Color newColor)

Overriden for rendering purposes.

Overrides:

setForeground in class javax.swing.JComponent

Parameters:

newColor - Color

See Also:

JComponent.setForeground(Color)

getForeground

public java.awt.Color getForeground()

Overriden for rendering purposes.

Overrides:

getForeground in class java.awt.Component

Returns:

Color

See Also:

Component.getForeground()

getBackgroundStart

public java.awt.Color getBackgroundStart()

Overriden for rendering purposes.

Overrides:

getBackgroundStart in class GradientLabel

Returns:

Color

See Also:

GradientLabel.getBackgroundStart()

setBackgroundStart

public void setBackgroundStart(java.awt.Color newColor)

Overriden for rendering purposes.

Overrides:

setBackgroundStart in class GradientLabel

Parameters:

newColor - Color

See Also:

GradientLabel.setBackgroundStart(Color)

setBorder

public void setBorder(javax.swing.border.Border newBorder)

Overriden for rendering purposes.

Overrides:

setBorder in class javax.swing.JComponent

Parameters:

newBorder - Border

See Also:

JComponent.setBorder(Border)

getBorder

public javax.swing.border.Border getBorder()

Overriden for rendering purposes.

Overrides:

getBorder in class javax.swing.JComponent

Returns:

Border

See Also:

JComponent.getBorder()

getPressedBackground

public java.awt.Color getPressedBackground()

Gets the background color displayed when the button is pressed.

Returns:

Color

setPressedBackground

public void setPressedBackground(java.awt.Color newColor)

Sets the background color displayed when the button is pressed.

Parameters:

newColor - Color

getPressedForeground

public java.awt.Color getPressedForeground()

Gets the foreground color displayed when the button is pressed.

Returns:

Color

setPressedForeground

public void setPressedForeground(java.awt.Color newColor)

Sets the foreground color displayed when the button is pressed.

Parameters:

newColor - Color

getPressedBackgroundStart

public java.awt.Color getPressedBackgroundStart()

Gets the starting background gradient color displayed when the button is pressed.

Returns:

Color

setPressedBackgroundStart

public void setPressedBackgroundStart(java.awt.Color newColor)

Sets the starting background gradient color displayed when the button is pressed.

Parameters:

newColor - Color

getPressedBorder

public javax.swing.border.Border getPressedBorder()

Gets the border displayed when the button is pressed.

Returns:

Border

setPressedBorder

public void setPressedBorder(javax.swing.border.Border newBorder)

Sets the border displayed when the button is pressed.

Parameters:

newBorder - Border

getRolloverBackground

public java.awt.Color getRolloverBackground()

Gets the background color displayed when the mouse cursor is over the button and rollover is enabled.

Returns:

Color

setRolloverBackground

public void setRolloverBackground(java.awt.Color newColor)

Sets the background color displayed when the mouse cursor is over the button and rollover is enabled.

Parameters:

newColor - Color

getRolloverForeground

public java.awt.Color getRolloverForeground()

Gets the foreground color displayed when the mouse cursor is over the button and rollover is enabled.

Returns:

Color

setRolloverForeground

public void setRolloverForeground(java.awt.Color newColor)

Sets the foreground color displayed when the mouse cursor is over the button and rollover is enabled.

Parameters:

newColor - Color

getRolloverBackgroundStart

public java.awt.Color getRolloverBackgroundStart()

Gets the start of background gradient color displayed when the mouse cursor is over the button and rollover is enabled.

Returns:

Color

setRolloverBackgroundStart

public void setRolloverBackgroundStart(java.awt.Color newColor)

Sets the start of background gradient color displayed when the mouse cursor is over the button and rollover is enabled.

Parameters:

newColor - Color

getRolloverBorder

public javax.swing.border.Border getRolloverBorder()

Gets the border displayed when the mouse cursor is over the button and rollover is enabled.

Returns:

Border

setRolloverBorder

public void setRolloverBorder(javax.swing.border.Border newBorder)

Sets the border displayed when the mouse cursor is over the button and rollover is enabled.

Parameters:

newBorder - Border

setRolloverEnabled

public void setRolloverEnabled(boolean enabled)

Enables or disables visual indication when mouse is over this SimpleButton.

Parameters:

enabled - boolean whether this SimpleButton should indicate when mouse is over it.

isRolloverEnabled

public boolean isRolloverEnabled()

Returns wether this SimpleButton visually indicates when mouse is over it.

Returns:

boolean true if rollover indication is enabled, false otherwise.

setFireRate

public void setFireRate(int newRate)

Sets the rate of event firing in the CHAIN_MODE

Parameters:

newRate - int time in miliseconds between successive events are fired.

getFireRate

public int getFireRate()

Gets the rate of event firing in the CHAIN_MODE

Returns:

int

isPressed

public boolean isPressed()

Gets the property specifiing whether the button is being pressed.

Returns:

boolean

setPressed

protected void setPressed(boolean newPressed)

Returns the property specifiing whether the button is being pressed.

Parameters:

newPressed - boolean

isRollover

public boolean isRollover()

Gets the property specifiing whether the mouse is being moved over the button.

Returns:

boolean

setRollover

protected void setRollover(boolean newRollover)

Sets the property specifiing whether the mouse is being moved over the button.

Parameters:

newRollover - boolean

fireActionPerformed

protected void fireActionPerformed(java.awt.event.ActionEvent e)

Fires an action event to all its listeners

Parameters:

e - ActionEvent

addActionListener

public void addActionListener(java.awt.event.ActionListener l)

Adds an action listener to the list of registered listeners for this button.

Parameters:

l - ActionListener

removeActionListener

public void removeActionListener(java.awt.event.ActionListener l)

Removes an action listener from the list of registered listeners for this button.

Parameters:

l - ActionListener

paintComponent

public void paintComponent(java.awt.Graphics g)

This method was overloaded to enable advanced graphical features of the SimpleButton

Overrides:

paintComponent in class GradientLabel

Parameters:

g - Graphics

See Also:

GradientLabel.paintComponent(Graphics)

paintBorder

protected void paintBorder(java.awt.Graphics g)

This method was overloaded to enable advanced graphical features of the SimpleButton

Overrides:

paintBorder in class javax.swing.JComponent

Parameters:

g - Graphics

See Also:

JComponent.paintBorder(Graphics)

addNotify

public void addNotify()

DOCUMENT ME!

Overrides:

addNotify in class ResizableTextLabel

See Also:

JComponent.addNotify()

removeNotify

public void removeNotify()

DOCUMENT ME!

Overrides:

removeNotify in class javax.swing.JComponent

setVisible

public void setVisible(boolean visible)

DOCUMENT ME!

Overrides:

setVisible in class javax.swing.JComponent

Parameters:

visible - DOCUMENT ME!