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.AccessibleJButton
javax.swing.AbstractButton.AccessibleAbstractButton, javax.swing.AbstractButton.ButtonChangeListener
javax.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_PROPERTY
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
BOTTOM_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 ChangeEvent s 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, updateUI
actionPropertyChanged, 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, setVerticalTextPosition
addAncestorListener, 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, hide, 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, update
add, 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, validateTree
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, 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, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
public 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 ChangeEvent
s 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)