Класс Button

java.lang.Object

java.awt.Component

java.awt.Button

Все реализуемые интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible

public class Button extends Component implements Accessible

Этот класс создает кнопку с меткой. Приложение может вызвать какое-либо действие при нажатии на кнопку. На этом изображении показаны три вида кнопки «Quit» в операционной системе Solaris:

The following context describes the
graphic

Первый вид показывает кнопку в нормальном состоянии. Второй вид показывает кнопку, когда она имеет фокус ввода. Её контур затемнён, чтобы пользователь знал, что это активный объект. Третий вид показывает кнопку, когда пользователь наводит курсор мыши на кнопку, тем самым запрашивая выполнение действия.

Жест нажатия на кнопку мышью связан с одним экземпляром события ActionEvent, которое отправляется, когда кнопка мыши нажимается и отпускается над кнопкой. Если приложение заинтересовано в том, чтобы узнать, когда кнопка нажата, но не отпущена, как отдельное действие, оно может специализировать processMouseEvent, или оно может зарегистрировать себя как слушатель событий мыши, вызвав addMouseListener. Оба эти метода определены классом Component, абстрактным суперклассом всех компонентов.

Когда кнопка нажимается и отпускается, AWT отправляет экземпляр события ActionEvent в кнопку, вызвав processEvent на кнопке. Метод processEvent кнопки получает все события для кнопки; он передает событие действия, вызвав свой собственный метод processActionEvent. Последний метод передает событие действия любому обработчику событий действия, который зарегистрировал интерес к событиям действия, сгенерированным этой кнопкой.

Если приложение хочет выполнить некоторое действие, основанное на нажатии и отпускании кнопки, оно должно реализовать интерфейс ActionListener и зарегистрировать нового слушателя для получения событий от этой кнопки, вызвав метод addActionListener кнопки. Приложение может использовать командную строку кнопки в качестве протокола обмена сообщениями.

С:

1.0

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`protected class`	`Button.AccessibleAWTButton`	Этот класс реализует поддержку доступности для класса `Button`.

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

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

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

Поля, объявленные в классе 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

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

Конструктор	Описание
`Button()`	Создаёт кнопку с пустой строкой в качестве метки.
`Button(String label)`	Создаёт кнопку с заданной меткой.

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

Модификатор и тип	Метод	Описание
`void`	`addActionListener(ActionListener l)`	Добавляет указанного обработчика событий действия для получения событий действия от этой кнопки.
`void`	`addNotify()`	Создаёт компаньона кнопки.
`AccessibleContext`	`getAccessibleContext()`	Возвращает `AccessibleContext`, связанный с этим `Button`.
`String`	`getActionCommand()`	Возвращает имя команды события действия, сгенерированного этой кнопкой.
`ActionListener[]`	`getActionListeners()`	Возвращает массив всех обработчиков событий действия, зарегистрированных на этой кнопке.
`String`	`getLabel()`	Возвращает метку этой кнопки.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, в настоящее время зарегистрированных как `FooListener` на этом `Button`.
`protected String`	`paramString()`	Возвращает строку, представляющую состояние этого `Button`.
`protected void`	`processActionEvent(ActionEvent e)`	Обрабатывает события действия, возникающие на этой кнопке, рассылаемые всем зарегистрированным `ActionListener` объектам.
`protected void`	`processEvent(AWTEvent e)`	Обрабатывает события на этой кнопке.
`void`	`removeActionListener(ActionListener l)`	Удаляет указанного обработчика событий действия, чтобы он больше не получал события действия от этой кнопки.
`void`	`setActionCommand(String command)`	Устанавливает имя команды для события действия, генерируемого этой кнопкой.
`void`	`setLabel(String label)`	Устанавливает метку кнопки на указанную строку.

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

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

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

Подробное описание конструкторов

Кнопка

public Button() throws HeadlessException

Создаёт кнопку с пустой строкой в качестве метки.

Выбрасывает:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true

См. также:

Кнопка

public Button(String label) throws HeadlessException

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

Параметры:

label - строка-метка для кнопки, или null для отсутствия метки

Выбрасывает:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true

См. также:

Подробное описание методов

addNotify

public void addNotify()

Создаёт виджет-представителя кнопки. Виджет-представитель кнопки позволяет приложению изменять внешний вид кнопки без изменения её функциональности.

Переопределяет:

addNotify в классе Component

См. также:

getLabel

public String getLabel()

Возвращает метку этой кнопки.

Возвращает:

метка кнопки, или null, если у кнопки нет метки.

См. также:

setLabel

public void setLabel(String label)

Устанавливает метку кнопки на указанную строку.

Параметры:

label - новая метка, или null, если у кнопки нет метки.

См. также:

setActionCommand

public void setActionCommand(String command)

Устанавливает имя команды для события действия, срабатывающего при нажатии на эту кнопку. По умолчанию это имя команды совпадает с меткой кнопки.

Параметры:

command - строка, используемая для установки имени команды кнопки. Если строка равна null, то имя команды устанавливается в соответствии с меткой кнопки.

С:

1.1

См. также:

getActionCommand

public String getActionCommand()

Возвращает имя команды события действия, срабатывающего при нажатии на эту кнопку. Если имя команды равно null (по умолчанию), этот метод возвращает метку кнопки.

Возвращает:: имя команды действия (или метку) для этой кнопки

addActionListener

public void addActionListener(ActionListener l)

Добавляет указанного обработчика событий действия для получения событий действия от этой кнопки. События действия происходят при нажатии или отпускании мыши над этой кнопкой. Если l равно null, исключение не выбрасывается, и никаких действий не выполняется.

См. Проблемы с потоками AWT для получения подробностей о модели потоков AWT.

Параметры:

l - обработчик событий действия

С:

1.1

См. также:

removeActionListener

public void removeActionListener(ActionListener l)

Удаляет указанного обработчика событий действия, чтобы он больше не получал события действия от этой кнопки. События действия происходят при нажатии или отпускании мыши над этой кнопкой. Если l равно null, исключение не выбрасывается, и никаких действий не выполняется.

См. Проблемы с потоками AWT для получения подробностей о модели потоков AWT.

Параметры:

l - обработчик событий действия

С:

1.1

См. также:

getActionListeners

public ActionListener[] getActionListeners()

Возвращает массив всех обработчиков событий действия, зарегистрированных на этой кнопке.

Возвращает:

все обработчики событий действия этой кнопки или пустой массив, если обработчики событий действия не зарегистрированы

С:

1.4

См. также:

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

Возвращает массив всех объектов, зарегистрированных в качестве обработчиков событий на этой кнопке. Обработчики событий регистрируются с помощью метода addFooListener.

Вы можете указать аргумент listenerType с помощью литерала класса, например, FooListener.class. Например, вы можете запросить обработчики событий действия для Button b с помощью следующего кода:

ActionListener[] als = (ActionListener[])(b.getListeners(ActionListener.class));

Если таких обработчиков нет, этот метод возвращает пустой массив.

Переопределяет:

getListeners в классе Component

Параметры типа:

T - тип обработчиков

Параметры:

listenerType - тип запрашиваемых обработчиков; этот параметр должен указывать интерфейс, унаследованный от java.util.EventListener

Возвращает:

массив всех объектов, зарегистрированных как обработчики событий на этой кнопке, или пустой массив, если такие обработчики не были добавлены

Выбрасывает:

ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener

С:

1.3

См. также:

processEvent

protected void processEvent(AWTEvent e)

Обрабатывает события на этой кнопке. Если событие является экземпляром ActionEvent, этот метод вызывает метод processActionEvent. В противном случае он вызывает processEvent у родительского класса.

Обратите внимание, что если параметр события равен null, поведение не определено и может привести к исключению.

Переопределяет:

processEvent в классе Component

Параметры:

e - событие

С:

1.1

См. также:

processActionEvent

protected void processActionEvent(ActionEvent e)

Обрабатывает события действия, происходящие на этой кнопке, передавая их зарегистрированным объектам-обработчикам событий.

Этот метод не вызывается, если события действия не включены для этой кнопки. События действия включаются, когда происходит одно из следующих событий:

Объект-обработчик событий регистрируется с помощью addActionListener.
События действия включаются с помощью enableEvents.

Параметры:

e - событие действия

С:

1.1

См. также:

paramString

protected String paramString()

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

Переопределяет:: paramString в классе Component
Возвращает:: строку параметров этой кнопки

getAccessibleContext

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

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

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: объект AccessibleAWTButton, который является AccessibleContext этого Button
С:: 1.3

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/Button.html