java.awt

Кнопка класса

java.lang. Объект

java.awt. Компонент

java.awt. Кнопка

Все Реализованные Интерфейсы:

ImageObserver, MenuContainer, Сериализуемый, Доступный

public class Button
extends Component
implements Accessible

Этот class создает маркированную кнопку. Приложение может заставить некоторое действие происходить, когда кнопка нажимается. Это изображение изображает три представления"Quit"кнопка, как это появляется под операционной системой Соляриса:

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

Жест щелчка по кнопке с мышью связывается с одним экземпляром 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	Кнопка. AccessibleAWTButton Этот class реализует поддержку доступности Button class.

Вложенные классы/интерфейсы, наследованные от class java.awt. Компонент

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

Полевая Сводка

Поля, наследованные от class java.awt. Компонент

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.
Строка	getActionCommand() Возвращает название команды события действия, запущенного этой кнопкой.
ActionListener[]	getActionListeners() Возвращает массив всех слушателей действия, зарегистрированных на этой кнопке.
Строка	getLabel() Получает метку этой кнопки.
<T extends EventListener> T[]	getListeners(Class<T> listenerType) Возвращает массив всех объектов, в настоящий момент зарегистрированных как FooListeners на это 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) Устанавливает метку кнопки, чтобы быть указанной строкой.

Методы, наследованные от class java.awt. Компонент

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

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

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 в class 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 является нулем, никакое исключение не выдается, и никакое действие не выполняется.

Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.

Параметры:

l - слушатель действия

С тех пор:

JDK1.1

См. Также:

removeActionListener(java.awt.event.ActionListener), getActionListeners(), ActionListener

removeActionListener

public void removeActionListener(ActionListener l)

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

Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.

Параметры:

l - слушатель действия

С тех пор:

JDK1.1

См. Также:

addActionListener(java.awt.event.ActionListener), getActionListeners(), ActionListener

getActionListeners

public ActionListener[] getActionListeners()

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

Возвраты:

вся эта кнопка ActionListeners или пустой массив, если никакие слушатели действия в настоящий момент не регистрируются

С тех пор:

1.4

См. Также:

addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener), ActionListener

getListeners

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

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

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

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

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

Переопределения:

getListeners в class Component

Параметры:

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

Возвраты:

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

Броски:

ClassCastException - если listenerType не определяет class или интерфейс, который реализует java.util.EventListener

С тех пор:

1.3

См. Также:

getActionListeners()

processEvent

protected void processEvent(AWTEvent e)

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

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

Переопределения:

processEvent в class Component

Параметры:

e - событие

С тех пор:

JDK1.1

См. Также:

ActionEvent, processActionEvent(java.awt.event.ActionEvent)

processActionEvent

protected void processActionEvent(ActionEvent e)

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

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

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

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

Параметры:

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

С тех пор:

JDK1.1

См. Также:

ActionListener, addActionListener(java.awt.event.ActionListener), Component.enableEvents(long)

paramString

protected String paramString()

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

Переопределения:

paramString в class Component

Возвраты:

строка параметра этой кнопки

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Определенный:

getAccessibleContext в интерфейсе Accessible

Переопределения:

getAccessibleContext в class Component

Возвраты:

AccessibleAWTButton это служит AccessibleContext из этого Button

С тех пор:

1.3