Класс Button
- java.lang.Object
-
- java.awt.Component
-
- java.awt.Button
- Все реализованные интерфейсы:
-
ImageObserver,MenuContainer,Serializable,Accessible
public class Button extends Component implements Accessible
Этот класс создаёт кнопку с меткой. При нажатии на кнопку приложение может вызвать какое-либо действие. На изображении показаны три вида кнопки "Quit" в операционной системе Solaris:
На первом изображении показан вид кнопки в обычном состоянии. На втором изображении показан вид кнопки, когда у неё есть фокус ввода. Контур кнопки затемнён, чтобы пользователь знал, что это активный объект. На третьем изображении показан вид кнопки, когда пользователь наводит курсор мыши на кнопку, и таким образом запрашивает выполнение действия.
Жест нажатия на кнопку мышью ассоциируется с одним экземпляром 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 | Этот класс реализует поддержку доступности для класса |
Вложенные классы/интерфейсы, объявленные в классе 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() | Возвращает |
String | getActionCommand() | Возвращает имя команды события действия, генерируемого этой кнопкой. |
ActionListener[] | getActionListeners() | Возвращает массив всех обработчиков событий действия, зарегистрированных на этой кнопке. |
String | getLabel() | Возвращает метку этой кнопки. |
<T extends EventListener> | getListeners(Class<T> listenerType) | Возвращает массив всех объектов, в данный момент зарегистрированных как |
protected String | paramString() | Возвращает строку, представляющую состояние этого |
protected void | processActionEvent(ActionEvent e) | Обрабатывает события действия, происходящие на этой кнопке, перенаправив их любым зарегистрированным объектам |
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