JavaTM 2 Platform
Std. Ed. v1.4.2

javax.swing
Class AbstractButton

java.lang.Object
  extended byjava.awt.Component
      extended byjava.awt.Container
          extended byjavax.swing.JComponent
              extended byjavax.swing.AbstractButton
All Implemented Interfaces:
ImageObserver, ItemSelectable, MenuContainer, Serializable, SwingConstants
Direct Known Subclasses:
JButton, JMenuItem, JToggleButton

public abstract class AbstractButton
extends JComponent
implements ItemSelectable, SwingConstants

Defines common behaviors for buttons and menu items. For further information see How to Use Buttons, Check Boxes, and Radio Buttons, a section in The Java Tutorial.

Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeansTM has been added to the java.beans package. Please see XMLEncoder.


Nested Class Summary
protected  class AbstractButton.AccessibleAbstractButton
          This class implements accessibility support for the AbstractButton class.
protected  class AbstractButton.ButtonChangeListener
          Extends ChangeListener to be serializable.
 
Nested classes inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent
 
Nested classes inherited from class java.awt.Container
Container.AccessibleAWTContainer
 
Nested classes inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
Field Summary
protected  ActionListener actionListener
          The button model's ActionListener.
static String BORDER_PAINTED_CHANGED_PROPERTY
          Identifies a change to having the border drawn, or having it not drawn.
protected  ChangeEvent changeEvent
          Only one ChangeEvent is needed per button instance since the event's only state is the source property.
protected  ChangeListener changeListener
          The button model's changeListener.
static String CONTENT_AREA_FILLED_CHANGED_PROPERTY
          Identifies a change to having the button paint the content area.
static String DISABLED_ICON_CHANGED_PROPERTY
          Identifies a change to the icon used when the button has been disabled.
static String DISABLED_SELECTED_ICON_CHANGED_PROPERTY
          Identifies a change to the icon used when the button has been disabled and selected.
static String FOCUS_PAINTED_CHANGED_PROPERTY
          Identifies a change to having the border highlighted when focused, or not.
static String HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY
          Identifies a change in the button's horizontal alignment.
static String HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY
          Identifies a change in the button's horizontal text position.
static String ICON_CHANGED_PROPERTY
          Identifies a change to the icon that represents the button.
protected  ItemListener itemListener
          The button model's ItemListener.
static String MARGIN_CHANGED_PROPERTY
          Identifies a change in the button's margins.
static String MNEMONIC_CHANGED_PROPERTY
          Identifies a change to the button's mnemonic.
protected  ButtonModel model
          The data model that determines the button's state.
static String MODEL_CHANGED_PROPERTY
          Identifies a change in the button model.
static String PRESSED_ICON_CHANGED_PROPERTY
          Identifies a change to the icon used when the button has been pressed.
static String ROLLOVER_ENABLED_CHANGED_PROPERTY
          Identifies a change from rollover enabled to disabled or back to enabled.
static String ROLLOVER_ICON_CHANGED_PROPERTY
          Identifies a change to the icon used when the cursor is over the button.
static String ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY
          Identifies a change to the icon used when the cursor is over the button and it has been selected.
static String SELECTED_ICON_CHANGED_PROPERTY
          Identifies a change to the icon used when the button has been selected.
static String TEXT_CHANGED_PROPERTY
          Identifies a change in the button's text.
static String VERTICAL_ALIGNMENT_CHANGED_PROPERTY
          Identifies a change in the button's vertical alignment.
static String VERTICAL_TEXT_POSITION_CHANGED_PROPERTY
          Identifies a change in the button's vertical text position.
 
Fields inherited from class javax.swing.JComponent
accessibleContext, 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
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
AbstractButton()
           
 
Method Summary
 void addActionListener(ActionListener l)
          Adds an ActionListener to the button.
 void addChangeListener(ChangeListener l)
          Adds a ChangeListener to the button.
 void addItemListener(ItemListener l)
          Adds an ItemListener to the checkbox.
protected  int checkHorizontalKey(int key, String exception)
          Verify that key is a legal value for the horizontalAlignment properties.
protected  int checkVerticalKey(int key, String exception)
          Ensures that the key is a valid.
protected  void configurePropertiesFromAction(Action a)
          Factory method which sets the ActionEvent source's properties according to values from the Action instance.
protected  ActionListener createActionListener()
           
protected  PropertyChangeListener createActionPropertyChangeListener(Action a)
          Factory method which creates the PropertyChangeListener used to update the ActionEvent source as properties change on its Action instance.
protected  ChangeListener createChangeListener()
          Subclasses that want to handle ChangeEvents differently can override this to return another ChangeListener implementation.
protected  ItemListener createItemListener()
           
 void doClick()
          Programmatically perform a "click".
 void doClick(int pressTime)
          Programmatically perform a "click".
protected  void fireActionPerformed(ActionEvent event)
          Notifies all listeners that have registered interest for notification on this event type.
protected  void fireItemStateChanged(ItemEvent event)
          Notifies all listeners that have registered interest for notification on this event type.
protected  void fireStateChanged()
          Notifies all listeners that have registered interest for notification on this event type.
 Action getAction()
          Returns the currently set Action for this ActionEvent source, or null if no Action is set.
 String getActionCommand()
          Returns the action command for this button.
 ActionListener[] getActionListeners()
          Returns an array of all the ActionListeners added to this AbstractButton with addActionListener().
 ChangeListener[] getChangeListeners()
          Returns an array of all the ChangeListeners added to this AbstractButton with addChangeListener().
 Icon getDisabledIcon()
          Returns the icon used by the button when it's disabled.
 Icon getDisabledSelectedIcon()
          Returns the icon used by the button when it's disabled and selected.
 int getDisplayedMnemonicIndex()
          Returns the character, as an index, that the look and feel should provide decoration for as representing the mnemonic character.
 int getHorizontalAlignment()
          Returns the horizontal alignment of the icon and text.
 int getHorizontalTextPosition()
          Returns the horizontal position of the text relative to the icon.
 Icon getIcon()
          Returns the default icon.
 int getIconTextGap()
          Returns the amount of space between the text and the icon displayed in this button.
 ItemListener[] getItemListeners()
          Returns an array of all the ItemListeners added to this AbstractButton with addItemListener().
 String getLabel()
          Deprecated. - Replaced by getText
 Insets getMargin()
          Returns the margin between the button's border and the label.
 int getMnemonic()
          Returns the keyboard mnemonic from the the current model.
 ButtonModel getModel()
          Returns the model that this button represents.
 long getMultiClickThreshhold()
          Gets the amount of time (in milliseconds) required between mouse press events for the button to generate the corresponding action events.
 Icon getPressedIcon()
          Returns the pressed icon for the button.
 Icon getRolloverIcon()
          Returns the rollover icon for the button.
 Icon getRolloverSelectedIcon()
          Returns the rollover selection icon for the button.
 Icon getSelectedIcon()
          Returns the selected icon for the button.
 Object[] getSelectedObjects()
          Returns an array (length 1) containing the label or null if the button is not selected.
 String getText()
          Returns the button's text.
 ButtonUI getUI()
          Returns the L&F object that renders this component.
 int getVerticalAlignment()
          Returns the vertical alignment of the text and icon.
 int getVerticalTextPosition()
          Returns the vertical position of the text relative to the icon.
 boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
          This is overridden to return false if the current Icon's Image is not equal to the passed in Image img.
protected  void init(String text, Icon icon)
           
 boolean isBorderPainted()
          Gets the borderPainted property.
 boolean isContentAreaFilled()
          Gets the contentAreaFilled property.
 boolean isFocusPainted()
          Gets the paintFocus property.
 boolean isRolloverEnabled()
          Gets the rolloverEnabled property.
 boolean isSelected()
          Returns the state of the button.
protected  void paintBorder(Graphics g)
          Paint the button's border if BorderPainted property is true and the button has a border.
protected  String paramString()
          Returns a string representation of this AbstractButton.
 void removeActionListener(ActionListener l)
          Removes an ActionListener from the button.
 void removeChangeListener(ChangeListener l)
          Removes a ChangeListener from the button.
 void removeItemListener(ItemListener l)
          Removes an ItemListener from the button.
 void setAction(Action a)
          Sets the Action for the ActionEvent source.
 void setActionCommand(String actionCommand)
          Sets the action command for this button.
 void setBorderPainted(boolean b)
          Sets the borderPainted property.
 void setContentAreaFilled(boolean b)
          Sets the contentAreaFilled property.
 void setDisabledIcon(Icon disabledIcon)
          Sets the disabled icon for the button.
 void setDisabledSelectedIcon(Icon disabledSelectedIcon)
          Sets the disabled selection icon for the button.
 void setDisplayedMnemonicIndex(int index)
          Provides a hint to the look and feel as to which character in the text should be decorated to represent the mnemonic.
 void setEnabled(boolean b)
          Enables (or disables) the button.
 void setFocusPainted(boolean b)
          Sets the paintFocus property, which must be true for the focus state to be painted.
 void setHorizontalAlignment(int alignment)
          Sets the horizontal alignment of the icon and text.
 void setHorizontalTextPosition(int textPosition)
          Sets the horizontal position of the text relative to the icon.
 void setIcon(Icon defaultIcon)
          Sets the button's default icon.
 void setIconTextGap(int iconTextGap)
          If both the icon and text properties are set, this property defines the space between them.
 void setLabel(String label)
          Deprecated. - Replaced by setText(text)
 void setMargin(Insets m)
          Sets space for margin between the button's border and the label.
 void setMnemonic(char mnemonic)
          This method is now obsolete, please use setMnemonic(int) to set the mnemonic for a button.
 void setMnemonic(int mnemonic)
          Sets the keyboard mnemonic on the current model.
 void setModel(ButtonModel newModel)
          Sets the model that this button represents.
 void setMultiClickThreshhold(long threshhold)
          Sets the amount of time (in milliseconds) required between mouse press events for the button to generate the corresponding action events.
 void setPressedIcon(Icon pressedIcon)
          Sets the pressed icon for the button.
 void setRolloverEnabled(boolean b)
          Sets the rolloverEnabled property, which must be true for rollover effects to occur.
 void setRolloverIcon(Icon rolloverIcon)
          Sets the rollover icon for the button.
 void setRolloverSelectedIcon(Icon rolloverSelectedIcon)
          Sets the rollover selected icon for the button.
 void setSelected(boolean b)
          Sets the state of the button.
 void setSelectedIcon(Icon selectedIcon)
          Sets the selected icon for the button.
 void setText(String text)
          Sets the button's text.
 void setUI(ButtonUI ui)
          Sets the L&F object that renders this component.
 void setVerticalAlignment(int alignment)
          Sets the vertical alignment of the icon and text.
 void setVerticalTextPosition(int textPosition)
          Sets the vertical position of the text relative to the icon.
 void updateUI()
          Resets the UI property to a value from the current look and feel.
 
Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getAccessibleContext, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setLayout, transferFocusBackward, 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, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, 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, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

MODEL_CHANGED_PROPERTY

public static final String MODEL_CHANGED_PROPERTY
Identifies a change in the button model.

See Also:
Constant Field Values

TEXT_CHANGED_PROPERTY

public static final String TEXT_CHANGED_PROPERTY
Identifies a change in the button's text.

See Also:
Constant Field Values

MNEMONIC_CHANGED_PROPERTY

public static final String MNEMONIC_CHANGED_PROPERTY
Identifies a change to the button's mnemonic.

See Also:
Constant Field Values

MARGIN_CHANGED_PROPERTY

public static final String MARGIN_CHANGED_PROPERTY
Identifies a change in the button's margins.

See Also:
Constant Field Values

VERTICAL_ALIGNMENT_CHANGED_PROPERTY

public static final String VERTICAL_ALIGNMENT_CHANGED_PROPERTY
Identifies a change in the button's vertical alignment.

See Also:
Constant Field Values

HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY

public static final String HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY
Identifies a change in the button's horizontal alignment.

See Also:
Constant Field Values

VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

public static final String VERTICAL_TEXT_POSITION_CHANGED_PROPERTY
Identifies a change in the button's vertical text position.

See Also:
Constant Field Values

HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY

public static final String HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY
Identifies a change in the button's horizontal text position.

See Also:
Constant Field Values

BORDER_PAINTED_CHANGED_PROPERTY

public static final String BORDER_PAINTED_CHANGED_PROPERTY
Identifies a change to having the border drawn, or having it not drawn.

See Also:
Constant Field Values

FOCUS_PAINTED_CHANGED_PROPERTY

public static final String FOCUS_PAINTED_CHANGED_PROPERTY
Identifies a change to having the border highlighted when focused, or not.

See Also:
Constant Field Values

ROLLOVER_ENABLED_CHANGED_PROPERTY

public static final String ROLLOVER_ENABLED_CHANGED_PROPERTY
Identifies a change from rollover enabled to disabled or back to enabled.

See Also:
Constant Field Values

CONTENT_AREA_FILLED_CHANGED_PROPERTY

public static final String CONTENT_AREA_FILLED_CHANGED_PROPERTY
Identifies a change to having the button paint the content area.

See Also:
Constant Field Values

ICON_CHANGED_PROPERTY

public static final String ICON_CHANGED_PROPERTY
Identifies a change to the icon that represents the button.

See Also:
Constant Field Values

PRESSED_ICON_CHANGED_PROPERTY

public static final String PRESSED_ICON_CHANGED_PROPERTY
Identifies a change to the icon used when the button has been pressed.

See Also:
Constant Field Values

SELECTED_ICON_CHANGED_PROPERTY

public static final String SELECTED_ICON_CHANGED_PROPERTY
Identifies a change to the icon used when the button has been selected.

See Also:
Constant Field Values

ROLLOVER_ICON_CHANGED_PROPERTY

public static final String ROLLOVER_ICON_CHANGED_PROPERTY
Identifies a change to the icon used when the cursor is over the button.

See Also:
Constant Field Values

ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY

public static final String ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY
Identifies a change to the icon used when the cursor is over the button and it has been selected.

See Also:
Constant Field Values

DISABLED_ICON_CHANGED_PROPERTY

public static final String DISABLED_ICON_CHANGED_PROPERTY
Identifies a change to the icon used when the button has been disabled.

See Also:
Constant Field Values

DISABLED_SELECTED_ICON_CHANGED_PROPERTY

public static final String DISABLED_SELECTED_ICON_CHANGED_PROPERTY
Identifies a change to the icon used when the button has been disabled and selected.

See Also:
Constant Field Values

model

protected ButtonModel model
The data model that determines the button's state.


changeListener

protected ChangeListener changeListener
The button model's changeListener.


actionListener

protected ActionListener actionListener
The button model's ActionListener.


itemListener

protected ItemListener itemListener
The button model's ItemListener.


changeEvent

protected transient ChangeEvent changeEvent
Only one ChangeEvent is needed per button instance since the event's only state is the source property. The source of events generated is always "this".

Constructor Detail

AbstractButton

public AbstractButton()
Method Detail

getText

public String getText()
Returns the button's text.

Returns:
the buttons text
See Also:
setText(java.lang.String)

setText

public void setText(String text)
Sets the button's text.

Parameters:
text - the string used to set the text
See Also:
getText()

isSelected

public boolean isSelected()
Returns the state of the button. True if the toggle button is selected, false if it's not.

Returns:
true if the toggle button is selected, otherwise false

setSelected

public void setSelected(boolean b)
Sets the state of the button. Note that this method does not trigger an actionEvent. Call doClick to perform a programatic action change.

Parameters:
b - true if the button is selected, otherwise false

doClick

public void doClick()
Programmatically perform a "click". This does the same thing as if the user had pressed and released the button.


doClick

public void doClick(int pressTime)
Programmatically perform a "click". This does the same thing as if the user had pressed and released the button. The button stays visually "pressed" for pressTime milliseconds.

Parameters:
pressTime - the time to "hold down" the button, in milliseconds

setMargin

public void setMargin(Insets m)
Sets space for margin between the button's border and the label. Setting to null will cause the button to use the default margin. The button's default Border object will use this value to create the proper margin. However, if a non-default border is set on the button, it is that Border object's responsibility to create the appropriate margin space (else this property will effectively be ignored).

Parameters:
m - the space between the border and the label

getMargin

public Insets getMargin()
Returns the margin between the button's border and the label.

Returns:
an Insets object specifying the margin between the botton's border and the label
See Also:
setMargin(java.awt.Insets)

getIcon

public Icon getIcon()
Returns the default icon.

Returns:
the default Icon
See Also:
setIcon(javax.swing.Icon)

setIcon

public void setIcon(Icon defaultIcon)
Sets the button's default icon. This icon is also used as the "pressed" and "disabled" icon if there is no explicitly set pressed icon.

Parameters:
defaultIcon - the icon used as the default image
See Also:
getIcon(), setPressedIcon(javax.swing.Icon)

getPressedIcon

public Icon getPressedIcon()
Returns the pressed icon for the button.

Returns:
the pressedIcon property
See Also:
setPressedIcon(javax.swing.Icon)

setPressedIcon

public void setPressedIcon(Icon pressedIcon)
Sets the pressed icon for the button.

Parameters:
pressedIcon - the icon used as the "pressed" image
See Also:
getPressedIcon()

getSelectedIcon

public Icon getSelectedIcon()
Returns the selected icon for the button.

Returns:
the selectedIcon property
See Also:
setSelectedIcon(javax.swing.Icon)

setSelectedIcon

public void setSelectedIcon(Icon selectedIcon)
Sets the selected icon for the button.

Parameters:
selectedIcon - the icon used as the "selected" image
See Also:
getSelectedIcon()

getRolloverIcon

public Icon getRolloverIcon()
Returns the rollover icon for the button.

Returns:
the rolloverIcon property
See Also:
setRolloverIcon(javax.swing.Icon)

setRolloverIcon

public void setRolloverIcon(Icon rolloverIcon)
Sets the rollover icon for the button.

Parameters:
rolloverIcon - the icon used as the "rollover" image
See Also:
getRolloverIcon()

getRolloverSelectedIcon

public Icon getRolloverSelectedIcon()
Returns the rollover selection icon for the button.

Returns:
the rolloverSelectedIcon property
See Also:
setRolloverSelectedIcon(javax.swing.Icon)

setRolloverSelectedIcon

public void setRolloverSelectedIcon(Icon rolloverSelectedIcon)
Sets the rollover selected icon for the button.

Parameters:
rolloverSelectedIcon - the icon used as the "selected rollover" image
See Also:
getRolloverSelectedIcon()

getDisabledIcon

public Icon getDisabledIcon()
Returns the icon used by the button when it's disabled. If no disabled icon has been set, the button constructs one from the default icon.

Returns:
the disabledIcon property
See Also:
getPressedIcon(), setDisabledIcon(javax.swing.Icon)

setDisabledIcon

public void setDisabledIcon(Icon disabledIcon)
Sets the disabled icon for the button.

Parameters:
disabledIcon - the icon used as the disabled image
See Also:
getDisabledIcon()

getDisabledSelectedIcon

public Icon getDisabledSelectedIcon()
Returns the icon used by the button when it's disabled and selected. If not no disabled selection icon has been set, the button constructs one from the selection icon.

Returns:
the disabledSelectedIcon property
See Also:
getPressedIcon(), setDisabledIcon(javax.swing.Icon)

setDisabledSelectedIcon

public void setDisabledSelectedIcon(Icon disabledSelectedIcon)
Sets the disabled selection icon for the button.

Parameters:
disabledSelectedIcon - the icon used as the disabled selection image
See Also:
getDisabledSelectedIcon()

getVerticalAlignment

public int getVerticalAlignment()
Returns the vertical alignment of the text and icon.

Returns:
the verticalAlignment property, one of the following values:
  • SwingConstants.CENTER (the default)
  • SwingConstants.TOP
  • SwingConstants.BOTTOM

setVerticalAlignment

public void setVerticalAlignment(int alignment)
Sets the vertical alignment of the icon and text.

Parameters:
alignment - one of the following values:
  • SwingConstants.CENTER (the default)
  • SwingConstants.TOP
  • SwingConstants.BOTTOM

getHorizontalAlignment

public int getHorizontalAlignment()
Returns the horizontal alignment of the icon and text.

Returns:
the horizontalAlignment property, one of the following values:
  • SwingConstants.RIGHT (the default)
  • SwingConstants.LEFT
  • SwingConstants.CENTER
  • SwingConstants.LEADING
  • SwingConstants.TRAILING

setHorizontalAlignment

public void setHorizontalAlignment(int alignment)
Sets the horizontal alignment of the icon and text.

Parameters:
alignment - one of the following values:
  • SwingConstants.RIGHT (the default)
  • SwingConstants.LEFT
  • SwingConstants.CENTER
  • SwingConstants.LEADING
  • SwingConstants.TRAILING

getVerticalTextPosition

public int getVerticalTextPosition()
Returns the ver