JButton for standalone and JToolBar buttons, and replaced by ToolButton for Toolbar buttons.
public class JToolButton
extends javax.swing.JButton
Icon image and no text. By default, the JToolButton has a fixed size of 28x25, which provides a padding around the image that makes the JToolButton appear to have a uniform padding around the edge of a typical icon.
By default, the JToolButton always renders its borders. However, one of the constructor takes an extra flag that indicates whether or not the JToolButton has "rollover borders" -- that is, borders that are only rendered when the mouse pointer is actually within the boundaries of the JToolButton.
The border used by a JToolButton is a thinner border than what is used by JButton, and the appearance and behavior of the border does not track the look-and-feel. See the ThinBevel class for details.
| Modifier and Type | Class and Description |
|---|---|
protected class |
JToolButton.L
Deprecated.
This
ChangeListener is responsible for implementing the "rollover border" support and managing the painting of the thin bevel border for the button when arming and pressing the button. |
javax.swing.JButton.AccessibleJButtonjavax.swing.AbstractButton.AccessibleAbstractButton, javax.swing.AbstractButton.ButtonChangeListenerjavax.swing.JComponent.AccessibleJComponent| Modifier and Type | Field and Description |
|---|---|
static java.awt.Dimension |
DEFAULT_SIZE
Deprecated.
|
actionListener, BORDER_PAINTED_CHANGED_PROPERTY, changeEvent, changeListener, CONTENT_AREA_FILLED_CHANGED_PROPERTY, DISABLED_ICON_CHANGED_PROPERTY, DISABLED_SELECTED_ICON_CHANGED_PROPERTY, FOCUS_PAINTED_CHANGED_PROPERTY, HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY, HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY, ICON_CHANGED_PROPERTY, itemListener, MARGIN_CHANGED_PROPERTY, MNEMONIC_CHANGED_PROPERTY, model, MODEL_CHANGED_PROPERTY, PRESSED_ICON_CHANGED_PROPERTY, ROLLOVER_ENABLED_CHANGED_PROPERTY, ROLLOVER_ICON_CHANGED_PROPERTY, ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY, SELECTED_ICON_CHANGED_PROPERTY, TEXT_CHANGED_PROPERTY, VERTICAL_ALIGNMENT_CHANGED_PROPERTY, VERTICAL_TEXT_POSITION_CHANGED_PROPERTYaccessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOWBOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT| Constructor and Description |
|---|
JToolButton()
Deprecated.
Creates a new
JToolButton that has no icon and whose borders are always rendered. |
JToolButton(javax.swing.Icon icon)
Deprecated.
Creates a new
JToolButton that displays the specified Icon and whose borders are always rendered. |
JToolButton(javax.swing.Icon icon, boolean hasRolloverBorder)
Deprecated.
Creates a new
JToolButton that displays the specified Icon and displays its borders according to the hasRolloverBorder parameter. |
JToolButton(javax.swing.Icon icon, boolean hasRolloverBorder, java.awt.Dimension dim)
Deprecated.
Creates a new
JToolButton that displays the specified Icon and displays its borders according to the hasRolloverBorder parameter. |
| Modifier and Type | Method and Description |
|---|---|
protected javax.swing.event.ChangeListener |
getChangeListener(boolean hasRolloverBorder)
Deprecated.
Returns a new
ChangeListener instance that will be used to listen for ChangeEvents coming from the JToolButton's ButtonModel. |
javax.swing.border.Border |
getLoweredBorder()
Deprecated.
Returns the
Border object that will be used to render the button border when the button is pressed. |
javax.swing.border.Border |
getRaisedBorder()
Deprecated.
Returns the
Border object that will be used to render the button border when the button is not being pressed. |
void |
setFixedSize(java.awt.Dimension dim)
Deprecated.
This method sets the maximum, minimum, and preferred sizes to be the specified
Dimension, essentially setting a fixed size for the JToolButton. |
void |
setLoweredBorder(javax.swing.border.Border loweredBorder)
Deprecated.
Sets the
Border object that will be used to render the button border when the button is pressed. |
void |
setRaisedBorder(javax.swing.border.Border raisedBorder)
Deprecated.
Sets the
Border object that will be used to render the button border when the button is not being pressed. |
getAccessibleContext, getUIClassID, isDefaultButton, isDefaultCapable, paramString, removeNotify, setDefaultCapable, updateUIactionPropertyChanged, addActionListener, addChangeListener, addImpl, addItemListener, checkHorizontalKey, checkVerticalKey, configurePropertiesFromAction, createActionListener, createActionPropertyChangeListener, createChangeListener, createItemListener, doClick, doClick, fireActionPerformed, fireItemStateChanged, fireStateChanged, getAction, getActionCommand, getActionListeners, getChangeListeners, getDisabledIcon, getDisabledSelectedIcon, getDisplayedMnemonicIndex, getHideActionText, getHorizontalAlignment, getHorizontalTextPosition, getIcon, getIconTextGap, getItemListeners, getLabel, getMargin, getMnemonic, getModel, getMultiClickThreshhold, getPressedIcon, getRolloverIcon, getRolloverSelectedIcon, getSelectedIcon, getSelectedObjects, getText, getUI, getVerticalAlignment, getVerticalTextPosition, imageUpdate, init, isBorderPainted, isContentAreaFilled, isFocusPainted, isRolloverEnabled, isSelected, paintBorder, removeActionListener, removeChangeListener, removeItemListener, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setEnabled, setFocusPainted, setHideActionText, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setIconTextGap, setLabel, setLayout, setMargin, setMnemonic, setMnemonic, setModel, setMultiClickThreshhold, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, setText, setUI, setVerticalAlignment, setVerticalTextPositionaddAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, updateadd, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusDownCycle, validate, validateTreeaction, 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, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCyclepublic JToolButton()
JToolButton that has no icon and whose borders are always rendered.public JToolButton(javax.swing.Icon icon)
JToolButton that displays the specified Icon and whose borders are always rendered.icon - the Icon to display in the button.
public JToolButton(javax.swing.Icon icon,
boolean hasRolloverBorder)
JToolButton that displays the specified Icon and displays its borders according to the hasRolloverBorder parameter.icon - The Icon to display in the button.hasRolloverBorder - If true, the borders of the JToolButton will only be drawn if the mouse pointer is "rolling over" the JToolButton -- that is, when the mouse pointer is within the boundaries of the JToolButton. If false, the borders of the JToolButton are always drawn.
public JToolButton(javax.swing.Icon icon,
boolean hasRolloverBorder,
java.awt.Dimension dim)
JToolButton that displays the specified Icon and displays its borders according to the hasRolloverBorder parameter. The specified Dimension is used to indicate the size of the JToolButton.icon - The Icon to display in the button. If null, no icon is displayed.hasRolloverBorder - If true, the borders of the JToolButton will only be drawn if the mouse pointer is "rolling over" the JToolButton -- that is, when the mouse pointer is within the boundaries of the JToolButton. If false, the borders of the JToolButton are always drawn.dim - The size of the button. If null, the button's size defaults to 28x25.public void setFixedSize(java.awt.Dimension dim)
Dimension, essentially setting a fixed size for the JToolButton.public javax.swing.border.Border getLoweredBorder()
Border object that will be used to render the button border when the button is pressed.public void setLoweredBorder(javax.swing.border.Border loweredBorder)
Border object that will be used to render the button border when the button is pressed.public javax.swing.border.Border getRaisedBorder()
Border object that will be used to render the button border when the button is not being pressed.public void setRaisedBorder(javax.swing.border.Border raisedBorder)
Border object that will be used to render the button border when the button is not being pressed.protected javax.swing.event.ChangeListener getChangeListener(boolean hasRolloverBorder)
ChangeListener instance that will be used to listen for ChangeEvents coming from the JToolButton's ButtonModel. The constructor uses this method to get the ChangeListener, so subclasses can use this method to customize what ChangeListener will be added to the JToolButton.AbstractButton.getModel(), ButtonModel.addChangeListener(ChangeListener)