Класс JButton

Все реализованные интерфейсы:
ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible, SwingConstants
Прямые известные подклассы:
BasicArrowButton, MetalComboBoxButton 
@JavaBean(defaultProperty="UIClassID",
          description="An implementation of a \"push\" button.")
public class JButton
extends AbstractButton
implements Accessible

Реализация кнопки "нажатия".

Кнопки могут быть настроены и в некоторой степени управляться Action. Использование Action с кнопкой имеет множество преимуществ по сравнению с непосредственной настройкой кнопки. Подробнее см. Компоненты Swing, поддерживающие Action, а также информацию в Как использовать действия (раздел в учебнике Java).

См. Как использовать кнопки, флажки и радиокнопки в учебнике Java для получения информации и примеров использования кнопок.

Предупреждение: Swing не потокобезопасен. Более подробная информация представлена в Политика потоков Swing.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, работающими в одной версии Swing. Начиная с версии 1.4, добавлена поддержка длительного хранения всех JavaBeans™ в пакете java.beans. Обратитесь к XMLEncoder.

С:
1.2
См. также:
Сериализованная форма

Вложенные классы

Модификатор и тип Класс Описание
protected class  JButton.AccessibleJButton

Этот класс реализует поддержку доступности для класса JButton.

Вложенные классы/интерфейсы, объявленные в классе javax.swing.AbstractButton

AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener

Вложенные классы/интерфейсы, объявленные в классе javax.swing.JComponent

JComponent.AccessibleJComponent

Вложенные классы/интерфейсы, объявленные в классе java.awt.Container

Container.AccessibleAWTContainer

Вложенные классы/интерфейсы, объявленные в классе java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Краткое описание полей

Поля, объявленные в классе javax.swing.AbstractButton

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

Поля, объявленные в классе javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Поля, объявленные в классе java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Поля, объявленные в интерфейсе javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Краткое описание конструкторов

Конструктор Описание
JButton()

Создаёт кнопку без заданного текста или изображения.
JButton​(String text)

Создаёт кнопку с текстом.
JButton​(String text, Icon icon)

Создаёт кнопку с начальным текстом и изображением.
JButton​(Action a)

Создаёт кнопку, свойства которой взяты из переданного Action.
JButton​(Icon icon)

Создаёт кнопку с изображением.

Краткое описание методов

Модификатор и тип Метод Описание
AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанную с этой кнопкой.
String getUIClassID()

Возвращает строку, которая указывает имя класса L&F, отображающего этот компонент.
boolean isDefaultButton()

Получает значение свойства defaultButton, которое, если true, означает, что эта кнопка является текущей кнопкой по умолчанию для её JRootPane.
boolean isDefaultCapable()

Получает значение свойства defaultCapable.
protected String paramString()

Возвращает строковое представление этого JButton.
void removeNotify()

Переопределяет JComponent.removeNotify для проверки, установлена ли эта кнопка в данный момент как кнопка по умолчанию в RootPane, и, если это так, устанавливает кнопку по умолчанию RootPane на null, чтобы убедиться, что RootPane не хранит недопустимую ссылку на кнопку.
void setDefaultCapable​(boolean defaultCapable)

Устанавливает свойство defaultCapable, которое определяет, может ли эта кнопка стать кнопкой по умолчанию для своей панели корней.
void updateUI()

Сбрасывает свойство UI до значения из текущей темы оформления.

Методы, объявленные в классе javax.swing.AbstractButton

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

Методы, объявленные в классе javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, 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, update

Методы, объявленные в классе java.awt.Container

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

Методы, объявленные в классе java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, 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, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Конструкторы

JButton

public JButton()

Создаёт кнопку без заданного текста или значка.

JButton

public JButton(Icon icon)

Создаёт кнопку со значком.

Параметры:
icon - изображение значка для отображения на кнопке

JButton

@ConstructorProperties("text")
public JButton(String text)

Создаёт кнопку с текстом.

Параметры:
text - текст кнопки

JButton

public JButton(Action a)

Создаёт кнопку, свойства которой берутся из переданного Action.

Параметры:
a - Action , используемый для задания новой кнопки
С момента:
1.3

JButton

public JButton(String text,
               Icon icon)

Создаёт кнопку с начальным текстом и значком.

Параметры:
text - текст кнопки
icon - изображение значка для отображения на кнопке

Методы

updateUI

public void updateUI()

Сбрасывает свойство UI на значение из текущего внешнего вида.

Переопределяет:
updateUI в классе AbstractButton
См. также:
JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false,
              expert=true,
              description="A string that specifies the name of the L&F class.")
public String getUIClassID()

Возвращает строку, которая определяет имя класса L&F, отображающего этот компонент.

Переопределяет:
getUIClassID в классе JComponent
Возвращает:
строку "ButtonUI"
См. также:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

isDefaultButton

@BeanProperty(bound=false,
              description="Whether or not this button is the default button")
public boolean isDefaultButton()

Получает значение свойства defaultButton, которое, если true, означает, что эта кнопка является текущей кнопкой по умолчанию для своей JRootPane. Большинство внешних видов отображают кнопку по умолчанию по-другому и могут потенциально предоставлять привязки для доступа к кнопке по умолчанию.

Возвращает:
значение свойства defaultButton
См. также:
JRootPane.setDefaultButton(javax.swing.JButton), isDefaultCapable()

isDefaultCapable

public boolean isDefaultCapable()

Получает значение свойства defaultCapable.

Возвращает:
значение свойства defaultCapable
См. также:
setDefaultCapable(boolean), isDefaultButton(), JRootPane.setDefaultButton(javax.swing.JButton)

setDefaultCapable

@BeanProperty(visualUpdate=true,
              description="Whether or not this button can be the default button")
public void setDefaultCapable(boolean defaultCapable)

Устанавливает свойство defaultCapable, которое определяет, может ли эта кнопка стать кнопкой по умолчанию для своей области. Значение по умолчанию свойства defaultCapable равно true, если не указано иначе внешним видом.

Параметры:
defaultCapable - true, если эта кнопка сможет стать кнопкой по умолчанию для RootPane; в противном случае false
См. также:
isDefaultCapable()

removeNotify

public void removeNotify()

Переопределяет JComponent.removeNotify для проверки, установлена ли эта кнопка в качестве кнопки по умолчанию в RootPane, и если да, то устанавливает кнопку по умолчанию RootPane в null, чтобы убедиться, что RootPane не хранит ссылку на недействительную кнопку.

Переопределяет:
removeNotify в классе AbstractButton
См. также:
JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

paramString

protected String paramString()

Возвращает строковое представление этого JButton. Этот метод предназначен только для отладки, и содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не null.

Переопределяет:
paramString в классе AbstractButton
Возвращает:
строковое представление этого JButton

getAccessibleContext

@BeanProperty(bound=false,
              expert=true,
              description="The AccessibleContext associated with this Button.")
public AccessibleContext getAccessibleContext()

Получает AccessibleContext , связанный с этим JButton. Для JButtons, AccessibleContext представлен в виде AccessibleJButton. Новый экземпляр AccessibleJButton создаётся при необходимости.

Указано в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Component
Возвращает:
AccessibleJButton, который служит AccessibleContext этого JButton

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/javax/swing/JButton.html

Spec-Zone .ru
спецификации, руководства, описания, API