Класс 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
См. также:
ActionEvent, ActionListener, Component.processMouseEvent(java.awt.event.MouseEvent), Component.addMouseListener(java.awt.event.MouseListener), Сериализованная форма

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

Модификатор и тип Класс Описание
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
См. также:
GraphicsEnvironment.isHeadless()

Кнопка

public Button(String label)
       throws HeadlessException

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

Параметры:
label - строковая метка для кнопки, или null для отсутствия метки
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
См. также:
GraphicsEnvironment.isHeadless()

Методы

addNotify

public void addNotify()

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

Переопределяет:
addNotify в классе Component
См. также:
Component.getToolkit()

getLabel

public String getLabel()

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

Возвращает:
метку кнопки, или null если у кнопки нет метки.
См. также:
setLabel(java.lang.String)

setLabel

public void setLabel(String label)

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

Параметры:
label - новая метка, или null если кнопка не имеет метки.
См. также:
getLabel()

setActionCommand

public void setActionCommand(String command)

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

Параметры:
command - строка, используемая для установки команды действия кнопки. Если строка null , то команда действия устанавливается, чтобы соответствовать метке кнопки.
С тех пор:
1.1
См. также:
ActionEvent

getActionCommand

public String getActionCommand()

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

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

addActionListener

public void addActionListener(ActionListener l)

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

См. Вопросы многопоточности AWT для получения подробностей о модели многопоточности AWT.

Параметры:
l - обработчик событий действия
С тех пор:
1.1
См. также:
removeActionListener(java.awt.event.ActionListener), getActionListeners(), ActionListener

removeActionListener

public void removeActionListener(ActionListener l)

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

См. Вопросы многопоточности AWT для получения подробностей о модели многопоточности AWT.

Параметры:
l - обработчик событий действия
С тех пор:
1.1
См. также:
addActionListener(java.awt.event.ActionListener), getActionListeners(), ActionListener

getActionListeners

public ActionListener[] getActionListeners()

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

Возвращает:
все обработчики событий действия этой кнопки или пустой массив, если обработчики событий действия не зарегистрированы
С тех пор:
1.4
См. также:
addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener), ActionListener

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
См. также:
getActionListeners()

processEvent

protected void processEvent(AWTEvent e)

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

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

Переопределяет:
processEvent в классе Component
Параметры:
e - событие
С тех пор:
1.1
См. также:
ActionEvent, processActionEvent(java.awt.event.ActionEvent)

processActionEvent

protected void processActionEvent(ActionEvent e)

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

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

  • Объект ActionListener зарегистрирован через addActionListener.
  • События действия включены через enableEvents.

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

Параметры:
e - событие действия
С тех пор:
1.1
См. также:
ActionListener, addActionListener(java.awt.event.ActionListener), Component.enableEvents(long)

paramString

protected String paramString()

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

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

getAccessibleContext

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

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

Задано:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Component
Возвращает:
контекст AccessibleAWTButton, служащий контекстом AccessibleContext для этой кнопки
С тех пор:
1.3

© 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/java/awt/Button.html

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