AbstractButton

Overview

Package

Class

Use

Deprecated

Index

Home >> All >> javax >> [ swing overview ]

PREV CLASS NEXT CLASS

SUMMARY:

JAVADOC |

Sourc code of javax.swing.AbstractButton

SOURCE |

DOWNLOAD | NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.swing
Class AbstractButton

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.AbstractButton

All Implemented Interfaces:: java.awt.image.ImageObserver, java.awt.ItemSelectable, java.awt.MenuContainer, java.io.Serializable, SwingConstants

Direct Known Subclasses:: JButton, JMenuItem, JToggleButton

public abstract class AbstractButton
extends JComponent
implements java.awt.ItemSelectable, SwingConstants

Provides an abstract implementation of common button behaviour, data model and look & feel.

This class is supposed to serve as a base class for several kinds of buttons with similar but non-identical semantics: toggle buttons (radio buttons and checkboxes), simple push buttons, menu items, etc.

Buttons have many properties, some of which are stored in this class while others are delegated to the button's model. The following properties are available:

Property	Stored in	Bound?
action	button	no
actionCommand	model	no
borderPainted	button	yes
contentAreaFilled	button	yes
disabledIcon	button	yes
disabledSelectedIcon	button	yes
displayedMnemonicIndex	button	no
enabled	model	no
focusPainted	button	yes
horizontalAlignment	button	yes
horizontalTextPosition	button	yes
icon	button	yes
iconTextGap	button	no
label (same as text)	model	yes
margin	button	yes
multiClickThreshold	button	no
pressedIcon	button	yes
rolloverEnabled	button	yes
rolloverIcon	button	yes
rolloverSelectedIcon	button	yes
selected	model	no
selectedIcon	button	yes
selectedObjects	button	no
text	model	yes
UI	button	yes
verticalAlignment	button	yes
verticalTextPosition	button	yes

The various behavioral aspects of these properties follows:

When non-bound properties stored in the button change, the button fires ChangeEvents to its ChangeListeners.
When bound properties stored in the button change, the button fires PropertyChangeEvents to its PropertyChangeListeners
If any of the model's properties change, it fires a ChangeEvent to its ChangeListeners, which include the button.
If the button receives a ChangeEvent from its model, it will propagate the ChangeEvent to its ChangeListeners, with the ChangeEvent's "source" property set to refer to the button, rather than the model. The the button will request a repaint, to paint its updated state.
If the model's "selected" property changes, the model will fire an ItemEvent to its ItemListeners, which include the button, in addition to the ChangeEvent which models the property change. The button propagates ItemEvents directly to its ItemListeners.
If the model's armed and pressed properties are simultaneously true, the model will fire an ActionEvent to its ActionListeners, which include the button. The button will propagate this ActionEvent to its ActionListeners, with the ActionEvent's "source" property set to refer to the button, rather than the model.

Nested Class Summary

protected class AbstractButton.AccessibleAbstractButton
          A Java Accessibility extension of the AbstractButton.

protected class AbstractButton.ButtonChangeListener
          An extension of ChangeListener to be serializable.

Nested classes inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes inherited from class java.awt.Component

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

Field Summary

(package private) Action action
          The action taken when the button is clicked.

protected java.awt.event.ActionListener actionListener
          Listener the button uses to receive ActionEvents from its model.

(package private) java.beans.PropertyChangeListener actionPropertyChangeListener
          Listener the button uses to receive PropertyChangeEvents from its Action.

static java.lang.String BORDER_PAINTED_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "borderPainted" property changes.

(package private) boolean borderPainted
          Whether or not the button paints its border.

protected javax.swing.event.ChangeEvent changeEvent
          ChangeEvent that is fired to button's ChangeEventListeners

protected javax.swing.event.ChangeListener changeListener
          Listener the button uses to receive ChangeEvents from its model.

private boolean clientBorderPaintedSet
          Indicates if the borderPainted property has been set by a client program or by the UI.

private boolean clientContentAreaFilledSet
          Indicates if the contentAreaFilled property has been set by a client program or by the UI.

private boolean clientIconTextGapSet
          Indicates if the iconTextGap property has been set by a client program or by the UI.

private boolean clientRolloverEnabledSet
          Indicates if the rolloverEnabled property has been set by a client program or by the UI.

static java.lang.String CONTENT_AREA_FILLED_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "contentAreaFilled" property changes.

(package private) boolean contentAreaFilled
          Whether or not the button fills its content area.

(package private) Icon current_icon
          The icon currently displayed.

(package private) Icon default_icon
          The icon displayed by default.

(package private) Icon disabeldIcon
          The icon displayed when the button is disabled.

static java.lang.String DISABLED_ICON_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "disabledIcon" property changes.

static java.lang.String DISABLED_SELECTED_ICON_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "disabledSelectedIcon" property changes.

(package private) Icon disabledSelectedIcon
          The icon displayed when the button is selected but disabled.

static java.lang.String FOCUS_PAINTED_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "focusPainted" property changes.

(package private) boolean focusPainted
          Whether or not the button paints its focus state.

static java.lang.String HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "horizontalAlignment" property changes.

static java.lang.String HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "horizontalTextPosition" property changes.

(package private) int horizontalAlignment
          The horizontal alignment of the button's text and icon.

(package private) int horizontalTextPosition
          The horizontal position of the button's text relative to its icon.

static java.lang.String ICON_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "icon" property changes.

(package private) int iconTextGap
          The gap between icon and text, if both icon and text are non-null.

protected java.awt.event.ItemListener itemListener
          Listener the button uses to receive ItemEvents from its model.

(package private) java.awt.Insets margin
          The margin between the button's border and its label.

static java.lang.String MARGIN_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "margin" property changes.

static java.lang.String MNEMONIC_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "mnemonic" property changes.

(package private) int mnemonicIndex
          A hint to the look and feel class, suggesting which character in the button's label should be underlined when drawing the label.

protected ButtonModel model
          The button's current state.

static java.lang.String MODEL_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "model" property changes.

(package private) long multiClickThreshhold
          The time in miliseconds in which clicks get coalesced into a single ActionEvent.

(package private) Icon pressed_icon
          The icon displayed when the button is pressed.

static java.lang.String PRESSED_ICON_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "pressedIcon" property changes.

static java.lang.String ROLLOVER_ENABLED_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "rolloverEnabled" property changes.

static java.lang.String ROLLOVER_ICON_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "rolloverIcon" property changes.

static java.lang.String ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "rolloverSelectedIcon" property changes.

(package private) boolean rollOverEnabled
          Whether rollover is enabled.

(package private) Icon rolloverIcon
          The icon displayed when the button is rolled over.

(package private) Icon rolloverSelectedIcon
          The icon displayed when the button is selected and rolled over.

static java.lang.String SELECTED_ICON_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "selectedIcon" property changes.

(package private) Icon selectedIcon
          The icon displayed when the button is selected.

private static long serialVersionUID


(package private) java.lang.String text
          The text displayed in the button.

static java.lang.String TEXT_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "text" property changes.

static java.lang.String VERTICAL_ALIGNMENT_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "verticalAlignment" property changes.

static java.lang.String VERTICAL_TEXT_POSITION_CHANGED_PROPERTY
          Fired in a PropertyChangeEvent when the "verticalTextPosition" property changes.

(package private) int verticalAlignment
          The vertical alignment of the button's text and icon.

(package private) int verticalTextPosition
          The vertical position of the button's text relative to its icon.

Fields inherited from class javax.swing.JComponent

accessibleContext, alignmentX, alignmentY, autoscrolls, border, debugGraphicsOptions, doubleBuffered, isCompletelyDirty, isPaintingDoubleBuffered, listenerList, maximumSize, minimumSize, opaque, preferredSize, requestFocusEnabled, TOOL_TIP_TEXT_KEY, toolTipText, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Container

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()
          Creates a new AbstractButton object.

Method Summary

void addActionListener(java.awt.event.ActionListener l)
          Adds an ActionListener to the button's listener list.

void addChangeListener(javax.swing.event.ChangeListener l)
          Adds a ChangeListener to the button's listener list.

protected void addImpl(java.awt.Component comp, java.lang.Object constraints, int index)
          Adds the specified component to this AbstractButton.

void addItemListener(java.awt.event.ItemListener l)
          Adds an ItemListener to the button's listener list.

protected int checkHorizontalKey(int key, java.lang.String exception)
          Verifies that a particular key is one of the valid constants used for describing horizontal alignment and positioning.

protected int checkVerticalKey(int key, java.lang.String exception)
          Verifies that a particular key is one of the valid constants used for describing vertical alignment and positioning.

protected void configurePropertiesFromAction(Action a)
          Configure various properties of the button by reading properties of an Action.

protected java.awt.event.ActionListener createActionListener()
          A factory method which should return an java.awt.event.ActionListener that propagates events from the button's ButtonModel to any of the button's ActionListeners.

protected java.beans.PropertyChangeListener createActionPropertyChangeListener(Action a)
          A factory method which should return a java.beans.PropertyChangeListener that accepts changes to the specified Action and reconfigure the AbstractButton, by default using the configurePropertiesFromAction(javax.swing.Action) 55 method.

protected javax.swing.event.ChangeListener createChangeListener()
          Factory method which creates a AbstractButton.ButtonChangeListener, used to subscribe to ChangeEvents from the button's model.

protected java.awt.event.ItemListener createItemListener()
          Factory method which creates a java.awt.event.ItemListener, used to subscribe to ItemEvents from the button's model.

void doClick()
          Programmatically perform a "click" on the button: arming, pressing, waiting, un-pressing, and disarming the model.

void doClick(int pressTime)
          Programmatically perform a "click" on the button: arming, pressing, waiting, un-pressing, and disarming the model.

protected void fireActionPerformed(java.awt.event.ActionEvent e)
          Calls ActionListener.actionPerformed(java.awt.event.ActionEvent)>ActionListener.actionPerformed(java.awt.event.ActionEvent) 55 on each java.awt.event.ActionListener in the button's listener list.

protected void fireItemStateChanged(java.awt.event.ItemEvent e)
          Calls ItemListener.itemStateChanged(java.awt.event.ItemEvent)>ItemListener.itemStateChanged(java.awt.event.ItemEvent) 55 on each ItemListener in the button's listener list.

protected void fireStateChanged()
          Calls AbstractButton.ButtonChangeListener.stateChanged(javax.swing.event.ChangeEvent) 55 on each AbstractButton.ButtonChangeListener in the button's listener list.

Action getAction()
          Get the value of the "action" property.

java.lang.String getActionCommand()
          Returns the action command string for this button's model.

java.awt.event.ActionListener[] getActionListeners()
          Returns all added ActionListener objects.

javax.swing.event.ChangeListener[] getChangeListeners()
          Returns all added ChangeListener objects.

Icon getDisabledIcon()
          Return the button's "disabledIcon" property.

Icon getDisabledSelectedIcon()
          Return the button's disabled selected icon.

int getDisplayedMnemonicIndex()
          Get the button's mnemonic index, which is an offset into the button's "text" property.

int getHorizontalAlignment()
          Set the horizontal alignment of the button's text and icon.

int getHorizontalTextPosition()
          Get the horizontal position of the button's text relative to its icon.

Icon getIcon()
          Return the button's default "icon" property.

int getIconTextGap()
          Get the value of the iconTextGap 55 property.

java.awt.event.ItemListener[] getItemListeners()
          Returns all added ItemListener objects.

java.lang.String getLabel()
          Deprecated. use getText()

java.awt.Insets getMargin()
          Return the button's "margin" property, which is an java.awt.Insets object describing the distance between the button's border and its text and icon.

int getMnemonic()
          Get the current keyboard mnemonic value.

ButtonModel getModel()
          Get the model the button is currently using.

long getMultiClickThreshhold()
          Returns the current time in milliseconds in which clicks gets coalesced into a single ActionEvent.

Icon getPressedIcon()
          Return the button's "pressedIcon" property.

Icon getRolloverIcon()
          Return the button's rollover icon.

Icon getRolloverSelectedIcon()
          Return the button's rollover selected icon.

Icon getSelectedIcon()
          Return the button's selected icon.

java.lang.Object[] getSelectedObjects()
          Returns an single-element array containing the "text" property of the button if the "selected" property of the button's model is true, otherwise returns null.

java.lang.String getText()
          Return the button's "text" property.

javax.swing.plaf.ButtonUI getUI()
          Set the "UI" property of the button, which is a look and feel class responsible for handling the button's input events and painting it.

int getVerticalAlignment()
          Get the vertical alignment of the button's text and icon.

int getVerticalTextPosition()
          Get the vertical position of the button's text relative to its icon.

boolean imageUpdate(java.awt.Image img, int infoflags, int x, int y, int w, int h)
          Called when image data becomes available for one of the button's icons.

protected void init(java.lang.String text, Icon icon)


boolean isBorderPainted()
          Set the value of the "borderPainted" property.

boolean isContentAreaFilled()
          Returns the value of the button's "contentAreaFilled" property.

boolean isFocusPainted()
          Return the button's "paintFocus" property.

boolean isRolloverEnabled()
          Returns whether or not rollover icon changes are enabled on the button.

boolean isSelected()
          Get the value of the button's "selected" property.

protected void paintBorder(java.awt.Graphics g)
          Paints the button's border, if the button's "borderPainted" property is true, by out calling to the button's look and feel class.

protected java.lang.String paramString()
          Returns a string, used only for debugging, which identifies or somehow represents this button.

void removeActionListener(java.awt.event.ActionListener l)
          Removes an ActionListener from the button's listener list.

void removeChangeListener(javax.swing.event.ChangeListener l)
          Removes a ChangeListener from the button's listener list.

void removeItemListener(java.awt.event.ItemListener l)
          Removes an ItemListener from the button's listener list.

void setAction(Action a)
          Set the button's "action" property, subscribing the new action to the button, as an ActionListener, if it is not already subscribed.

void setActionCommand(java.lang.String actionCommand)
          Sets the action command string for this button's model.

void setBorderPainted(boolean b)
          Set the value of the "borderPainted" property.

void setContentAreaFilled(boolean b)
          Sets the value of the button's "contentAreaFilled" property.

void setDisabledIcon(Icon d)
          Set the button's "disabledIcon" property.

void setDisabledSelectedIcon(Icon icon)
          Set the button's disabled selected icon.

void setDisplayedMnemonicIndex(int index)
          Sets the button's mnemonic index.

void setEnabled(boolean b)
          Enables or disables the button.

void setFocusPainted(boolean p)
          Set the button's "paintFocus" property.

void setHorizontalAlignment(int a)
          Set the horizontal alignment of the button's text and icon.

void setHorizontalTextPosition(int t)
          Set the horizontal position of the button's text relative to its icon.

void setIcon(Icon i)
          Set the button's default "icon" property.

void setIconTextGap(int i)
          Set the value of the iconTextGap 55 property.

void setLabel(java.lang.String label)
          Deprecated. use setText(text)

void setLayout(java.awt.LayoutManager layout)
          Sets a layout manager on this AbstractButton.

void setMargin(java.awt.Insets m)
          Set the button's "margin" property, which is an java.awt.Insets object describing the distance between the button's border and its text and icon.

void setMnemonic(char mne)
          Set the current keyboard mnemonic value.

void setMnemonic(int mne)
          Set the current keyboard mnemonic value.

void setModel(ButtonModel newModel)
          Set the model the button is currently using.

void setMultiClickThreshhold(long threshhold)
          Sets the time in milliseconds in which clicks gets coalesced into a single ActionEvent.

void setPressedIcon(Icon pressedIcon)
          Set the button's "pressedIcon" property.

void setRolloverEnabled(boolean r)
          Set the "rolloverEnabled" property.

void setRolloverIcon(Icon r)
          Set the button's rollover icon.

void setRolloverSelectedIcon(Icon r)
          Set the button's rollover selected icon.

void setSelected(boolean s)
          Set the value of the button's "selected" property.

void setSelectedIcon(Icon s)
          Set the button's selected icon.

void setText(java.lang.String t)
          Set the button's "text" property.

void setUI(javax.swing.plaf.ButtonUI ui)
          Set the "UI" property of the button, which is a look and feel class responsible for handling the button's input events and painting it.

(package private) void setUIProperty(java.lang.String propertyName, java.lang.Object value)
          Helper method for LookAndFeel.installProperty(JComponent, String, Object) 55 .

void setVerticalAlignment(int a)
          Set the vertical alignment of the button's text and icon.

void setVerticalTextPosition(int t)
          Set the vertical position of the button's text relative to its icon.

void updateUI()
          Set the "UI" property to a class constructed, via the UIManager, from the current look and feel.

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, fireAncestorEvent, 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, 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, paintImmediately2, paintSimple, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, 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, updateComponentInputMap

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, 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, 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, getPropertyChangeListeners, getPropertyChangeListeners, 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, 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

serialVersionUID

private static final long serialVersionUID

See Also:: Constant Field Values

default_icon

Icon default_icon

The icon displayed by default.

pressed_icon

Icon pressed_icon

The icon displayed when the button is pressed.

disabeldIcon

Icon disabeldIcon

The icon displayed when the button is disabled.

selectedIcon

Icon selectedIcon

The icon displayed when the button is selected.

disabledSelectedIcon

Icon disabledSelectedIcon

The icon displayed when the button is selected but disabled.

rolloverIcon

Icon rolloverIcon

The icon displayed when the button is rolled over.

rolloverSelectedIcon

Icon rolloverSelectedIcon

The icon displayed when the button is selected and rolled over.

current_icon

Icon current_icon

The icon currently displayed.

text

java.lang.String text

The text displayed in the button.

iconTextGap

int iconTextGap

The gap between icon and text, if both icon and text are non-null.

verticalAlignment

int verticalAlignment

The vertical alignment of the button's text and icon.

horizontalAlignment

int horizontalAlignment

The horizontal alignment of the button's text and icon.

horizontalTextPosition

int horizontalTextPosition

The horizontal position of the button's text relative to its icon.

verticalTextPosition

int verticalTextPosition

The vertical position of the button's text relative to its icon.

borderPainted

boolean borderPainted

Whether or not the button paints its border.

focusPainted

boolean focusPainted

Whether or not the button paints its focus state.

contentAreaFilled

boolean contentAreaFilled

Whether or not the button fills its content area.

rollOverEnabled

boolean rollOverEnabled

Whether rollover is enabled.

action

Action action

The action taken when the button is clicked.

model

protected ButtonModel model

The button's current state.

margin

java.awt.Insets margin

The margin between the button's border and its label.

mnemonicIndex

int mnemonicIndex

A hint to the look and feel class, suggesting which character in the button's label should be underlined when drawing the label.

actionListener

protected java.awt.event.ActionListener actionListener

Listener the button uses to receive ActionEvents from its model.

itemListener

protected java.awt.event.ItemListener itemListener

Listener the button uses to receive ItemEvents from its model.

changeListener

protected javax.swing.event.ChangeListener changeListener

Listener the button uses to receive ChangeEvents from its model.

multiClickThreshhold

long multiClickThreshhold

The time in miliseconds in which clicks get coalesced into a single ActionEvent.

actionPropertyChangeListener

java.beans.PropertyChangeListener actionPropertyChangeListener

Listener the button uses to receive PropertyChangeEvents from its Action.

changeEvent

protected javax.swing.event.ChangeEvent changeEvent

ChangeEvent that is fired to button's ChangeEventListeners

clientBorderPaintedSet

private boolean clientBorderPaintedSet

Indicates if the borderPainted property has been set by a client program or by the UI.

See Also:: setUIProperty(String, Object) 55 , LookAndFeel.installProperty(JComponent, String, Object) 55

clientRolloverEnabledSet

private boolean clientRolloverEnabledSet

Indicates if the rolloverEnabled property has been set by a client program or by the UI.

See Also:: setUIProperty(String, Object) 55 , LookAndFeel.installProperty(JComponent, String, Object) 55

clientIconTextGapSet

private boolean clientIconTextGapSet

Indicates if the iconTextGap property has been set by a client program or by the UI.

See Also:: setUIProperty(String, Object) 55 , LookAndFeel.installProperty(JComponent, String, Object) 55

clientContentAreaFilledSet

private boolean clientContentAreaFilledSet

Indicates if the contentAreaFilled property has been set by a client program or by the UI.

See Also:: setUIProperty(String, Object) 55 , LookAndFeel.installProperty(JComponent, String, Object) 55

BORDER_PAINTED_CHANGED_PROPERTY

public static final java.lang.String BORDER_PAINTED_CHANGED_PROPERTY

Fired in a PropertyChangeEvent when the "borderPainted" property changes.

See Also:: Constant Field Values

CONTENT_AREA_FILLED_CHANGED_PROPERTY

public static final java.lang.String CONTENT_AREA_FILLED_CHANGED_PROPERTY

Fired in a PropertyChangeEvent when the "contentAreaFilled" property changes.

See Also:: Constant Field Values

DISABLED_ICON_CHANGED_PROPERTY

public static final java.lang.String DISABLED_ICON_CHANGED_PROPERTY

Fired in a PropertyChangeEvent when the "disabledIcon" property changes.

See Also:: Constant Field Values

DISABLED_SELECTED_ICON_CHANGED_PROPERTY

public static final java.lang.String DISABLED_SELECTED_ICON_CHANGED_PROPERTY

Fired in a PropertyChangeEvent when the "disabledSelectedIcon" property changes.

See Also:: Constant Field Values

FOCUS_PAINTED_CHANGED_PROPERTY

public static final java.lang.String FOCUS_PAINTED_CHANGED_PROPERTY

Fired in a PropertyChangeEvent when the "focusPainted" property changes.

See Also:: Constant Field Values

HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY

public static final java.lang.String HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY

Fired in a PropertyChangeEvent when the "horizontalAlignment" property changes.

See Also:: Constant Field Values

HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY

public static final java.lang.String HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY

Fired in a PropertyChangeEvent when the "horizontalTextPosition" property changes.

See Also:: Constant Field Values

ICON_CHANGED_PROPERTY

public stat

Nested Class Summary
`protected class`	`AbstractButton.AccessibleAbstractButton` A Java Accessibility extension of the AbstractButton.
`protected class`	`AbstractButton.ButtonChangeListener` An extension of ChangeListener to be serializable.

Field Summary
`(package private) Action`	`action` The action taken when the button is clicked.
`protected java.awt.event.ActionListener`	`actionListener` Listener the button uses to receive ActionEvents from its model.
`(package private) java.beans.PropertyChangeListener`	`actionPropertyChangeListener` Listener the button uses to receive PropertyChangeEvents from its Action.
`static java.lang.String`	`BORDER_PAINTED_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "borderPainted" property changes.
`(package private) boolean`	`borderPainted` Whether or not the button paints its border.
`protected javax.swing.event.ChangeEvent`	`changeEvent` ChangeEvent that is fired to button's ChangeEventListeners
`protected javax.swing.event.ChangeListener`	`changeListener` Listener the button uses to receive ChangeEvents from its model.
`private boolean`	`clientBorderPaintedSet` Indicates if the borderPainted property has been set by a client program or by the UI.
`private boolean`	`clientContentAreaFilledSet` Indicates if the contentAreaFilled property has been set by a client program or by the UI.
`private boolean`	`clientIconTextGapSet` Indicates if the iconTextGap property has been set by a client program or by the UI.
`private boolean`	`clientRolloverEnabledSet` Indicates if the rolloverEnabled property has been set by a client program or by the UI.
`static java.lang.String`	`CONTENT_AREA_FILLED_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "contentAreaFilled" property changes.
`(package private) boolean`	`contentAreaFilled` Whether or not the button fills its content area.
`(package private) Icon`	`current_icon` The icon currently displayed.
`(package private) Icon`	`default_icon` The icon displayed by default.
`(package private) Icon`	`disabeldIcon` The icon displayed when the button is disabled.
`static java.lang.String`	`DISABLED_ICON_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "disabledIcon" property changes.
`static java.lang.String`	`DISABLED_SELECTED_ICON_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "disabledSelectedIcon" property changes.
`(package private) Icon`	`disabledSelectedIcon` The icon displayed when the button is selected but disabled.
`static java.lang.String`	`FOCUS_PAINTED_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "focusPainted" property changes.
`(package private) boolean`	`focusPainted` Whether or not the button paints its focus state.
`static java.lang.String`	`HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "horizontalAlignment" property changes.
`static java.lang.String`	`HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "horizontalTextPosition" property changes.
`(package private) int`	`horizontalAlignment` The horizontal alignment of the button's text and icon.
`(package private) int`	`horizontalTextPosition` The horizontal position of the button's text relative to its icon.
`static java.lang.String`	`ICON_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "icon" property changes.
`(package private) int`	`iconTextGap` The gap between icon and text, if both icon and text are non-`null`.
`protected java.awt.event.ItemListener`	`itemListener` Listener the button uses to receive ItemEvents from its model.
`(package private) java.awt.Insets`	`margin` The margin between the button's border and its label.
`static java.lang.String`	`MARGIN_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "margin" property changes.
`static java.lang.String`	`MNEMONIC_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "mnemonic" property changes.
`(package private) int`	`mnemonicIndex` A hint to the look and feel class, suggesting which character in the button's label should be underlined when drawing the label.
`protected ButtonModel`	`model` The button's current state.
`static java.lang.String`	`MODEL_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "model" property changes.
`(package private) long`	`multiClickThreshhold` The time in miliseconds in which clicks get coalesced into a single `ActionEvent`.
`(package private) Icon`	`pressed_icon` The icon displayed when the button is pressed.
`static java.lang.String`	`PRESSED_ICON_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "pressedIcon" property changes.
`static java.lang.String`	`ROLLOVER_ENABLED_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "rolloverEnabled" property changes.
`static java.lang.String`	`ROLLOVER_ICON_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "rolloverIcon" property changes.
`static java.lang.String`	`ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "rolloverSelectedIcon" property changes.
`(package private) boolean`	`rollOverEnabled` Whether rollover is enabled.
`(package private) Icon`	`rolloverIcon` The icon displayed when the button is rolled over.
`(package private) Icon`	`rolloverSelectedIcon` The icon displayed when the button is selected and rolled over.
`static java.lang.String`	`SELECTED_ICON_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "selectedIcon" property changes.
`(package private) Icon`	`selectedIcon` The icon displayed when the button is selected.
`private static long`	`serialVersionUID`
`(package private) java.lang.String`	`text` The text displayed in the button.
`static java.lang.String`	`TEXT_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "text" property changes.
`static java.lang.String`	`VERTICAL_ALIGNMENT_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "verticalAlignment" property changes.
`static java.lang.String`	`VERTICAL_TEXT_POSITION_CHANGED_PROPERTY` Fired in a PropertyChangeEvent when the "verticalTextPosition" property changes.
`(package private) int`	`verticalAlignment` The vertical alignment of the button's text and icon.
`(package private) int`	`verticalTextPosition` The vertical position of the button's text relative to its icon.

Constructor Summary
`AbstractButton()` Creates a new AbstractButton object.

Method Summary
`void`	`addActionListener(java.awt.event.ActionListener l)` Adds an ActionListener to the button's listener list.
`void`	`addChangeListener(javax.swing.event.ChangeListener l)` Adds a ChangeListener to the button's listener list.
`protected void`	`addImpl(java.awt.Component comp, java.lang.Object constraints, int index)` Adds the specified component to this AbstractButton.
`void`	`addItemListener(java.awt.event.ItemListener l)` Adds an ItemListener to the button's listener list.
`protected int`	`checkHorizontalKey(int key, java.lang.String exception)` Verifies that a particular key is one of the valid constants used for describing horizontal alignment and positioning.
`protected int`	`checkVerticalKey(int key, java.lang.String exception)` Verifies that a particular key is one of the valid constants used for describing vertical alignment and positioning.
`protected void`	`configurePropertiesFromAction(Action a)` Configure various properties of the button by reading properties of an Action.
`protected java.awt.event.ActionListener`	`createActionListener()` A factory method which should return an java.awt.event.ActionListener that propagates events from the button's ButtonModel to any of the button's ActionListeners.
`protected java.beans.PropertyChangeListener`	`createActionPropertyChangeListener(Action a)` A factory method which should return a java.beans.PropertyChangeListener that accepts changes to the specified Action and reconfigure the AbstractButton, by default using the `configurePropertiesFromAction(javax.swing.Action)` 55 method.
`protected javax.swing.event.ChangeListener`	`createChangeListener()` Factory method which creates a AbstractButton.ButtonChangeListener, used to subscribe to ChangeEvents from the button's model.
`protected java.awt.event.ItemListener`	`createItemListener()` Factory method which creates a java.awt.event.ItemListener, used to subscribe to ItemEvents from the button's model.
`void`	`doClick()` Programmatically perform a "click" on the button: arming, pressing, waiting, un-pressing, and disarming the model.
`void`	`doClick(int pressTime)` Programmatically perform a "click" on the button: arming, pressing, waiting, un-pressing, and disarming the model.
`protected void`	`fireActionPerformed(java.awt.event.ActionEvent e)` Calls ActionListener.actionPerformed(java.awt.event.ActionEvent)>`ActionListener.actionPerformed(java.awt.event.ActionEvent)` 55 on each java.awt.event.ActionListener in the button's listener list.
`protected void`	`fireItemStateChanged(java.awt.event.ItemEvent e)` Calls ItemListener.itemStateChanged(java.awt.event.ItemEvent)>`ItemListener.itemStateChanged(java.awt.event.ItemEvent)` 55 on each ItemListener in the button's listener list.
`protected void`	`fireStateChanged()` Calls `AbstractButton.ButtonChangeListener.stateChanged(javax.swing.event.ChangeEvent)` 55 on each AbstractButton.ButtonChangeListener in the button's listener list.
`Action`	`getAction()` Get the value of the "action" property.
`java.lang.String`	`getActionCommand()` Returns the action command string for this button's model.
`java.awt.event.ActionListener[]`	`getActionListeners()` Returns all added `ActionListener` objects.
`javax.swing.event.ChangeListener[]`	`getChangeListeners()` Returns all added `ChangeListener` objects.
`Icon`	`getDisabledIcon()` Return the button's "disabledIcon" property.
`Icon`	`getDisabledSelectedIcon()` Return the button's disabled selected icon.
`int`	`getDisplayedMnemonicIndex()` Get the button's mnemonic index, which is an offset into the button's "text" property.
`int`	`getHorizontalAlignment()` Set the horizontal alignment of the button's text and icon.
`int`	`getHorizontalTextPosition()` Get the horizontal position of the button's text relative to its icon.
`Icon`	`getIcon()` Return the button's default "icon" property.
`int`	`getIconTextGap()` Get the value of the `iconTextGap` 55 property.
`java.awt.event.ItemListener[]`	`getItemListeners()` Returns all added `ItemListener` objects.
`java.lang.String`	`getLabel()` Deprecated. use `getText()`
`java.awt.Insets`	`getMargin()` Return the button's "margin" property, which is an java.awt.Insets object describing the distance between the button's border and its text and icon.
`int`	`getMnemonic()` Get the current keyboard mnemonic value.
`ButtonModel`	`getModel()` Get the model the button is currently using.
`long`	`getMultiClickThreshhold()` Returns the current time in milliseconds in which clicks gets coalesced into a single `ActionEvent`.
`Icon`	`getPressedIcon()` Return the button's "pressedIcon" property.
`Icon`	`getRolloverIcon()` Return the button's rollover icon.
`Icon`	`getRolloverSelectedIcon()` Return the button's rollover selected icon.
`Icon`	`getSelectedIcon()` Return the button's selected icon.
`java.lang.Object[]`	`getSelectedObjects()` Returns an single-element array containing the "text" property of the button if the "selected" property of the button's model is `true`, otherwise returns `null`.
`java.lang.String`	`getText()` Return the button's "text" property.
`javax.swing.plaf.ButtonUI`	`getUI()` Set the "UI" property of the button, which is a look and feel class responsible for handling the button's input events and painting it.
`int`	`getVerticalAlignment()` Get the vertical alignment of the button's text and icon.
`int`	`getVerticalTextPosition()` Get the vertical position of the button's text relative to its icon.
`boolean`	`imageUpdate(java.awt.Image img, int infoflags, int x, int y, int w, int h)` Called when image data becomes available for one of the button's icons.
`protected void`	`init(java.lang.String text, Icon icon)`
`boolean`	`isBorderPainted()` Set the value of the "borderPainted" property.
`boolean`	`isContentAreaFilled()` Returns the value of the button's "contentAreaFilled" property.
`boolean`	`isFocusPainted()` Return the button's "paintFocus" property.
`boolean`	`isRolloverEnabled()` Returns whether or not rollover icon changes are enabled on the button.
`boolean`	`isSelected()` Get the value of the button's "selected" property.
`protected void`	`paintBorder(java.awt.Graphics g)` Paints the button's border, if the button's "borderPainted" property is `true`, by out calling to the button's look and feel class.
`protected java.lang.String`	`paramString()` Returns a string, used only for debugging, which identifies or somehow represents this button.
`void`	`removeActionListener(java.awt.event.ActionListener l)` Removes an ActionListener from the button's listener list.
`void`	`removeChangeListener(javax.swing.event.ChangeListener l)` Removes a ChangeListener from the button's listener list.
`void`	`removeItemListener(java.awt.event.ItemListener l)` Removes an ItemListener from the button's listener list.
`void`	`setAction(Action a)` Set the button's "action" property, subscribing the new action to the button, as an ActionListener, if it is not already subscribed.
`void`	`setActionCommand(java.lang.String actionCommand)` Sets the action command string for this button's model.
`void`	`setBorderPainted(boolean b)` Set the value of the "borderPainted" property.
`void`	`setContentAreaFilled(boolean b)` Sets the value of the button's "contentAreaFilled" property.
`void`	`setDisabledIcon(Icon d)` Set the button's "disabledIcon" property.
`void`	`setDisabledSelectedIcon(Icon icon)` Set the button's disabled selected icon.
`void`	`setDisplayedMnemonicIndex(int index)` Sets the button's mnemonic index.
`void`	`setEnabled(boolean b)` Enables or disables the button.
`void`	`setFocusPainted(boolean p)` Set the button's "paintFocus" property.
`void`	`setHorizontalAlignment(int a)` Set the horizontal alignment of the button's text and icon.
`void`	`setHorizontalTextPosition(int t)` Set the horizontal position of the button's text relative to its icon.
`void`	`setIcon(Icon i)` Set the button's default "icon" property.
`void`	`setIconTextGap(int i)` Set the value of the `iconTextGap` 55 property.
`void`	`setLabel(java.lang.String label)` Deprecated. use `setText(text)`
`void`	`setLayout(java.awt.LayoutManager layout)` Sets a layout manager on this AbstractButton.
`void`	`setMargin(java.awt.Insets m)` Set the button's "margin" property, which is an java.awt.Insets object describing the distance between the button's border and its text and icon.
`void`	`setMnemonic(char mne)` Set the current keyboard mnemonic value.
`void`	`setMnemonic(int mne)` Set the current keyboard mnemonic value.
`void`	`setModel(ButtonModel newModel)` Set the model the button is currently using.
`void`	`setMultiClickThreshhold(long threshhold)` Sets the time in milliseconds in which clicks gets coalesced into a single `ActionEvent`.
`void`	`setPressedIcon(Icon pressedIcon)` Set the button's "pressedIcon" property.
`void`	`setRolloverEnabled(boolean r)` Set the "rolloverEnabled" property.
`void`	`setRolloverIcon(Icon r)` Set the button's rollover icon.
`void`	`setRolloverSelectedIcon(Icon r)` Set the button's rollover selected icon.
`void`	`setSelected(boolean s)` Set the value of the button's "selected" property.
`void`	`setSelectedIcon(Icon s)` Set the button's selected icon.
`void`	`setText(java.lang.String t)` Set the button's "text" property.
`void`	`setUI(javax.swing.plaf.ButtonUI ui)` Set the "UI" property of the button, which is a look and feel class responsible for handling the button's input events and painting it.
`(package private) void`	`setUIProperty(java.lang.String propertyName, java.lang.Object value)` Helper method for `LookAndFeel.installProperty(JComponent, String, Object)` 55 .
`void`	`setVerticalAlignment(int a)` Set the vertical alignment of the button's text and icon.
`void`	`setVerticalTextPosition(int t)` Set the vertical position of the button's text relative to its icon.
`void`	`updateUI()` Set the "UI" property to a class constructed, via the UIManager, from the current look and feel.

javax.swing Class AbstractButton