AbstractButton (Java SE 15 & JDK 15) (original) (raw)

All Implemented Interfaces:

[ImageObserver](../../java/awt/image/ImageObserver.html "interface in java.awt.image"), [ItemSelectable](../../java/awt/ItemSelectable.html "interface in java.awt"), [MenuContainer](../../java/awt/MenuContainer.html "interface in java.awt"), [Serializable](../../../java.base/java/io/Serializable.html "interface in java.io"), [SwingConstants](SwingConstants.html "interface in javax.swing")

Direct Known Subclasses:

[JButton](JButton.html "class in javax.swing"), [JMenuItem](JMenuItem.html "class in javax.swing"), [JToggleButton](JToggleButton.html "class in javax.swing")

@JavaBean(defaultProperty="UI") public abstract class AbstractButton extends JComponent implements ItemSelectable, SwingConstants

Defines common behaviors for buttons and menu items.

Buttons can be configured, and to some degree controlled, by[Action](Action.html)s. Using anAction with a button has many benefits beyond directly configuring a button. Refer to Swing Components Supporting Action for more details, and you can find more information in How to Use Actions, a section in The Java Tutorial.

For further information seeHow 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 JavaBeans has been added to the java.beans package. Please see XMLEncoder.

Since:

1.2

• Nested Class Summary

• Field Summary

Fields

Fields declared in interface javax.swing.SwingConstants

[BOTTOM](SwingConstants.html#BOTTOM), [CENTER](SwingConstants.html#CENTER), [EAST](SwingConstants.html#EAST), [HORIZONTAL](SwingConstants.html#HORIZONTAL), [LEADING](SwingConstants.html#LEADING), [LEFT](SwingConstants.html#LEFT), [NEXT](SwingConstants.html#NEXT), [NORTH](SwingConstants.html#NORTH), [NORTH_EAST](SwingConstants.html#NORTH%5FEAST), [NORTH_WEST](SwingConstants.html#NORTH%5FWEST), [PREVIOUS](SwingConstants.html#PREVIOUS), [RIGHT](SwingConstants.html#RIGHT), [SOUTH](SwingConstants.html#SOUTH), [SOUTH_EAST](SwingConstants.html#SOUTH%5FEAST), [SOUTH_WEST](SwingConstants.html#SOUTH%5FWEST), [TOP](SwingConstants.html#TOP), [TRAILING](SwingConstants.html#TRAILING), [VERTICAL](SwingConstants.html#VERTICAL), [WEST](SwingConstants.html#WEST)

• Constructor Summary

Constructors

• Method Summary

Methods declared in class javax.swing.JComponent

[addAncestorListener](JComponent.html#addAncestorListener%28javax.swing.event.AncestorListener%29), [addNotify](JComponent.html#addNotify%28%29), [addVetoableChangeListener](JComponent.html#addVetoableChangeListener%28java.beans.VetoableChangeListener%29), [computeVisibleRect](JComponent.html#computeVisibleRect%28java.awt.Rectangle%29), [contains](JComponent.html#contains%28int,int%29), [createToolTip](JComponent.html#createToolTip%28%29), [disable](JComponent.html#disable%28%29), [enable](JComponent.html#enable%28%29), [firePropertyChange](JComponent.html#firePropertyChange%28java.lang.String,boolean,boolean%29), [firePropertyChange](JComponent.html#firePropertyChange%28java.lang.String,int,int%29), [fireVetoableChange](JComponent.html#fireVetoableChange%28java.lang.String,java.lang.Object,java.lang.Object%29), [getActionForKeyStroke](JComponent.html#getActionForKeyStroke%28javax.swing.KeyStroke%29), [getActionMap](JComponent.html#getActionMap%28%29), [getAlignmentX](JComponent.html#getAlignmentX%28%29), [getAlignmentY](JComponent.html#getAlignmentY%28%29), [getAncestorListeners](JComponent.html#getAncestorListeners%28%29), [getAutoscrolls](JComponent.html#getAutoscrolls%28%29), [getBaseline](JComponent.html#getBaseline%28int,int%29), [getBaselineResizeBehavior](JComponent.html#getBaselineResizeBehavior%28%29), [getBorder](JComponent.html#getBorder%28%29), [getBounds](JComponent.html#getBounds%28java.awt.Rectangle%29), [getClientProperty](JComponent.html#getClientProperty%28java.lang.Object%29), [getComponentGraphics](JComponent.html#getComponentGraphics%28java.awt.Graphics%29), [getComponentPopupMenu](JComponent.html#getComponentPopupMenu%28%29), [getConditionForKeyStroke](JComponent.html#getConditionForKeyStroke%28javax.swing.KeyStroke%29), [getDebugGraphicsOptions](JComponent.html#getDebugGraphicsOptions%28%29), [getDefaultLocale](JComponent.html#getDefaultLocale%28%29), [getFontMetrics](JComponent.html#getFontMetrics%28java.awt.Font%29), [getGraphics](JComponent.html#getGraphics%28%29), [getHeight](JComponent.html#getHeight%28%29), [getInheritsPopupMenu](JComponent.html#getInheritsPopupMenu%28%29), [getInputMap](JComponent.html#getInputMap%28%29), [getInputMap](JComponent.html#getInputMap%28int%29), [getInputVerifier](JComponent.html#getInputVerifier%28%29), [getInsets](JComponent.html#getInsets%28%29), [getInsets](JComponent.html#getInsets%28java.awt.Insets%29), [getListeners](JComponent.html#getListeners%28java.lang.Class%29), [getLocation](JComponent.html#getLocation%28java.awt.Point%29), [getMaximumSize](JComponent.html#getMaximumSize%28%29), [getMinimumSize](JComponent.html#getMinimumSize%28%29), [getNextFocusableComponent](JComponent.html#getNextFocusableComponent%28%29), [getPopupLocation](JComponent.html#getPopupLocation%28java.awt.event.MouseEvent%29), [getPreferredSize](JComponent.html#getPreferredSize%28%29), [getRegisteredKeyStrokes](JComponent.html#getRegisteredKeyStrokes%28%29), [getRootPane](JComponent.html#getRootPane%28%29), [getSize](JComponent.html#getSize%28java.awt.Dimension%29), [getToolTipLocation](JComponent.html#getToolTipLocation%28java.awt.event.MouseEvent%29), [getToolTipText](JComponent.html#getToolTipText%28%29), [getToolTipText](JComponent.html#getToolTipText%28java.awt.event.MouseEvent%29), [getTopLevelAncestor](JComponent.html#getTopLevelAncestor%28%29), [getTransferHandler](JComponent.html#getTransferHandler%28%29), [getUIClassID](JComponent.html#getUIClassID%28%29), [getVerifyInputWhenFocusTarget](JComponent.html#getVerifyInputWhenFocusTarget%28%29), [getVetoableChangeListeners](JComponent.html#getVetoableChangeListeners%28%29), [getVisibleRect](JComponent.html#getVisibleRect%28%29), [getWidth](JComponent.html#getWidth%28%29), [getX](JComponent.html#getX%28%29), [getY](JComponent.html#getY%28%29), [grabFocus](JComponent.html#grabFocus%28%29), [hide](JComponent.html#hide%28%29), [isDoubleBuffered](JComponent.html#isDoubleBuffered%28%29), [isLightweightComponent](JComponent.html#isLightweightComponent%28java.awt.Component%29), [isManagingFocus](JComponent.html#isManagingFocus%28%29), [isOpaque](JComponent.html#isOpaque%28%29), [isOptimizedDrawingEnabled](JComponent.html#isOptimizedDrawingEnabled%28%29), [isPaintingForPrint](JComponent.html#isPaintingForPrint%28%29), [isPaintingOrigin](JComponent.html#isPaintingOrigin%28%29), [isPaintingTile](JComponent.html#isPaintingTile%28%29), [isRequestFocusEnabled](JComponent.html#isRequestFocusEnabled%28%29), [isValidateRoot](JComponent.html#isValidateRoot%28%29), [paint](JComponent.html#paint%28java.awt.Graphics%29), [paintChildren](JComponent.html#paintChildren%28java.awt.Graphics%29), [paintComponent](JComponent.html#paintComponent%28java.awt.Graphics%29), [paintImmediately](JComponent.html#paintImmediately%28int,int,int,int%29), [paintImmediately](JComponent.html#paintImmediately%28java.awt.Rectangle%29), [print](JComponent.html#print%28java.awt.Graphics%29), [printAll](JComponent.html#printAll%28java.awt.Graphics%29), [printBorder](JComponent.html#printBorder%28java.awt.Graphics%29), [printChildren](JComponent.html#printChildren%28java.awt.Graphics%29), [printComponent](JComponent.html#printComponent%28java.awt.Graphics%29), [processComponentKeyEvent](JComponent.html#processComponentKeyEvent%28java.awt.event.KeyEvent%29), [processKeyBinding](JComponent.html#processKeyBinding%28javax.swing.KeyStroke,java.awt.event.KeyEvent,int,boolean%29), [processKeyEvent](JComponent.html#processKeyEvent%28java.awt.event.KeyEvent%29), [processMouseEvent](JComponent.html#processMouseEvent%28java.awt.event.MouseEvent%29), [processMouseMotionEvent](JComponent.html#processMouseMotionEvent%28java.awt.event.MouseEvent%29), [putClientProperty](JComponent.html#putClientProperty%28java.lang.Object,java.lang.Object%29), [registerKeyboardAction](JComponent.html#registerKeyboardAction%28java.awt.event.ActionListener,java.lang.String,javax.swing.KeyStroke,int%29), [registerKeyboardAction](JComponent.html#registerKeyboardAction%28java.awt.event.ActionListener,javax.swing.KeyStroke,int%29), [removeAncestorListener](JComponent.html#removeAncestorListener%28javax.swing.event.AncestorListener%29), [removeVetoableChangeListener](JComponent.html#removeVetoableChangeListener%28java.beans.VetoableChangeListener%29), [repaint](JComponent.html#repaint%28long,int,int,int,int%29), [repaint](JComponent.html#repaint%28java.awt.Rectangle%29), [requestDefaultFocus](JComponent.html#requestDefaultFocus%28%29), [requestFocus](JComponent.html#requestFocus%28%29), [requestFocus](JComponent.html#requestFocus%28boolean%29), [requestFocusInWindow](JComponent.html#requestFocusInWindow%28%29), [requestFocusInWindow](JComponent.html#requestFocusInWindow%28boolean%29), [resetKeyboardActions](JComponent.html#resetKeyboardActions%28%29), [reshape](JComponent.html#reshape%28int,int,int,int%29), [revalidate](JComponent.html#revalidate%28%29), [scrollRectToVisible](JComponent.html#scrollRectToVisible%28java.awt.Rectangle%29), [setActionMap](JComponent.html#setActionMap%28javax.swing.ActionMap%29), [setAlignmentX](JComponent.html#setAlignmentX%28float%29), [setAlignmentY](JComponent.html#setAlignmentY%28float%29), [setAutoscrolls](JComponent.html#setAutoscrolls%28boolean%29), [setBackground](JComponent.html#setBackground%28java.awt.Color%29), [setBorder](JComponent.html#setBorder%28javax.swing.border.Border%29), [setComponentPopupMenu](JComponent.html#setComponentPopupMenu%28javax.swing.JPopupMenu%29), [setDebugGraphicsOptions](JComponent.html#setDebugGraphicsOptions%28int%29), [setDefaultLocale](JComponent.html#setDefaultLocale%28java.util.Locale%29), [setDoubleBuffered](JComponent.html#setDoubleBuffered%28boolean%29), [setFocusTraversalKeys](JComponent.html#setFocusTraversalKeys%28int,java.util.Set%29), [setFont](JComponent.html#setFont%28java.awt.Font%29), [setForeground](JComponent.html#setForeground%28java.awt.Color%29), [setInheritsPopupMenu](JComponent.html#setInheritsPopupMenu%28boolean%29), [setInputMap](JComponent.html#setInputMap%28int,javax.swing.InputMap%29), [setInputVerifier](JComponent.html#setInputVerifier%28javax.swing.InputVerifier%29), [setMaximumSize](JComponent.html#setMaximumSize%28java.awt.Dimension%29), [setMinimumSize](JComponent.html#setMinimumSize%28java.awt.Dimension%29), [setNextFocusableComponent](JComponent.html#setNextFocusableComponent%28java.awt.Component%29), [setOpaque](JComponent.html#setOpaque%28boolean%29), [setPreferredSize](JComponent.html#setPreferredSize%28java.awt.Dimension%29), [setRequestFocusEnabled](JComponent.html#setRequestFocusEnabled%28boolean%29), [setToolTipText](JComponent.html#setToolTipText%28java.lang.String%29), [setTransferHandler](JComponent.html#setTransferHandler%28javax.swing.TransferHandler%29), [setUI](JComponent.html#setUI%28javax.swing.plaf.ComponentUI%29), [setVerifyInputWhenFocusTarget](JComponent.html#setVerifyInputWhenFocusTarget%28boolean%29), [setVisible](JComponent.html#setVisible%28boolean%29), [unregisterKeyboardAction](JComponent.html#unregisterKeyboardAction%28javax.swing.KeyStroke%29), [update](JComponent.html#update%28java.awt.Graphics%29)

Methods declared in class java.awt.Container

[add](../../java/awt/Container.html#add%28java.awt.Component%29), [add](../../java/awt/Container.html#add%28java.awt.Component,int%29), [add](../../java/awt/Container.html#add%28java.awt.Component,java.lang.Object%29), [add](../../java/awt/Container.html#add%28java.awt.Component,java.lang.Object,int%29), [add](../../java/awt/Container.html#add%28java.lang.String,java.awt.Component%29), [addContainerListener](../../java/awt/Container.html#addContainerListener%28java.awt.event.ContainerListener%29), [addPropertyChangeListener](../../java/awt/Container.html#addPropertyChangeListener%28java.beans.PropertyChangeListener%29), [addPropertyChangeListener](../../java/awt/Container.html#addPropertyChangeListener%28java.lang.String,java.beans.PropertyChangeListener%29), [applyComponentOrientation](../../java/awt/Container.html#applyComponentOrientation%28java.awt.ComponentOrientation%29), [areFocusTraversalKeysSet](../../java/awt/Container.html#areFocusTraversalKeysSet%28int%29), [countComponents](../../java/awt/Container.html#countComponents%28%29), [deliverEvent](../../java/awt/Container.html#deliverEvent%28java.awt.Event%29), [doLayout](../../java/awt/Container.html#doLayout%28%29), [findComponentAt](../../java/awt/Container.html#findComponentAt%28int,int%29), [findComponentAt](../../java/awt/Container.html#findComponentAt%28java.awt.Point%29), [getComponent](../../java/awt/Container.html#getComponent%28int%29), [getComponentAt](../../java/awt/Container.html#getComponentAt%28int,int%29), [getComponentAt](../../java/awt/Container.html#getComponentAt%28java.awt.Point%29), [getComponentCount](../../java/awt/Container.html#getComponentCount%28%29), [getComponents](../../java/awt/Container.html#getComponents%28%29), [getComponentZOrder](../../java/awt/Container.html#getComponentZOrder%28java.awt.Component%29), [getContainerListeners](../../java/awt/Container.html#getContainerListeners%28%29), [getFocusTraversalKeys](../../java/awt/Container.html#getFocusTraversalKeys%28int%29), [getFocusTraversalPolicy](../../java/awt/Container.html#getFocusTraversalPolicy%28%29), [getLayout](../../java/awt/Container.html#getLayout%28%29), [getMousePosition](../../java/awt/Container.html#getMousePosition%28boolean%29), [insets](../../java/awt/Container.html#insets%28%29), [invalidate](../../java/awt/Container.html#invalidate%28%29), [isAncestorOf](../../java/awt/Container.html#isAncestorOf%28java.awt.Component%29), [isFocusCycleRoot](../../java/awt/Container.html#isFocusCycleRoot%28%29), [isFocusCycleRoot](../../java/awt/Container.html#isFocusCycleRoot%28java.awt.Container%29), [isFocusTraversalPolicyProvider](../../java/awt/Container.html#isFocusTraversalPolicyProvider%28%29), [isFocusTraversalPolicySet](../../java/awt/Container.html#isFocusTraversalPolicySet%28%29), [layout](../../java/awt/Container.html#layout%28%29), [list](../../java/awt/Container.html#list%28java.io.PrintStream,int%29), [list](../../java/awt/Container.html#list%28java.io.PrintWriter,int%29), [locate](../../java/awt/Container.html#locate%28int,int%29), [minimumSize](../../java/awt/Container.html#minimumSize%28%29), [paintComponents](../../java/awt/Container.html#paintComponents%28java.awt.Graphics%29), [preferredSize](../../java/awt/Container.html#preferredSize%28%29), [printComponents](../../java/awt/Container.html#printComponents%28java.awt.Graphics%29), [processContainerEvent](../../java/awt/Container.html#processContainerEvent%28java.awt.event.ContainerEvent%29), [processEvent](../../java/awt/Container.html#processEvent%28java.awt.AWTEvent%29), [remove](../../java/awt/Container.html#remove%28int%29), [remove](../../java/awt/Container.html#remove%28java.awt.Component%29), [removeAll](../../java/awt/Container.html#removeAll%28%29), [removeContainerListener](../../java/awt/Container.html#removeContainerListener%28java.awt.event.ContainerListener%29), [setComponentZOrder](../../java/awt/Container.html#setComponentZOrder%28java.awt.Component,int%29), [setFocusCycleRoot](../../java/awt/Container.html#setFocusCycleRoot%28boolean%29), [setFocusTraversalPolicy](../../java/awt/Container.html#setFocusTraversalPolicy%28java.awt.FocusTraversalPolicy%29), [setFocusTraversalPolicyProvider](../../java/awt/Container.html#setFocusTraversalPolicyProvider%28boolean%29), [transferFocusDownCycle](../../java/awt/Container.html#transferFocusDownCycle%28%29), [validate](../../java/awt/Container.html#validate%28%29), [validateTree](../../java/awt/Container.html#validateTree%28%29)

Methods declared in class java.awt.Component

[action](../../java/awt/Component.html#action%28java.awt.Event,java.lang.Object%29), [add](../../java/awt/Component.html#add%28java.awt.PopupMenu%29), [addComponentListener](../../java/awt/Component.html#addComponentListener%28java.awt.event.ComponentListener%29), [addFocusListener](../../java/awt/Component.html#addFocusListener%28java.awt.event.FocusListener%29), [addHierarchyBoundsListener](../../java/awt/Component.html#addHierarchyBoundsListener%28java.awt.event.HierarchyBoundsListener%29), [addHierarchyListener](../../java/awt/Component.html#addHierarchyListener%28java.awt.event.HierarchyListener%29), [addInputMethodListener](../../java/awt/Component.html#addInputMethodListener%28java.awt.event.InputMethodListener%29), [addKeyListener](../../java/awt/Component.html#addKeyListener%28java.awt.event.KeyListener%29), [addMouseListener](../../java/awt/Component.html#addMouseListener%28java.awt.event.MouseListener%29), [addMouseMotionListener](../../java/awt/Component.html#addMouseMotionListener%28java.awt.event.MouseMotionListener%29), [addMouseWheelListener](../../java/awt/Component.html#addMouseWheelListener%28java.awt.event.MouseWheelListener%29), [bounds](../../java/awt/Component.html#bounds%28%29), [checkImage](../../java/awt/Component.html#checkImage%28java.awt.Image,int,int,java.awt.image.ImageObserver%29), [checkImage](../../java/awt/Component.html#checkImage%28java.awt.Image,java.awt.image.ImageObserver%29), [coalesceEvents](../../java/awt/Component.html#coalesceEvents%28java.awt.AWTEvent,java.awt.AWTEvent%29), [contains](../../java/awt/Component.html#contains%28java.awt.Point%29), [createImage](../../java/awt/Component.html#createImage%28int,int%29), [createImage](../../java/awt/Component.html#createImage%28java.awt.image.ImageProducer%29), [createVolatileImage](../../java/awt/Component.html#createVolatileImage%28int,int%29), [createVolatileImage](../../java/awt/Component.html#createVolatileImage%28int,int,java.awt.ImageCapabilities%29), [disableEvents](../../java/awt/Component.html#disableEvents%28long%29), [dispatchEvent](../../java/awt/Component.html#dispatchEvent%28java.awt.AWTEvent%29), [enable](../../java/awt/Component.html#enable%28boolean%29), [enableEvents](../../java/awt/Component.html#enableEvents%28long%29), [enableInputMethods](../../java/awt/Component.html#enableInputMethods%28boolean%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String,byte,byte%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String,char,char%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String,double,double%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String,float,float%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String,long,long%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String,short,short%29), [firePropertyChange](../../java/awt/Component.html#firePropertyChange%28java.lang.String,java.lang.Object,java.lang.Object%29), [getAccessibleContext](../../java/awt/Component.html#getAccessibleContext%28%29), [getBackground](../../java/awt/Component.html#getBackground%28%29), [getBounds](../../java/awt/Component.html#getBounds%28%29), [getColorModel](../../java/awt/Component.html#getColorModel%28%29), [getComponentListeners](../../java/awt/Component.html#getComponentListeners%28%29), [getComponentOrientation](../../java/awt/Component.html#getComponentOrientation%28%29), [getCursor](../../java/awt/Component.html#getCursor%28%29), [getDropTarget](../../java/awt/Component.html#getDropTarget%28%29), [getFocusCycleRootAncestor](../../java/awt/Component.html#getFocusCycleRootAncestor%28%29), [getFocusListeners](../../java/awt/Component.html#getFocusListeners%28%29), [getFocusTraversalKeysEnabled](../../java/awt/Component.html#getFocusTraversalKeysEnabled%28%29), [getFont](../../java/awt/Component.html#getFont%28%29), [getForeground](../../java/awt/Component.html#getForeground%28%29), [getGraphicsConfiguration](../../java/awt/Component.html#getGraphicsConfiguration%28%29), [getHierarchyBoundsListeners](../../java/awt/Component.html#getHierarchyBoundsListeners%28%29), [getHierarchyListeners](../../java/awt/Component.html#getHierarchyListeners%28%29), [getIgnoreRepaint](../../java/awt/Component.html#getIgnoreRepaint%28%29), [getInputContext](../../java/awt/Component.html#getInputContext%28%29), [getInputMethodListeners](../../java/awt/Component.html#getInputMethodListeners%28%29), [getInputMethodRequests](../../java/awt/Component.html#getInputMethodRequests%28%29), [getKeyListeners](../../java/awt/Component.html#getKeyListeners%28%29), [getLocale](../../java/awt/Component.html#getLocale%28%29), [getLocation](../../java/awt/Component.html#getLocation%28%29), [getLocationOnScreen](../../java/awt/Component.html#getLocationOnScreen%28%29), [getMouseListeners](../../java/awt/Component.html#getMouseListeners%28%29), [getMouseMotionListeners](../../java/awt/Component.html#getMouseMotionListeners%28%29), [getMousePosition](../../java/awt/Component.html#getMousePosition%28%29), [getMouseWheelListeners](../../java/awt/Component.html#getMouseWheelListeners%28%29), [getName](../../java/awt/Component.html#getName%28%29), [getParent](../../java/awt/Component.html#getParent%28%29), [getPropertyChangeListeners](../../java/awt/Component.html#getPropertyChangeListeners%28%29), [getPropertyChangeListeners](../../java/awt/Component.html#getPropertyChangeListeners%28java.lang.String%29), [getSize](../../java/awt/Component.html#getSize%28%29), [getToolkit](../../java/awt/Component.html#getToolkit%28%29), [getTreeLock](../../java/awt/Component.html#getTreeLock%28%29), [gotFocus](../../java/awt/Component.html#gotFocus%28java.awt.Event,java.lang.Object%29), [handleEvent](../../java/awt/Component.html#handleEvent%28java.awt.Event%29), [hasFocus](../../java/awt/Component.html#hasFocus%28%29), [inside](../../java/awt/Component.html#inside%28int,int%29), [isBackgroundSet](../../java/awt/Component.html#isBackgroundSet%28%29), [isCursorSet](../../java/awt/Component.html#isCursorSet%28%29), [isDisplayable](../../java/awt/Component.html#isDisplayable%28%29), [isEnabled](../../java/awt/Component.html#isEnabled%28%29), [isFocusable](../../java/awt/Component.html#isFocusable%28%29), [isFocusOwner](../../java/awt/Component.html#isFocusOwner%28%29), [isFocusTraversable](../../java/awt/Component.html#isFocusTraversable%28%29), [isFontSet](../../java/awt/Component.html#isFontSet%28%29), [isForegroundSet](../../java/awt/Component.html#isForegroundSet%28%29), [isLightweight](../../java/awt/Component.html#isLightweight%28%29), [isMaximumSizeSet](../../java/awt/Component.html#isMaximumSizeSet%28%29), [isMinimumSizeSet](../../java/awt/Component.html#isMinimumSizeSet%28%29), [isPreferredSizeSet](../../java/awt/Component.html#isPreferredSizeSet%28%29), [isShowing](../../java/awt/Component.html#isShowing%28%29), [isValid](../../java/awt/Component.html#isValid%28%29), [isVisible](../../java/awt/Component.html#isVisible%28%29), [keyDown](../../java/awt/Component.html#keyDown%28java.awt.Event,int%29), [keyUp](../../java/awt/Component.html#keyUp%28java.awt.Event,int%29), [list](../../java/awt/Component.html#list%28%29), [list](../../java/awt/Component.html#list%28java.io.PrintStream%29), [list](../../java/awt/Component.html#list%28java.io.PrintWriter%29), [location](../../java/awt/Component.html#location%28%29), [lostFocus](../../java/awt/Component.html#lostFocus%28java.awt.Event,java.lang.Object%29), [mouseDown](../../java/awt/Component.html#mouseDown%28java.awt.Event,int,int%29), [mouseDrag](../../java/awt/Component.html#mouseDrag%28java.awt.Event,int,int%29), [mouseEnter](../../java/awt/Component.html#mouseEnter%28java.awt.Event,int,int%29), [mouseExit](../../java/awt/Component.html#mouseExit%28java.awt.Event,int,int%29), [mouseMove](../../java/awt/Component.html#mouseMove%28java.awt.Event,int,int%29), [mouseUp](../../java/awt/Component.html#mouseUp%28java.awt.Event,int,int%29), [move](../../java/awt/Component.html#move%28int,int%29), [nextFocus](../../java/awt/Component.html#nextFocus%28%29), [paintAll](../../java/awt/Component.html#paintAll%28java.awt.Graphics%29), [postEvent](../../java/awt/Component.html#postEvent%28java.awt.Event%29), [prepareImage](../../java/awt/Component.html#prepareImage%28java.awt.Image,int,int,java.awt.image.ImageObserver%29), [prepareImage](../../java/awt/Component.html#prepareImage%28java.awt.Image,java.awt.image.ImageObserver%29), [processComponentEvent](../../java/awt/Component.html#processComponentEvent%28java.awt.event.ComponentEvent%29), [processFocusEvent](../../java/awt/Component.html#processFocusEvent%28java.awt.event.FocusEvent%29), [processHierarchyBoundsEvent](../../java/awt/Component.html#processHierarchyBoundsEvent%28java.awt.event.HierarchyEvent%29), [processHierarchyEvent](../../java/awt/Component.html#processHierarchyEvent%28java.awt.event.HierarchyEvent%29), [processInputMethodEvent](../../java/awt/Component.html#processInputMethodEvent%28java.awt.event.InputMethodEvent%29), [processMouseWheelEvent](../../java/awt/Component.html#processMouseWheelEvent%28java.awt.event.MouseWheelEvent%29), [remove](../../java/awt/Component.html#remove%28java.awt.MenuComponent%29), [removeComponentListener](../../java/awt/Component.html#removeComponentListener%28java.awt.event.ComponentListener%29), [removeFocusListener](../../java/awt/Component.html#removeFocusListener%28java.awt.event.FocusListener%29), [removeHierarchyBoundsListener](../../java/awt/Component.html#removeHierarchyBoundsListener%28java.awt.event.HierarchyBoundsListener%29), [removeHierarchyListener](../../java/awt/Component.html#removeHierarchyListener%28java.awt.event.HierarchyListener%29), [removeInputMethodListener](../../java/awt/Component.html#removeInputMethodListener%28java.awt.event.InputMethodListener%29), [removeKeyListener](../../java/awt/Component.html#removeKeyListener%28java.awt.event.KeyListener%29), [removeMouseListener](../../java/awt/Component.html#removeMouseListener%28java.awt.event.MouseListener%29), [removeMouseMotionListener](../../java/awt/Component.html#removeMouseMotionListener%28java.awt.event.MouseMotionListener%29), [removeMouseWheelListener](../../java/awt/Component.html#removeMouseWheelListener%28java.awt.event.MouseWheelListener%29), [removePropertyChangeListener](../../java/awt/Component.html#removePropertyChangeListener%28java.beans.PropertyChangeListener%29), [removePropertyChangeListener](../../java/awt/Component.html#removePropertyChangeListener%28java.lang.String,java.beans.PropertyChangeListener%29), [repaint](../../java/awt/Component.html#repaint%28%29), [repaint](../../java/awt/Component.html#repaint%28int,int,int,int%29), [repaint](../../java/awt/Component.html#repaint%28long%29), [requestFocus](../../java/awt/Component.html#requestFocus%28boolean,java.awt.event.FocusEvent.Cause%29), [requestFocus](../../java/awt/Component.html#requestFocus%28java.awt.event.FocusEvent.Cause%29), [requestFocusInWindow](../../java/awt/Component.html#requestFocusInWindow%28java.awt.event.FocusEvent.Cause%29), [resize](../../java/awt/Component.html#resize%28int,int%29), [resize](../../java/awt/Component.html#resize%28java.awt.Dimension%29), [setBounds](../../java/awt/Component.html#setBounds%28int,int,int,int%29), [setBounds](../../java/awt/Component.html#setBounds%28java.awt.Rectangle%29), [setComponentOrientation](../../java/awt/Component.html#setComponentOrientation%28java.awt.ComponentOrientation%29), [setCursor](../../java/awt/Component.html#setCursor%28java.awt.Cursor%29), [setDropTarget](../../java/awt/Component.html#setDropTarget%28java.awt.dnd.DropTarget%29), [setFocusable](../../java/awt/Component.html#setFocusable%28boolean%29), [setFocusTraversalKeysEnabled](../../java/awt/Component.html#setFocusTraversalKeysEnabled%28boolean%29), [setIgnoreRepaint](../../java/awt/Component.html#setIgnoreRepaint%28boolean%29), [setLocale](../../java/awt/Component.html#setLocale%28java.util.Locale%29), [setLocation](../../java/awt/Component.html#setLocation%28int,int%29), [setLocation](../../java/awt/Component.html#setLocation%28java.awt.Point%29), [setMixingCutoutShape](../../java/awt/Component.html#setMixingCutoutShape%28java.awt.Shape%29), [setName](../../java/awt/Component.html#setName%28java.lang.String%29), [setSize](../../java/awt/Component.html#setSize%28int,int%29), [setSize](../../java/awt/Component.html#setSize%28java.awt.Dimension%29), [show](../../java/awt/Component.html#show%28%29), [show](../../java/awt/Component.html#show%28boolean%29), [size](../../java/awt/Component.html#size%28%29), [toString](../../java/awt/Component.html#toString%28%29), [transferFocus](../../java/awt/Component.html#transferFocus%28%29), [transferFocusBackward](../../java/awt/Component.html#transferFocusBackward%28%29), [transferFocusUpCycle](../../java/awt/Component.html#transferFocusUpCycle%28%29)

• Field Details

  • 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

  The data model that determines the button's state.

  • changeListener

  The button model's changeListener.

  • actionListener

  The button model's ActionListener.

  • itemListener

  The button model's ItemListener.

  • 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 Details

  • AbstractButton

  public AbstractButton()

• Method Details

  • setHideActionText

  @BeanProperty(expert=true,description="Whether the text of the button should come from the Action.")public void setHideActionText​(boolean hideActionText)
  Sets the hideActionText property, which determines whether the button displays text from the Action. This is useful only if an Action has been installed on the button.
  Parameters:
  hideActionText - true if the button'stext property should not reflect that of the Action; the default isfalse
  Since:
  1.6
  See Also:
  Swing Components SupportingAction

  • getHideActionText

  public boolean getHideActionText()
  Returns the value of the hideActionText property, which determines whether the button displays text from theAction. This is useful only if an Action has been installed on the button.
  Returns:
  true if the button's text property should not reflect that of theAction; the default is false
  Since:
  1.6

  • getText

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

  • setText

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

  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

  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

  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

  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

  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

  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 this will forward the call to the look and feel to construct an appropriate disabled Icon.
  Some look and feels might not render the disabled Icon, in which case they will ignore this.
  Returns:
  the disabledIcon property
  See Also:
  getPressedIcon(), setDisabledIcon(javax.swing.Icon), LookAndFeel.getDisabledIcon(javax.swing.JComponent, javax.swing.Icon)

  • setDisabledIcon

  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 no disabled selection icon has been set, this will forward the call to the LookAndFeel to construct an appropriate disabled Icon from the selection icon if it has been set and togetDisabledIcon() otherwise.
  Some look and feels might not render the disabled selected Icon, in which case they will ignore this.
  Returns:
  the disabledSelectedIcon property
  See Also:
  getDisabledIcon(), setDisabledSelectedIcon(javax.swing.Icon), LookAndFeel.getDisabledSelectedIcon(javax.swing.JComponent, javax.swing.Icon)

  • setDisabledSelectedIcon

  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

  @BeanProperty(visualUpdate=true,enumerationValues={"SwingConstants.TOP","SwingConstants.CENTER","SwingConstants.BOTTOM"},description="The vertical alignment of the icon and text.")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
  Throws:
  [IllegalArgumentException](../../../java.base/java/lang/IllegalArgumentException.html "class in java.lang") - if the alignment is not one of the legal values listed above

  • getHorizontalAlignment

  public int getHorizontalAlignment()
  Returns the horizontal alignment of the icon and text.AbstractButton's default is SwingConstants.CENTER, but subclasses such as JCheckBox may use a different default.
  Returns:
  the horizontalAlignment property, one of the following values:
  * SwingConstants.RIGHT
  * SwingConstants.LEFT
  * SwingConstants.CENTER
  * SwingConstants.LEADING
  * SwingConstants.TRAILING

  • setHorizontalAlignment

  @BeanProperty(visualUpdate=true,enumerationValues={"SwingConstants.LEFT","SwingConstants.CENTER","SwingConstants.RIGHT","SwingConstants.LEADING","SwingConstants.TRAILING"},description="The horizontal alignment of the icon and text.")public void setHorizontalAlignment​(int alignment)
  Sets the horizontal alignment of the icon and text.AbstractButton's default is SwingConstants.CENTER, but subclasses such as JCheckBox may use a different default.
  Parameters:
  alignment - the alignment value, one of the following values:
  * SwingConstants.RIGHT
  * SwingConstants.LEFT
  * SwingConstants.CENTER
  * SwingConstants.LEADING
  * SwingConstants.TRAILING
  Throws:
  [IllegalArgumentException](../../../java.base/java/lang/IllegalArgumentException.html "class in java.lang") - if the alignment is not one of the valid values

  • getVerticalTextPosition

  public int getVerticalTextPosition()
  Returns the vertical position of the text relative to the icon.
  Returns:
  the verticalTextPosition property, one of the following values:
  * SwingConstants.CENTER (the default)
  * SwingConstants.TOP
  * SwingConstants.BOTTOM

  • setVerticalTextPosition

  @BeanProperty(visualUpdate=true,enumerationValues={"SwingConstants.TOP","SwingConstants.CENTER","SwingConstants.BOTTOM"},description="The vertical position of the text relative to the icon.")public void setVerticalTextPosition​(int textPosition)
  Sets the vertical position of the text relative to the icon.
  Parameters:
  textPosition - one of the following values:
  * SwingConstants.CENTER (the default)
  * SwingConstants.TOP
  * SwingConstants.BOTTOM

  • getHorizontalTextPosition

  public int getHorizontalTextPosition()
  Returns the horizontal position of the text relative to the icon.
  Returns:
  the horizontalTextPosition property, one of the following values:
  * SwingConstants.RIGHT
  * SwingConstants.LEFT
  * SwingConstants.CENTER
  * SwingConstants.LEADING
  * SwingConstants.TRAILING (the default)

  • setHorizontalTextPosition

  @BeanProperty(visualUpdate=true,enumerationValues={"SwingConstants.LEFT","SwingConstants.CENTER","SwingConstants.RIGHT","SwingConstants.LEADING","SwingConstants.TRAILING"},description="The horizontal position of the text relative to the icon.")public void setHorizontalTextPosition​(int textPosition)
  Sets the horizontal position of the text relative to the icon.
  Parameters:
  textPosition - one of the following values:
  * SwingConstants.RIGHT
  * SwingConstants.LEFT
  * SwingConstants.CENTER
  * SwingConstants.LEADING
  * SwingConstants.TRAILING (the default)
  Throws:
  [IllegalArgumentException](../../../java.base/java/lang/IllegalArgumentException.html "class in java.lang") - if textPosition is not one of the legal values listed above

  • getIconTextGap

  public int getIconTextGap()
  Returns the amount of space between the text and the icon displayed in this button.
  Returns:
  an int equal to the number of pixels between the text and the icon.
  Since:
  1.4
  See Also:
  setIconTextGap(int)

  • setIconTextGap

  @BeanProperty(visualUpdate=true,description="If both the icon and text properties are set, this property defines the space between them.")public void setIconTextGap​(int iconTextGap)
  If both the icon and text properties are set, this property defines the space between them.
  The default value of this property is 4 pixels.
  This is a JavaBeans bound property.
  Parameters:
  iconTextGap - the space between icon and text if these properties are set.
  Since:
  1.4
  See Also:
  getIconTextGap()

  • checkHorizontalKey

  protected int checkHorizontalKey​(int key,String exception)
  Verify that the key argument is a legal value for thehorizontalAlignment and horizontalTextPosition properties. Valid values are:
  * SwingConstants.RIGHT
  * SwingConstants.LEFT
  * SwingConstants.CENTER
  * SwingConstants.LEADING
  * SwingConstants.TRAILING
  Parameters:
  key - the property value to check
  exception - the message to use in theIllegalArgumentException that is thrown for an invalid value
  Returns:
  the key argument
  Throws:
  [IllegalArgumentException](../../../java.base/java/lang/IllegalArgumentException.html "class in java.lang") - if key is not one of the legal values listed above
  See Also:
  setHorizontalTextPosition(int), setHorizontalAlignment(int)

  • checkVerticalKey

  protected int checkVerticalKey​(int key,String exception)
  Verify that the key argument is a legal value for the vertical properties. Valid values are:
  * SwingConstants.CENTER
  * SwingConstants.TOP
  * SwingConstants.BOTTOM
  Parameters:
  key - the property value to check
  exception - the message to use in theIllegalArgumentException that is thrown for an invalid value
  Returns:
  the key argument
  Throws:
  [IllegalArgumentException](../../../java.base/java/lang/IllegalArgumentException.html "class in java.lang") - if key is not one of the legal values listed above

  • removeNotify

  public void removeNotify()
  Notifies this component that it no longer has a parent component. When this method is invoked, any KeyboardActions set up in the chain of parent components are removed. This method is called by the toolkit internally and should not be called directly by programs.
  Overrides:
  [removeNotify](JComponent.html#removeNotify%28%29) in class [JComponent](JComponent.html "class in javax.swing")
  Since:
  1.6
  See Also:
  JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

  • setActionCommand

  public void setActionCommand​(String actionCommand)
  Sets the action command for this button.
  Parameters:
  actionCommand - the action command for this button

  • getActionCommand

  public String getActionCommand()
  Returns the action command for this button.
  Returns:
  the action command for this button

  • setAction

  Sets the Action. The new Action replaces any previously setAction but does not affect ActionListeners independently added with addActionListener. If the Action is already a registeredActionListener for the button, it is not re-registered.
  Setting the Action results in immediately changing all the properties described in Swing Components Supporting Action. Subsequently, the button's properties are automatically updated as the Action's properties change.
  This method uses three other methods to set and help track the Action's property values. It uses the configurePropertiesFromAction method to immediately change the button's properties. To track changes in the Action's property values, this method registers the PropertyChangeListener returned by createActionPropertyChangeListener. The default PropertyChangeListener invokes theactionPropertyChanged method when a property in theAction changes.
  Parameters:
  a - the Action for the AbstractButton, or null
  Since:
  1.3
  See Also:
  Action, getAction(), configurePropertiesFromAction(javax.swing.Action), createActionPropertyChangeListener(javax.swing.Action), actionPropertyChanged(javax.swing.Action, java.lang.String)

  • getAction

  public Action getAction()
  Returns the currently set Action for thisActionEvent source, or null if no Action is set.
  Returns:
  the Action for this ActionEvent source, or null
  Since:
  1.3
  See Also:
  Action, setAction(javax.swing.Action)

  • configurePropertiesFromAction

  protected void configurePropertiesFromAction​(Action a)
  Sets the properties on this button to match those in the specifiedAction. Refer to Swing Components Supporting Action for more details as to which properties this sets.
  Parameters:
  a - the Action from which to get the properties, or null
  Since:
  1.3
  See Also:
  Action, setAction(javax.swing.Action)

  • actionPropertyChanged

  protected void actionPropertyChanged​(Action action,String propertyName)
  Updates the button's state in response to property changes in the associated action. This method is invoked from thePropertyChangeListener returned fromcreateActionPropertyChangeListener. Subclasses do not normally need to invoke this. Subclasses that support additional Action properties should override this andconfigurePropertiesFromAction.
  Refer to the table at Swing Components Supporting Action for a list of the properties this method sets.
  Parameters:
  action - the Action associated with this button
  propertyName - the name of the property that changed
  Since:
  1.6
  See Also:
  Action, configurePropertiesFromAction(javax.swing.Action)

  • createActionPropertyChangeListener

  Creates and returns a PropertyChangeListener that is responsible for listening for changes from the specifiedAction and updating the appropriate properties.
  Warning: If you subclass this do not create an anonymous inner class. If you do the lifetime of the button will be tied to that of the Action.
  Parameters:
  a - the button's action
  Returns:
  the PropertyChangeListener
  Since:
  1.3
  See Also:
  Action, setAction(javax.swing.Action)

  • isBorderPainted

  public boolean isBorderPainted()
  Gets the borderPainted property.
  Returns:
  the value of the borderPainted property
  See Also:
  setBorderPainted(boolean)

  • setBorderPainted

  Sets the borderPainted property. If true and the button has a border, the border is painted. The default value for theborderPainted property is true.
  Some look and feels might not support the borderPainted property, in which case they ignore this.
  Parameters:
  b - if true and border property is not null, the border is painted
  See Also:
  isBorderPainted()

  • paintBorder

  protected void paintBorder​(Graphics g)
  Paint the button's border if BorderPainted property is true and the button has a border.
  Overrides:
  [paintBorder](JComponent.html#paintBorder%28java.awt.Graphics%29) in class [JComponent](JComponent.html "class in javax.swing")
  Parameters:
  g - the Graphics context in which to paint
  See Also:
  JComponent.paint(java.awt.Graphics), JComponent.setBorder(javax.swing.border.Border)

  • isFocusPainted

  public boolean isFocusPainted()
  Gets the paintFocus property.
  Returns:
  the paintFocus property
  See Also:
  setFocusPainted(boolean)

  • setFocusPainted

  Sets the paintFocus property, which must be true for the focus state to be painted. The default value for the paintFocus property is true. Some look and feels might not paint focus state; they will ignore this property.
  Parameters:
  b - if true, the focus state should be painted
  See Also:
  isFocusPainted()

  • isContentAreaFilled

  public boolean isContentAreaFilled()
  Gets the contentAreaFilled property.
  Returns:
  the contentAreaFilled property
  See Also:
  setContentAreaFilled(boolean)

  • setContentAreaFilled

  @BeanProperty(visualUpdate=true,description="Whether the button should paint the content area or leave it transparent.")public void setContentAreaFilled​(boolean b)
  Sets the contentAreaFilled property. If true the button will paint the content area. If you wish to have a transparent button, such as an icon only button, for example, then you should set this to false. Do not call setOpaque(false). The default value for the contentAreaFilled property is true.
  This function may cause the component's opaque property to change.
  The exact behavior of calling this function varies on a component-by-component and L&F-by-L&F basis.
  Parameters:
  b - if true, the content should be filled; if false the content area is not filled
  See Also:
  isContentAreaFilled(), JComponent.setOpaque(boolean)

  • isRolloverEnabled

  public boolean isRolloverEnabled()
  Gets the rolloverEnabled property.
  Returns:
  the value of the rolloverEnabled property
  See Also:
  setRolloverEnabled(boolean)

  • setRolloverEnabled

  Sets the rolloverEnabled property, which must be true for rollover effects to occur. The default value for the rolloverEnabled property is false. Some look and feels might not implement rollover effects; they will ignore this property.
  Parameters:
  b - if true, rollover effects should be painted
  See Also:
  isRolloverEnabled()

  • getMnemonic

  public int getMnemonic()
  Returns the keyboard mnemonic from the current model.
  Returns:
  the keyboard mnemonic from the model

  • setMnemonic

  Sets the keyboard mnemonic on the current model. The mnemonic is the key which when combined with the look and feel's mouseless modifier (usually Alt) will activate this button if focus is contained somewhere within this button's ancestor window.
  A mnemonic must correspond to a single key on the keyboard and should be specified using one of the VK_XXX keycodes defined in java.awt.event.KeyEvent. These codes and the wider array of codes for international keyboards may be obtained throughjava.awt.event.KeyEvent.getExtendedKeyCodeForChar. Mnemonics are case-insensitive, therefore a key event with the corresponding keycode would cause the button to be activated whether or not the Shift modifier was pressed.
  If the character defined by the mnemonic is found within the button's label string, the first occurrence of it will be underlined to indicate the mnemonic to the user.
  Parameters:
  mnemonic - the key code which represents the mnemonic
  See Also:
  KeyEvent, setDisplayedMnemonicIndex(int)

  • setMnemonic

  This method is now obsolete, please use setMnemonic(int) to set the mnemonic for a button. This method is only designed to handle character values which fall between 'a' and 'z' or 'A' and 'Z'.
  Parameters:
  mnemonic - a char specifying the mnemonic value
  See Also:
  setMnemonic(int)

  • setDisplayedMnemonicIndex

  Provides a hint to the look and feel as to which character in the text should be decorated to represent the mnemonic. Not all look and feels may support this. A value of -1 indicates either there is no mnemonic, the mnemonic character is not contained in the string, or the developer does not wish the mnemonic to be displayed.
  The value of this is updated as the properties relating to the mnemonic change (such as the mnemonic itself, the text...). You should only ever have to call this if you do not wish the default character to be underlined. For example, if the text was 'Save As', with a mnemonic of 'a', and you wanted the 'A' to be decorated, as 'Save As', you would have to invokesetDisplayedMnemonicIndex(5) after invokingsetMnemonic(KeyEvent.VK_A).
  Parameters:
  index - Index into the String to underline
  Throws:
  [IllegalArgumentException](../../../java.base/java/lang/IllegalArgumentException.html "class in java.lang") - will be thrown if index is >= length of the text, or < -1
  Since:
  1.4
  See Also:
  getDisplayedMnemonicIndex()

  • getDisplayedMnemonicIndex

  public int getDisplayedMnemonicIndex()
  Returns the character, as an index, that the look and feel should provide decoration for as representing the mnemonic character.
  Returns:
  index representing mnemonic character
  Since:
  1.4
  See Also:
  setDisplayedMnemonicIndex(int)

  • setMultiClickThreshhold

  public 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. After the initial mouse press occurs (and action event generated) any subsequent mouse press events which occur on intervals less than the threshhold will be ignored and no corresponding action event generated. By default the threshhold is 0, which means that for each mouse press, an action event will be fired, no matter how quickly the mouse clicks occur. In buttons where this behavior is not desirable (for example, the "OK" button in a dialog), this threshhold should be set to an appropriate positive value.
  Parameters:
  threshhold - the amount of time required between mouse press events to generate corresponding action events
  Throws:
  [IllegalArgumentException](../../../java.base/java/lang/IllegalArgumentException.html "class in java.lang") - if threshhold < 0
  Since:
  1.4
  See Also:
  getMultiClickThreshhold()

  • getMultiClickThreshhold

  public long getMultiClickThreshhold()
  Gets the amount of time (in milliseconds) required between mouse press events for the button to generate the corresponding action events.
  Returns:
  the amount of time required between mouse press events to generate corresponding action events
  Since:
  1.4
  See Also:
  setMultiClickThreshhold(long)

  • getModel

  Returns the model that this button represents.
  Returns:
  the model property
  See Also:
  setModel(javax.swing.ButtonModel)

  • setModel

  Sets the model that this button represents.
  Parameters:
  newModel - the new ButtonModel
  See Also:
  getModel()

  • getUI

  Returns the L&F object that renders this component.
  Overrides:
  [getUI](JComponent.html#getUI%28%29) in class [JComponent](JComponent.html "class in javax.swing")
  Returns:
  the ButtonUI object
  See Also:
  setUI(javax.swing.plaf.ButtonUI)

  • setUI

  Sets the L&F object that renders this component.
  Parameters:
  ui - the ButtonUI L&F object
  See Also:
  getUI()

  • updateUI

  public void updateUI()
  Resets the UI property to a value from the current look and feel. Subtypes of AbstractButton should override this to update the UI. For example, JButton might do the following:
  setUI((ButtonUI)UIManager.getUI(
  "ButtonUI", "javax.swing.plaf.basic.BasicButtonUI", this));

  Overrides:
  [updateUI](JComponent.html#updateUI%28%29) in class [JComponent](JComponent.html "class in javax.swing")
  See Also:
  JComponent.setUI(javax.swing.plaf.ComponentUI), UIManager.getLookAndFeel(), UIManager.getUI(javax.swing.JComponent)

  • addImpl

  protected void addImpl​(Component comp,Object constraints, int index)
  Overrides:
  [addImpl](../../java/awt/Container.html#addImpl%28java.awt.Component,java.lang.Object,int%29) in class [Container](../../java/awt/Container.html "class in java.awt")
  Parameters:
  comp - the component to be added
  constraints - an object expressing layout constraints for this component
  index - the position in the container's list at which to insert the component, where -1 means append to the end
  Throws:
  [IllegalArgumentException](../../../java.base/java/lang/IllegalArgumentException.html "class in java.lang") - if index is invalid
  [IllegalArgumentException](../../../java.base/java/lang/IllegalArgumentException.html "class in java.lang") - if adding the container's parent to itself
  [IllegalArgumentException](../../../java.base/java/lang/IllegalArgumentException.html "class in java.lang") - if adding a window to a container
  Since:
  1.5
  See Also:
  Container.add(Component), Container.add(Component, int), Container.add(Component, java.lang.Object), Container.invalidate(), LayoutManager, LayoutManager2

  • setLayout

  Overrides:
  [setLayout](../../java/awt/Container.html#setLayout%28java.awt.LayoutManager%29) in class [Container](../../java/awt/Container.html "class in java.awt")
  Parameters:
  mgr - the specified layout manager
  Since:
  1.5
  See Also:
  Container.doLayout(), Container.getLayout(), Container.invalidate()

  • addChangeListener

  Adds a ChangeListener to the button.
  Parameters:
  l - the listener to be added

  • removeChangeListener

  Removes a ChangeListener from the button.
  Parameters:
  l - the listener to be removed

  • getChangeListeners

  Returns an array of all the ChangeListeners added to this AbstractButton with addChangeListener().
  Returns:
  all of the ChangeListeners added or an empty array if no listeners have been added
  Since:
  1.4

  • fireStateChanged

  protected void fireStateChanged()
  Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created.
  See Also:
  EventListenerList

  • addActionListener

  Adds an ActionListener to the button.
  Parameters:
  l - the ActionListener to be added

  • removeActionListener

  Removes an ActionListener from the button. If the listener is the currently set Action for the button, then the Action is set to null.
  Parameters:
  l - the listener to be removed

  • getActionListeners

  Returns an array of all the ActionListeners added to this AbstractButton with addActionListener().
  Returns:
  all of the ActionListeners added or an empty array if no listeners have been added
  Since:
  1.4

  • createChangeListener

  Subclasses that want to handle ChangeEvents differently can override this to return another ChangeListener implementation.
  Returns:
  the new ChangeListener

  • fireActionPerformed

  protected void fireActionPerformed​(ActionEvent event)
  Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created using the event parameter.
  Parameters:
  event - the ActionEvent object
  See Also:
  EventListenerList

  • fireItemStateChanged

  protected void fireItemStateChanged​(ItemEvent event)
  Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created using the event parameter.
  Parameters:
  event - the ItemEvent object
  See Also:
  EventListenerList

  • createActionListener

  Returns ActionListener that is added to model.
  Returns:
  the ActionListener

  • createItemListener

  Returns ItemListener that is added to model.
  Returns:
  the ItemListener

  • setEnabled

  public void setEnabled​(boolean b)
  Enables (or disables) the button.
  Overrides:
  [setEnabled](JComponent.html#setEnabled%28boolean%29) in class [JComponent](JComponent.html "class in javax.swing")
  Parameters:
  b - true to enable the button, otherwise false
  See Also:
  Component.isEnabled(), Component.isLightweight()

  • getLabel

  Returns the label text.
  Returns:
  a String containing the label

  • setLabel

  Sets the label text.
  Parameters:
  label - a String containing the text

  • addItemListener

  Adds an ItemListener to the checkbox.
  Specified by:
  [addItemListener](../../java/awt/ItemSelectable.html#addItemListener%28java.awt.event.ItemListener%29) in interface [ItemSelectable](../../java/awt/ItemSelectable.html "interface in java.awt")
  Parameters:
  l - the ItemListener to be added
  See Also:
  ItemEvent

  • removeItemListener

  Removes an ItemListener from the button.
  Specified by:
  [removeItemListener](../../java/awt/ItemSelectable.html#removeItemListener%28java.awt.event.ItemListener%29) in interface [ItemSelectable](../../java/awt/ItemSelectable.html "interface in java.awt")
  Parameters:
  l - the ItemListener to be removed
  See Also:
  ItemEvent

  • getItemListeners

  Returns an array of all the ItemListeners added to this AbstractButton with addItemListener().
  Returns:
  all of the ItemListeners added or an empty array if no listeners have been added
  Since:
  1.4

  • getSelectedObjects

  Returns an array (length 1) containing the label ornull if the button is not selected.
  Specified by:
  [getSelectedObjects](../../java/awt/ItemSelectable.html#getSelectedObjects%28%29) in interface [ItemSelectable](../../java/awt/ItemSelectable.html "interface in java.awt")
  Returns:
  an array containing 1 Object: the text of the button, if the item is selected; otherwise null

  • init

  protected void init​(String text,Icon icon)
  Initialization of the AbstractButton.
  Parameters:
  text - the text of the button
  icon - the Icon image to display on the button

  • imageUpdate

  public boolean imageUpdate​(Image img, int infoflags, int x, int y, int w, int h)
  This is overridden to return false if the current Icon'sImage is not equal to the passed in Image img.
  Specified by:
  [imageUpdate](../../java/awt/image/ImageObserver.html#imageUpdate%28java.awt.Image,int,int,int,int,int%29) in interface [ImageObserver](../../java/awt/image/ImageObserver.html "interface in java.awt.image")
  Overrides:
  [imageUpdate](../../java/awt/Component.html#imageUpdate%28java.awt.Image,int,int,int,int,int%29) in class [Component](../../java/awt/Component.html "class in java.awt")
  Parameters:
  img - the Image to be compared
  infoflags - flags used to repaint the button when the image is updated and which determine how much is to be painted
  x - the x coordinate
  y - the y coordinate
  w - the width
  h - the height
  Returns:
  false if the infoflags indicate that the image is completely loaded; true otherwise.
  See Also:
  ImageObserver, Component.imageUpdate(java.awt.Image, int, int, int, int, int)

  • paramString

  protected String paramString()
  Returns a string representation of this AbstractButton. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be null.
  Overriding paramString to provide information about the specific new aspects of the JFC components.
  Overrides:
  [paramString](JComponent.html#paramString%28%29) in class [JComponent](JComponent.html "class in javax.swing")
  Returns:
  a string representation of this AbstractButton