Класс 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`.

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

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

Модификатор и тип	Класс	Описание
`protected class`	`Component.AccessibleAWTComponent`	Внутренний класс Component, обеспечивающий поддержку специальных возможностей по умолчанию.
`static enum`	`Component.BaselineResizeBehavior`	Перечисление распространенных способов изменения базовой линии компонента при изменении его размера.
`protected class`	`Component.BltBufferStrategy`	Внутренний класс для копирования экранных поверхностей в компонент.
`protected class`	`Component.FlipBufferStrategy`	Внутренний класс для переключения буферов компонента.

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

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Модификатор и тип	Поле	Описание
`protected AccessibleContext`	`accessibleContext`	`AccessibleContext`, связанный с этим `Component`.
`static final float`	`BOTTOM_ALIGNMENT`	Константа для удобства использования `getAlignmentY`.
`static final float`	`CENTER_ALIGNMENT`	Константа для удобства использования `getAlignmentY` и `getAlignmentX`.
`static final float`	`LEFT_ALIGNMENT`	Константа для удобства использования `getAlignmentX`.
`static final float`	`RIGHT_ALIGNMENT`	Константа для удобства использования `getAlignmentX`.
`static final float`	`TOP_ALIGNMENT`	Константа для удобства использования `getAlignmentY()`.

Поля, объявленные в интерфейсе ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Модификатор и тип	Поле	Описание
`static final int`	`ABORT`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что создание изображения, за которым велось асинхронное наблюдение, было прервано до завершения.
`static final int`	`ALLBITS`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что статическое изображение, которое ранее было нарисовано, теперь готово и может быть нарисовано повторно в окончательном виде.
`static final int`	`ERROR`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что при асинхронном отслеживании изображения произошла ошибка.
`static final int`	`FRAMEBITS`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что стал доступен для повторного рисования еще один полный кадр много кадрового изображения, которое ранее было нарисовано.
`static final int`	`HEIGHT`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что теперь доступна высота исходного изображения; ее можно получить из аргумента height метода обратного вызова imageUpdate.
`static final int`	`PROPERTIES`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что теперь доступны свойства изображения.
`static final int`	`SOMEBITS`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что стали доступны дополнительные пиксели, необходимые для рисования масштабированной версии изображения.
`static final int`	`WIDTH`	Этот флаг в аргументе infoflags метода imageUpdate указывает, что теперь доступна ширина исходного изображения; ее можно получить из аргумента width метода обратного вызова imageUpdate.

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

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

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

Модификатор и тип	Метод	Описание
`void`	`addActionListener(ActionListener l)`	Добавляет указанного слушателя действий для получения событий действий от этой кнопки.
`void`	`addNotify()`	Создает peer-объект кнопки.
`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)`	Задает для кнопки указанную строку в качестве метки.

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

Модификатор и тип	Метод	Описание
`boolean`	`action(Event evt, Object what)`	Устарело. Начиная с JDK версии 1.1, этот компонент следует регистрировать как ActionListener компонента, генерирующего события действий.
`void`	`add(PopupMenu popup)`	Добавляет указанный всплывающий меню к компоненту.
`void`	`addComponentListener(ComponentListener l)`	Добавляет указанный слушатель компонентов для получения событий компонентов от этого компонента.
`void`	`addFocusListener(FocusListener l)`	Добавляет указанный слушатель фокуса для получения событий фокуса от этого компонента, когда компонент получает фокус ввода.
`void`	`addHierarchyBoundsListener(HierarchyBoundsListener l)`	Добавляет указанный слушатель границ иерархии для получения событий границ иерархии от этого компонента при изменении иерархии, к которой относится этот контейнер.
`void`	`addHierarchyListener(HierarchyListener l)`	Добавляет указанный слушатель иерархии для получения событий изменения иерархии от этого компонента при изменении иерархии, к которой относится этот контейнер.
`void`	`addInputMethodListener(InputMethodListener l)`	Добавляет указанный слушатель метода ввода для получения событий метода ввода от этого компонента.
`void`	`addKeyListener(KeyListener l)`	Добавляет указанный слушатель клавиатуры для получения событий клавиатуры от этого компонента.
`void`	`addMouseListener(MouseListener l)`	Добавляет указанный слушатель мыши для получения событий мыши от этого компонента.
`void`	`addMouseMotionListener(MouseMotionListener l)`	Добавляет указанный слушатель движения мыши для получения событий движения мыши от этого компонента.
`void`	`addMouseWheelListener(MouseWheelListener l)`	Добавляет указанный слушатель колесика мыши для получения событий колесика мыши от этого компонента.
`void`	`addPropertyChangeListener(PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список слушателей.
`void`	`addPropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список слушателей для определенного свойства.
`void`	`applyComponentOrientation(ComponentOrientation orientation)`	Задает свойство `ComponentOrientation` этого компонента и всех содержащихся в нем компонентов.
`boolean`	`areFocusTraversalKeysSet(int id)`	Возвращает значение, указывающее, было ли явно задано множество клавиш перехода фокуса для указанной операции перехода фокуса для этого компонента.
`Rectangle`	`bounds()`	Устарело. Начиная с JDK версии 1.1 заменено на `getBounds()`.
`int`	`checkImage(Image image, int width, int height, ImageObserver observer)`	Возвращает состояние создания экранного представления указанного изображения.
`int`	`checkImage(Image image, ImageObserver observer)`	Возвращает состояние создания экранного представления указанного изображения.
`protected AWTEvent`	`coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)`	При возможности объединяет публикуемое событие с существующим событием.
`boolean`	`contains(int x, int y)`	Проверяет, «содержит» ли этот компонент указанную точку, где `x` и `y` заданы относительно системы координат этого компонента.
`boolean`	`contains(Point p)`	Проверяет, «содержит» ли этот компонент указанную точку, координаты x и y которой заданы относительно системы координат этого компонента.
`Image`	`createImage(int width, int height)`	Создает рисуемое внеэкранное изображение для двойной буферизации.
`Image`	`createImage(ImageProducer producer)`	Создает изображение из указанного производителя изображений.
`VolatileImage`	`createVolatileImage(int width, int height)`	Создает изменяемое рисуемое внеэкранное изображение для двойной буферизации.
`VolatileImage`	`createVolatileImage(int width, int height, ImageCapabilities caps)`	Создает изменяемое рисуемое внеэкранное изображение с указанными возможностями.
`void`	`deliverEvent(Event e)`	Устарело. Начиная с JDK версии 1.1 заменено на `dispatchEvent(AWTEvent e)`.
`void`	`disable()`	Устарело. Начиная с JDK версии 1.1 заменено на `setEnabled(boolean)`.
`protected final void`	`disableEvents(long eventsToDisable)`	Отключает доставку этому компоненту событий, определенных параметром маски событий.
`final void`	`dispatchEvent(AWTEvent e)`	Передает событие этому компоненту или одному из его подкомпонентов.
`void`	`doLayout()`	Предлагает менеджеру компоновки выполнить компоновку этого компонента.
`void`	`enable()`	Устарело. Начиная с JDK версии 1.1 заменено на `setEnabled(boolean)`.
`void`	`enable(boolean b)`	Устарело. Начиная с JDK версии 1.1 заменено на `setEnabled(boolean)`.
`protected final void`	`enableEvents(long eventsToEnable)`	Включает доставку этому компоненту событий, определенных параметром маски событий.
`void`	`enableInputMethods(boolean enable)`	Включает или отключает поддержку методов ввода для этого компонента.
`protected void`	`firePropertyChange(String propertyName, boolean oldValue, boolean newValue)`	Поддержка регистрации изменений связанных свойств типа boolean.
`void`	`firePropertyChange(String propertyName, byte oldValue, byte newValue)`	Сообщает об изменении связанного свойства.
`void`	`firePropertyChange(String propertyName, char oldValue, char newValue)`	Сообщает об изменении связанного свойства.
`void`	`firePropertyChange(String propertyName, double oldValue, double newValue)`	Сообщает об изменении связанного свойства.
`void`	`firePropertyChange(String propertyName, float oldValue, float newValue)`	Сообщает об изменении связанного свойства.
`protected void`	`firePropertyChange(String propertyName, int oldValue, int newValue)`	Поддержка регистрации изменений связанных свойств типа integer.
`void`	`firePropertyChange(String propertyName, long oldValue, long newValue)`	Сообщает об изменении связанного свойства.
`void`	`firePropertyChange(String propertyName, short oldValue, short newValue)`	Сообщает об изменении связанного свойства.
`protected void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)`	Поддержка регистрации изменений связанных свойств типа Object.
`float`	`getAlignmentX()`	Возвращает выравнивание по оси x.
`float`	`getAlignmentY()`	Возвращает выравнивание по оси y.
`Color`	`getBackground()`	Получает цвет фона этого компонента.
`int`	`getBaseline(int width, int height)`	Возвращает базовую линию.
`Component.BaselineResizeBehavior`	`getBaselineResizeBehavior()`	Возвращает значение перечисления, указывающее, как изменяется базовая линия компонента при изменении его размера.
`Rectangle`	`getBounds()`	Получает границы этого компонента в виде объекта `Rectangle`.
`Rectangle`	`getBounds(Rectangle rv)`	Сохраняет границы этого компонента в «возвращаемое значение» rv и возвращает rv.
`ColorModel`	`getColorModel()`	Получает экземпляр `ColorModel`, используемый для отображения компонента на устройстве вывода.
`Component`	`getComponentAt(int x, int y)`	Определяет, содержит ли этот компонент или один из его непосредственных подкомпонентов точку с координатами (x, y); если содержит, возвращает содержащий ее компонент.
`Component`	`getComponentAt(Point p)`	Возвращает компонент или подкомпонент, содержащий указанную точку.
`ComponentListener[]`	`getComponentListeners()`	Возвращает массив всех слушателей компонентов, зарегистрированных для этого компонента.
`ComponentOrientation`	`getComponentOrientation()`	Получает зависящую от языка ориентацию, которая будет использоваться для упорядочивания элементов или текста внутри этого компонента.
`Cursor`	`getCursor()`	Получает курсор, заданный для компонента.
`DropTarget`	`getDropTarget()`	Получает `DropTarget`, связанный с этим `Component`.
`Container`	`getFocusCycleRootAncestor()`	Возвращает Container, являющийся корнем цикла обхода фокуса для этого Component.
`FocusListener[]`	`getFocusListeners()`	Возвращает массив всех слушателей фокуса, зарегистрированных для этого компонента.
`Set<AWTKeyStroke>`	`getFocusTraversalKeys(int id)`	Возвращает множество клавиш перехода фокуса для указанной операции перехода фокуса этого Component.
`boolean`	`getFocusTraversalKeysEnabled()`	Возвращает значение, указывающее, включены ли клавиши перехода фокуса для этого Component.
`Font`	`getFont()`	Получает шрифт этого компонента.
`FontMetrics`	`getFontMetrics(Font font)`	Получает метрики указанного шрифта.
`Color`	`getForeground()`	Получает цвет переднего плана этого компонента.
`Graphics`	`getGraphics()`	Создает графический контекст для этого компонента.
`GraphicsConfiguration`	`getGraphicsConfiguration()`	Получает `GraphicsConfiguration`, связанный с этим `Component`.
`int`	`getHeight()`	Возвращает текущую высоту этого компонента.
`HierarchyBoundsListener[]`	`getHierarchyBoundsListeners()`	Возвращает массив всех слушателей границ иерархии, зарегистрированных для этого компонента.
`HierarchyListener[]`	`getHierarchyListeners()`	Возвращает массив всех слушателей иерархии, зарегистрированных для этого компонента.
`boolean`	`getIgnoreRepaint()`	Возвращает значение, указывающее, следует ли игнорировать сообщения о рисовании, полученные от операционной системы.
`InputContext`	`getInputContext()`	Получает контекст ввода, используемый этим компонентом для взаимодействия с методами ввода при вводе текста в компонент.
`InputMethodListener[]`	`getInputMethodListeners()`	Возвращает массив всех слушателей методов ввода, зарегистрированных для этого компонента.
`InputMethodRequests`	`getInputMethodRequests()`	Получает обработчик запросов метода ввода, поддерживающий запросы методов ввода для этого компонента.
`KeyListener[]`	`getKeyListeners()`	Возвращает массив всех слушателей клавиатуры, зарегистрированных для этого компонента.
`Locale`	`getLocale()`	Получает локаль этого компонента.
`Point`	`getLocation()`	Получает расположение этого компонента в виде точки, задающей его левый верхний угол.
`Point`	`getLocation(Point rv)`	Сохраняет начало координат x,y этого компонента в «возвращаемое значение» rv и возвращает rv.
`Point`	`getLocationOnScreen()`	Получает расположение этого компонента в виде точки, задающей его левый верхний угол в системе координат экрана.
`Dimension`	`getMaximumSize()`	Получает максимальный размер этого компонента.
`Dimension`	`getMinimumSize()`	Получает минимальный размер этого компонента.
`MouseListener[]`	`getMouseListeners()`	Возвращает массив всех слушателей мыши, зарегистрированных для этого компонента.
`MouseMotionListener[]`	`getMouseMotionListeners()`	Возвращает массив всех слушателей движения мыши, зарегистрированных для этого компонента.
`Point`	`getMousePosition()`	Возвращает положение указателя мыши в системе координат этого `Component`, если `Component` находится непосредственно под указателем мыши; в противном случае возвращает `null`.
`MouseWheelListener[]`	`getMouseWheelListeners()`	Возвращает массив всех слушателей колесика мыши, зарегистрированных для этого компонента.
`String`	`getName()`	Получает имя компонента.
`Container`	`getParent()`	Получает родительский компонент этого компонента.
`Dimension`	`getPreferredSize()`	Получает предпочтительный размер этого компонента.
`PropertyChangeListener[]`	`getPropertyChangeListeners()`	Возвращает массив всех слушателей изменений свойств, зарегистрированных для этого компонента.
`PropertyChangeListener[]`	`getPropertyChangeListeners(String propertyName)`	Возвращает массив всех слушателей, связанных с указанным свойством.
`Dimension`	`getSize()`	Возвращает размер этого компонента в виде объекта `Dimension`.
`Dimension`	`getSize(Dimension rv)`	Сохраняет ширину и высоту этого компонента в «возвращаемое значение» rv и возвращает rv.
`Toolkit`	`getToolkit()`	Получает инструментарий этого компонента.
`final Object`	`getTreeLock()`	Получает объект блокировки этого компонента (объект, которому принадлежит монитор синхронизации потоков) для операций с деревом компонентов AWT и компоновкой.
`int`	`getWidth()`	Возвращает текущую ширину этого компонента.
`int`	`getX()`	Возвращает текущую координату x начала координат компонента.
`int`	`getY()`	Возвращает текущую координату y начала координат компонента.
`boolean`	`gotFocus(Event evt, Object what)`	Устарело. Начиная с JDK версии 1.1 заменено на processFocusEvent(FocusEvent).
`boolean`	`handleEvent(Event evt)`	Устарело. Начиная с JDK версии 1.1 заменено на processEvent(AWTEvent).
`boolean`	`hasFocus()`	Возвращает `true`, если этот `Component` является владельцем фокуса.
`void`	`hide()`	Устарело. Начиная с JDK версии 1.1 заменено на `setVisible(boolean)`.
`boolean`	`imageUpdate(Image img, int infoflags, int x, int y, int w, int h)`	Перерисовывает компонент при изменении изображения.
`boolean`	`inside(int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на contains(int, int).
`void`	`invalidate()`	Признает этот компонент и его предков недействительными.
`boolean`	`isBackgroundSet()`	Возвращает значение, указывающее, был ли цвет фона явно задан для этого Component.
`boolean`	`isCursorSet()`	Возвращает значение, указывающее, был ли курсор явно задан для этого Component.
`boolean`	`isDisplayable()`	Определяет, может ли этот компонент отображаться.
`boolean`	`isDoubleBuffered()`	Возвращает true, если этот компонент рисуется во внеэкранном изображении («буфере»), которое позднее копируется на экран.
`boolean`	`isEnabled()`	Определяет, включен ли этот компонент.
`boolean`	`isFocusable()`	Возвращает значение, указывающее, может ли этот Component получать фокус.
`boolean`	`isFocusCycleRoot(Container container)`	Возвращает значение, указывающее, является ли указанный Container корнем цикла перехода фокуса этого Component.
`boolean`	`isFocusOwner()`	Возвращает `true`, если этот `Component` является владельцем фокуса.
`boolean`	`isFocusTraversable()`	Устарело. Начиная с версии 1.4 заменено на `isFocusable()`.
`boolean`	`isFontSet()`	Возвращает значение, указывающее, был ли шрифт явно задан для этого Component.
`boolean`	`isForegroundSet()`	Возвращает значение, указывающее, был ли цвет переднего плана явно задан для этого Component.
`boolean`	`isLightweight()`	Легковесный компонент не имеет собственного нативного объекта инструментария.
`boolean`	`isMaximumSizeSet()`	Возвращает true, если максимальный размер задан значением, отличным от `null`; в противном случае возвращает false.
`boolean`	`isMinimumSizeSet()`	Возвращает значение, указывающее, был ли вызван `setMinimumSize` с ненулевым значением.
`boolean`	`isOpaque()`	Возвращает true, если этот компонент полностью непрозрачен; по умолчанию возвращает false.
`boolean`	`isPreferredSizeSet()`	Возвращает true, если предпочтительный размер задан значением, отличным от `null`; в противном случае возвращает false.
`boolean`	`isShowing()`	Определяет, отображается ли этот компонент на экране.
`boolean`	`isValid()`	Определяет, является ли этот компонент действительным.
`boolean`	`isVisible()`	Определяет, должен ли этот компонент быть видимым, когда видим его родительский компонент.
`boolean`	`keyDown(Event evt, int key)`	Устарело. Начиная с JDK версии 1.1 заменено на processKeyEvent(KeyEvent).
`boolean`	`keyUp(Event evt, int key)`	Устарело. Начиная с JDK версии 1.1 заменено на processKeyEvent(KeyEvent).
`void`	`layout()`	Устарело. Начиная с JDK версии 1.1 заменено на `doLayout()`.
`void`	`list()`	Выводит описание этого компонента в стандартный системный поток вывода `System.out`.
`void`	`list(PrintStream out)`	Выводит описание этого компонента в указанный поток вывода.
`void`	`list(PrintStream out, int indent)`	Выводит список с указанным отступом в указанный поток печати.
`void`	`list(PrintWriter out)`	Выводит описание в указанный объект записи печати.
`void`	`list(PrintWriter out, int indent)`	Выводит список с указанным отступом в указанный объект записи печати.
`Component`	`locate(int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на getComponentAt(int, int).
`Point`	`location()`	Устарело. Начиная с JDK версии 1.1 заменено на `getLocation()`.
`boolean`	`lostFocus(Event evt, Object what)`	Устарело. Начиная с JDK версии 1.1 заменено на processFocusEvent(FocusEvent).
`Dimension`	`minimumSize()`	Устарело. Начиная с JDK версии 1.1 заменено на `getMinimumSize()`.
`boolean`	`mouseDown(Event evt, int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseDrag(Event evt, int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseEnter(Event evt, int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseExit(Event evt, int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на processMouseEvent(MouseEvent).
`boolean`	`mouseMove(Event evt, int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на processMouseMotionEvent(MouseEvent).
`boolean`	`mouseUp(Event evt, int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на processMouseEvent(MouseEvent).
`void`	`move(int x, int y)`	Устарело. Начиная с JDK версии 1.1 заменено на `setLocation(int, int)`.
`void`	`nextFocus()`	Устарело. Начиная с JDK версии 1.1 заменено на transferFocus().
`void`	`paint(Graphics g)`	Рисует этот компонент.
`void`	`paintAll(Graphics g)`	Рисует этот компонент и все его подкомпоненты.
`boolean`	`postEvent(Event e)`	Устарело. Начиная с JDK версии 1.1 заменено на dispatchEvent(AWTEvent).
`Dimension`	`preferredSize()`	Устарело. Начиная с JDK версии 1.1 заменено на `getPreferredSize()`.
`boolean`	`prepareImage(Image image, int width, int height, ImageObserver observer)`	Подготавливает изображение к отрисовке на этом компоненте с указанной шириной и высотой.
`boolean`	`prepareImage(Image image, ImageObserver observer)`	Подготавливает изображение к отрисовке на этом компоненте.
`void`	`print(Graphics g)`	Печатает этот компонент.
`void`	`printAll(Graphics g)`	Печатает этот компонент и все его подкомпоненты.

`protected void`	`processComponentEvent(ComponentEvent e)`	Обрабатывает события компонента, происходящие с этим компонентом, отправляя их всем зарегистрированным объектам `ComponentListener`.
`protected void`	`processFocusEvent(FocusEvent e)`	Обрабатывает события фокуса, происходящие с этим компонентом, отправляя их всем зарегистрированным объектам `FocusListener`.
`protected void`	`processHierarchyBoundsEvent(HierarchyEvent e)`	Обрабатывает события границ иерархии, происходящие с этим компонентом, отправляя их всем зарегистрированным объектам `HierarchyBoundsListener`.
`protected void`	`processHierarchyEvent(HierarchyEvent e)`	Обрабатывает события иерархии, происходящие с этим компонентом, отправляя их всем зарегистрированным объектам `HierarchyListener`.
`protected void`	`processInputMethodEvent(InputMethodEvent e)`	Обрабатывает события метода ввода, происходящие с этим компонентом, отправляя их всем зарегистрированным объектам `InputMethodListener`.
`protected void`	`processKeyEvent(KeyEvent e)`	Обрабатывает события клавиатуры, происходящие с этим компонентом, отправляя их всем зарегистрированным объектам `KeyListener`.
`protected void`	`processMouseEvent(MouseEvent e)`	Обрабатывает события мыши, происходящие с этим компонентом, отправляя их всем зарегистрированным объектам `MouseListener`.
`protected void`	`processMouseMotionEvent(MouseEvent e)`	Обрабатывает события движения мыши, происходящие с этим компонентом, отправляя их всем зарегистрированным объектам `MouseMotionListener`.
`protected void`	`processMouseWheelEvent(MouseWheelEvent e)`	Обрабатывает события колеса мыши, происходящие с этим компонентом, отправляя их всем зарегистрированным объектам `MouseWheelListener`.
`void`	`remove(MenuComponent popup)`	Удаляет указанное всплывающее меню из компонента.
`void`	`removeComponentListener(ComponentListener l)`	Удаляет указанный прослушиватель компонента, чтобы он больше не получал события компонента от этого компонента.
`void`	`removeFocusListener(FocusListener l)`	Удаляет указанный прослушиватель фокуса, чтобы он больше не получал события фокуса от этого компонента.
`void`	`removeHierarchyBoundsListener(HierarchyBoundsListener l)`	Удаляет указанный прослушиватель границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента.
`void`	`removeHierarchyListener(HierarchyListener l)`	Удаляет указанный прослушиватель иерархии, чтобы он больше не получал события изменения иерархии от этого компонента.
`void`	`removeInputMethodListener(InputMethodListener l)`	Удаляет указанный прослушиватель метода ввода, чтобы он больше не получал события метода ввода от этого компонента.
`void`	`removeKeyListener(KeyListener l)`	Удаляет указанный прослушиватель клавиатуры, чтобы он больше не получал события клавиатуры от этого компонента.
`void`	`removeMouseListener(MouseListener l)`	Удаляет указанный прослушиватель мыши, чтобы он больше не получал события мыши от этого компонента.
`void`	`removeMouseMotionListener(MouseMotionListener l)`	Удаляет указанный прослушиватель движения мыши, чтобы он больше не получал события движения мыши от этого компонента.
`void`	`removeMouseWheelListener(MouseWheelListener l)`	Удаляет указанный прослушиватель колеса мыши, чтобы он больше не получал события колеса мыши от этого компонента.
`void`	`removeNotify()`	Делает этот `Component` непоказываемым, уничтожая его собственный экранный ресурс.
`void`	`removePropertyChangeListener(PropertyChangeListener listener)`	Удаляет PropertyChangeListener из списка прослушивателей.
`void`	`removePropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Удаляет `PropertyChangeListener` из списка прослушивателей для указанного свойства.
`void`	`repaint()`	Перерисовывает этот компонент.
`void`	`repaint(int x, int y, int width, int height)`	Перерисовывает указанный прямоугольник этого компонента.
`void`	`repaint(long tm)`	Перерисовывает компонент.
`void`	`repaint(long tm, int x, int y, int width, int height)`	Перерисовывает указанный прямоугольник этого компонента в течение `tm` миллисекунд.
`void`	`requestFocus()`	Запрашивает передачу этому компоненту фокуса ввода и фокуса окну, являющемуся его предком верхнего уровня.
`protected boolean`	`requestFocus(boolean temporary)`	Запрашивает передачу этому `Component` фокуса ввода и фокуса `Window`, являющемуся предком верхнего уровня этого `Component`.
`protected boolean`	`requestFocus(boolean temporary, FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу этому `Component` фокуса ввода и фокуса `Window`, являющемуся предком верхнего уровня этого `Component`.
`void`	`requestFocus(FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу этому компоненту фокуса ввода и фокуса окну, являющемуся его предком верхнего уровня.
`boolean`	`requestFocusInWindow()`	Запрашивает передачу этому компоненту фокуса ввода, если окно, являющееся его предком верхнего уровня, уже находится в фокусе.
`protected boolean`	`requestFocusInWindow(boolean temporary)`	Запрашивает передачу этому `Component` фокуса ввода, если `Window`, являющийся предком верхнего уровня этого `Component`, уже находится в фокусе.
`boolean`	`requestFocusInWindow(FocusEvent.Cause cause)`	Запрашивает по причине `cause` передачу этому компоненту фокуса ввода, если окно, являющееся его предком верхнего уровня, уже находится в фокусе.
`void`	`reshape(int x, int y, int width, int height)`	Устарело. Начиная с JDK версии 1.1 заменено на `setBounds(int, int, int, int)`.
`void`	`resize(int width, int height)`	Устарело. Начиная с JDK версии 1.1 заменено на `setSize(int, int)`.
`void`	`resize(Dimension d)`	Устарело. Начиная с JDK версии 1.1 заменено на `setSize(Dimension)`.
`void`	`revalidate()`	Повторно проверяет иерархию компонентов до ближайшего корня проверки.
`void`	`setBackground(Color c)`	Задает цвет фона этого компонента.
`void`	`setBounds(int x, int y, int width, int height)`	Перемещает и изменяет размер этого компонента.
`void`	`setBounds(Rectangle r)`	Перемещает и изменяет размер этого компонента в соответствии с новым ограничивающим прямоугольником `r`.
`void`	`setComponentOrientation(ComponentOrientation o)`	Задает зависящую от языка ориентацию, которая будет использоваться для упорядочивания элементов или текста в этом компоненте.
`void`	`setCursor(Cursor cursor)`	Задает изображение курсора, соответствующее указанному курсору.
`void`	`setDropTarget(DropTarget dt)`	Связывает `DropTarget` с этим компонентом.
`void`	`setEnabled(boolean b)`	Включает или отключает этот компонент в зависимости от значения параметра `b`.
`void`	`setFocusable(boolean focusable)`	Задает для компонента возможность получения фокуса указанное значение.
`void`	`setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)`	Задает клавиши обхода фокуса для указанной операции обхода этого компонента.
`void`	`setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)`	Задает, включены ли для этого компонента клавиши обхода фокуса.
`void`	`setFont(Font f)`	Задает шрифт этого компонента.
`void`	`setForeground(Color c)`	Задает цвет переднего плана этого компонента.
`void`	`setIgnoreRepaint(boolean ignoreRepaint)`	Задает, следует ли игнорировать сообщения о перерисовке, полученные от операционной системы.
`void`	`setLocale(Locale l)`	Задает локаль этого компонента.
`void`	`setLocation(int x, int y)`	Перемещает этот компонент в новое местоположение.
`void`	`setLocation(Point p)`	Перемещает этот компонент в новое местоположение.
`void`	`setMaximumSize(Dimension maximumSize)`	Задает максимальный размер этого компонента постоянным значением.
`void`	`setMinimumSize(Dimension minimumSize)`	Задает минимальный размер этого компонента постоянным значением.
`void`	`setMixingCutoutShape(Shape shape)`	Задает форму «выреза для смешивания» для этого облегченного компонента.
`void`	`setName(String name)`	Задает для компонента указанное имя.
`void`	`setPreferredSize(Dimension preferredSize)`	Задает предпочтительный размер этого компонента постоянным значением.
`void`	`setSize(int width, int height)`	Изменяет размер этого компонента так, чтобы его ширина составляла `width`, а высота — `height`.
`void`	`setSize(Dimension d)`	Изменяет размер этого компонента так, чтобы его ширина составляла `d.width`, а высота — `d.height`.
`void`	`setVisible(boolean b)`	Показывает или скрывает этот компонент в зависимости от значения параметра `b`.
`void`	`show()`	Устарело. Начиная с JDK версии 1.1 заменено на `setVisible(boolean)`.
`void`	`show(boolean b)`	Устарело. Начиная с JDK версии 1.1 заменено на `setVisible(boolean)`.
`Dimension`	`size()`	Устарело. Начиная с JDK версии 1.1 заменено на `getSize()`.
`String`	`toString()`	Возвращает строковое представление этого компонента и его значений.
`void`	`transferFocus()`	Передает фокус следующему компоненту, как если бы этот компонент был владельцем фокуса.
`void`	`transferFocusBackward()`	Передает фокус предыдущему компоненту, как если бы этот компонент был владельцем фокуса.
`void`	`transferFocusUpCycle()`	Передает фокус на один цикл обхода фокуса вверх.
`void`	`update(Graphics g)`	Обновляет этот компонент.
`void`	`validate()`	Проверяет этот компонент.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

Button

public Button() throws HeadlessException

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

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

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

См. также:

Button

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()

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

Возвращает:

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

Начиная с версии:

1.4

См. также:

getListeners

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

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

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

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

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

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

getListeners в классе Component

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

T — тип прослушивателей

Параметры:

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

Возвращает:

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

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

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)

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

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

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

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

Параметры:

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

Начиная с версии:

1.1

См. также:

paramString

protected String paramString()

Возвращает строку, представляющую состояние этого Button. Этот метод предназначен только для отладки; содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть 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.