Класс 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 кнопки. Приложение может использовать команду действия кнопки в качестве протокола обмена сообщениями.

С момента:: JDK1.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, getPeer, 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, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, 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

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

Button

public Button()
       throws HeadlessException

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

Выбрасывает:: HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true
См. также:: GraphicsEnvironment.isHeadless()

Button

public Button(String label)
       throws HeadlessException

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

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

Методы

addNotify

public void addNotify()

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

Переопределяет:: addNotify в классе Component
См. также:: Toolkit.createButton(java.awt.Button), 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 , то имя команды устанавливается в соответствие с меткой кнопки.
С:: JDK1.1
См. также:: ActionEvent

getActionCommand

public String getActionCommand()

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

addActionListener

public void addActionListener(ActionListener l)

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

См. AWT Threading Issues для получения подробной информации о модели потоков AWT.

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

removeActionListener

public void removeActionListener(ActionListener l)

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

См. AWT Threading Issues для получения подробной информации о модели потоков AWT.

Параметры:: l - обработчик событий действия
С:: JDK1.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
Параметры:: 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 - событие
С:: JDK1.1
См. также:: ActionEvent, processActionEvent(java.awt.event.ActionEvent)

processActionEvent

protected void processActionEvent(ActionEvent e)

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

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

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

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

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

paramString

protected String paramString()

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: объект AccessibleAWTButton, который является контекстом доступа к данной кнопке
С:: 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.