Класс AbstractButton

javax.swing.AbstractButton

Все реализуемые интерфейсы:: ImageObserver, ItemSelectable, MenuContainer, Serializable, SwingConstants

Прямые известные подклассы:: JButton, JMenuItem, JToggleButton

@JavaBean(defaultProperty="UI") public abstract class AbstractButton extends JComponent implements ItemSelectable, SwingConstants

Определяет общее поведение для кнопок и пунктов меню.

Кнопки могут быть настроены и в некоторой степени управляться объектами Action. Использование Action с кнопкой имеет множество преимуществ помимо непосредственной настройки кнопки. Дополнительные сведения см. в разделе Swing Компоненты, поддерживающие Action, а также в Как использовать действия, разделе учебника The Java Tutorial.

Дополнительную информацию см. в разделе Как использовать кнопки, флажки и радиокнопки учебника The Java Tutorial.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или удаленного вызова методов (RMI) между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4, поддержка долгосрочного хранения всех JavaBeans добавлена в пакет java.beans. См. XMLEncoder.

С:: 1.2

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`protected class`	`AbstractButton.AccessibleAbstractButton`	Этот класс реализует поддержку доступности для класса `AbstractButton`.
`protected class`	`AbstractButton.ButtonChangeListener`	Расширяет `ChangeListener` для сериализации.

Вложенные классы/интерфейсы, объявленные в классе javax.swing.JComponent

JComponent.AccessibleJComponent

Вложенные классы/интерфейсы, объявленные в классе java.awt.Container

Container.AccessibleAWTContainer

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

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

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

Модификатор и тип	Поле	Описание
`protected ActionListener`	`actionListener`	`ActionListener` модели кнопки.
`static final String`	`BORDER_PAINTED_CHANGED_PROPERTY`	Указывает изменение отображения рамки.
`protected ChangeEvent`	`changeEvent`	Для каждой кнопки нужен только один `ChangeEvent`, так как состояние события определяется только свойством источника.
`protected ChangeListener`	`changeListener`	`changeListener` модели кнопки.
`static final String`	`CONTENT_AREA_FILLED_CHANGED_PROPERTY`	Указывает изменение отображения содержимого области кнопки.
`static final String`	`DISABLED_ICON_CHANGED_PROPERTY`	Указывает изменение значка при отключенной кнопке.
`static final String`	`DISABLED_SELECTED_ICON_CHANGED_PROPERTY`	Указывает изменение значка при отключенной и выбранной кнопке.
`static final String`	`FOCUS_PAINTED_CHANGED_PROPERTY`	Указывает изменение выделения рамки при фокусе.
`static final String`	`HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY`	Указывает изменение горизонтального выравнивания кнопки.
`static final String`	`HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY`	Указывает изменение горизонтального расположения текста кнопки.
`static final String`	`ICON_CHANGED_PROPERTY`	Указывает изменение значка кнопки.
`protected ItemListener`	`itemListener`	`ItemListener` модели кнопки.
`static final String`	`MARGIN_CHANGED_PROPERTY`	Указывает изменение отступов кнопки.
`static final String`	`MNEMONIC_CHANGED_PROPERTY`	Указывает изменение мнемоники кнопки.
`protected ButtonModel`	`model`	Модель данных, определяющая состояние кнопки.
`static final String`	`MODEL_CHANGED_PROPERTY`	Указывает изменение модели кнопки.
`static final String`	`PRESSED_ICON_CHANGED_PROPERTY`	Указывает изменение значка при нажатии кнопки.
`static final String`	`ROLLOVER_ENABLED_CHANGED_PROPERTY`	Указывает изменение состояния активации эффекта наведения курсора.
`static final String`	`ROLLOVER_ICON_CHANGED_PROPERTY`	Указывает изменение значка при наведении курсора.
`static final String`	`ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY`	Указывает изменение значка при наведении курсора и выбранной кнопке.
`static final String`	`SELECTED_ICON_CHANGED_PROPERTY`	Указывает изменение значка при выбранной кнопке.
`static final String`	`TEXT_CHANGED_PROPERTY`	Указывает изменение текста кнопки.
`static final String`	`VERTICAL_ALIGNMENT_CHANGED_PROPERTY`	Указывает изменение вертикального выравнивания кнопки.
`static final String`	`VERTICAL_TEXT_POSITION_CHANGED_PROPERTY`	Указывает изменение вертикального расположения текста кнопки.

Поля, объявленные в классе javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

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

Поля, объявленные в интерфейсе javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

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

AbstractButton()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова подклассами.

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

Modifier and Type	Method	Description
`protected void`	`actionPropertyChanged(Action action, String propertyName)`	Обновляет состояние кнопки в ответ на изменения свойств связанного действия.
`void`	`addActionListener(ActionListener l)`	Добавляет `ActionListener` к кнопке.
`void`	`addChangeListener(ChangeListener l)`	Добавляет `ChangeListener` к кнопке.
`protected void`	`addImpl(Component comp, Object constraints, int index)`	Добавляет указанный компонент в этот контейнер в указанный индекс, обратитесь к `Container.addImpl(Component, Object, int)` для полного описания этого метода.
`void`	`addItemListener(ItemListener l)`	Добавляет `ItemListener` к `checkbox`.
`protected int`	`checkHorizontalKey(int key, String exception)`	Проверяет, что аргумент `key` является допустимым значением для свойств `horizontalAlignment` и `horizontalTextPosition`.
`protected int`	`checkVerticalKey(int key, String exception)`	Проверяет, что аргумент `key` является допустимым значением для вертикальных свойств.
`protected void`	`configurePropertiesFromAction(Action a)`	Устанавливает свойства этой кнопки, чтобы соответствовать свойствам указанного `Action`.
`protected ActionListener`	`createActionListener()`	Возвращает `ActionListener`, который добавлен в модель.
`protected PropertyChangeListener`	`createActionPropertyChangeListener(Action a)`	Создаёт и возвращает `PropertyChangeListener`, который отвечает за прослушивание изменений от указанного `Action` и обновление соответствующих свойств.
`protected ChangeListener`	`createChangeListener()`	Подклассы, которые хотят обработать `ChangeEvents` по-другому, могут переопределить этот метод, чтобы вернуть другую реализацию `ChangeListener`.
`protected ItemListener`	`createItemListener()`	Возвращает `ItemListener`, который добавлен в модель.
`void`	`doClick()`	Программная имитация "щелчка" по кнопке.
`void`	`doClick(int pressTime)`	Программная имитация "щелчка" по кнопке.
`protected void`	`fireActionPerformed(ActionEvent event)`	Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события.
`protected void`	`fireItemStateChanged(ItemEvent event)`	Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события.
`protected void`	`fireStateChanged()`	Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события.
`Action`	`getAction()`	Возвращает текущее установленное `Action` для этого источника `ActionEvent` или `null`, если `Action` не установлено.
`String`	`getActionCommand()`	Возвращает команду действия для этой кнопки.
`ActionListener[]`	`getActionListeners()`	Возвращает массив всех `ActionListener`, добавленных к этому AbstractButton с помощью addActionListener().
`ChangeListener[]`	`getChangeListeners()`	Возвращает массив всех `ChangeListener`, добавленных к этому AbstractButton с помощью addChangeListener().
`Icon`	`getDisabledIcon()`	Возвращает значок, используемый кнопкой, когда она отключена.
`Icon`	`getDisabledSelectedIcon()`	Возвращает значок, используемый кнопкой, когда она отключена и выбрана.
`int`	`getDisplayedMnemonicIndex()`	Возвращает символ (как индекс), для которого виджет должен предоставить оформление, представляющий символ-мнемонику.
`boolean`	`getHideActionText()`	Возвращает значение свойства `hideActionText`, определяющего, отображает ли кнопка текст из `Action`.
`int`	`getHorizontalAlignment()`	Возвращает горизонтальное выравнивание значка и текста.
`int`	`getHorizontalTextPosition()`	Возвращает горизонтальное положение текста относительно значка.
`Icon`	`getIcon()`	Возвращает значок по умолчанию.
`int`	`getIconTextGap()`	Возвращает количество пробелов между текстом и значком, отображаемыми на этой кнопке.
`ItemListener[]`	`getItemListeners()`	Возвращает массив всех `ItemListener`, добавленных к этому AbstractButton с помощью addItemListener().
`String`	`getLabel()`	Устарело. - Заменено на `getText`
`Insets`	`getMargin()`	Возвращает отступ между границей кнопки и меткой.
`int`	`getMnemonic()`	Возвращает мнемонику клавиатуры из текущей модели.
`ButtonModel`	`getModel()`	Возвращает модель, которую представляет эта кнопка.
`long`	`getMultiClickThreshhold()`	Возвращает время (в миллисекундах), необходимое между нажатиями мыши, чтобы кнопка сгенерировала соответствующие события действия.
`Icon`	`getPressedIcon()`	Возвращает нажатый значок для кнопки.
`Icon`	`getRolloverIcon()`	Возвращает значок для наведения курсора на кнопку.
`Icon`	`getRolloverSelectedIcon()`	Возвращает значок для выделения при наведении курсора на кнопку.
`Icon`	`getSelectedIcon()`	Возвращает выбранный значок для кнопки.
`Object[]`	`getSelectedObjects()`	Возвращает массив (длиной 1) содержащий метку или `null`, если кнопка не выбрана.
`String`	`getText()`	Возвращает текст кнопки.
`ButtonUI`	`getUI()`	Возвращает объект L&F, который отображает этот компонент.
`int`	`getVerticalAlignment()`	Возвращает вертикальное выравнивание текста и значка.
`int`	`getVerticalTextPosition()`	Возвращает вертикальное положение текста относительно значка.
`boolean`	`imageUpdate(Image img, int infoflags, int x, int y, int w, int h)`	Если значок кнопки для текущего состояния кнопки равен либо `null`, либо не является `ImageIcon` со свойством `Image`, равным переданному в аргументе `Image`, возвращается `false`; в противном случае делегируется суперклассу.
`protected void`	`init(String text, Icon icon)`	Инициализация `AbstractButton`.
`boolean`	`isBorderPainted()`	Возвращает свойство `borderPainted`.
`boolean`	`isContentAreaFilled()`	Возвращает свойство `contentAreaFilled`.
`boolean`	`isFocusPainted()`	Возвращает свойство `paintFocus`.
`boolean`	`isRolloverEnabled()`	Возвращает свойство `rolloverEnabled`.
`boolean`	`isSelected()`	Возвращает состояние кнопки.
`protected void`	`paintBorder(Graphics g)`	Отображает границу кнопки, если свойство `BorderPainted` имеет значение true, и кнопка имеет границу.
`protected String`	`paramString()`	Возвращает строковое представление этого `AbstractButton`.
`void`	`removeActionListener(ActionListener l)`	Удаляет `ActionListener` из кнопки.
`void`	`removeChangeListener(ChangeListener l)`	Удаляет ChangeListener из кнопки.
`void`	`removeItemListener(ItemListener l)`	Удаляет `ItemListener` из кнопки.
`void`	`removeNotify()`	Уведомляет этот компонент о том, что у него больше нет родительского компонента.
`void`	`setAction(Action a)`	Устанавливает `Action`.

`void`	`setActionCommand(String actionCommand)`	Устанавливает команду действия для этой кнопки.
`void`	`setBorderPainted(boolean b)`	Устанавливает свойство `borderPainted`.
`void`	`setContentAreaFilled(boolean b)`	Устанавливает свойство `contentAreaFilled`.
`void`	`setDisabledIcon(Icon disabledIcon)`	Устанавливает иконку для состояния отключения кнопки.
`void`	`setDisabledSelectedIcon(Icon disabledSelectedIcon)`	Устанавливает иконку выделенного состояния отключения кнопки.
`void`	`setDisplayedMnemonicIndex(int index)`	Предоставляет подсказку для визуального представления, какой символ в тексте следует использовать для обозначения мнемоники.
`void`	`setEnabled(boolean b)`	Включает (или отключает) кнопку.
`void`	`setFocusPainted(boolean b)`	Устанавливает свойство `paintFocus`, которое должно быть `true` для отрисовки состояния фокуса.
`void`	`setHideActionText(boolean hideActionText)`	Устанавливает свойство `hideActionText`, которое определяет, отображает ли кнопка текст из `Action`.
`void`	`setHorizontalAlignment(int alignment)`	Устанавливает горизонтальное выравнивание иконки и текста.
`void`	`setHorizontalTextPosition(int textPosition)`	Устанавливает горизонтальное положение текста относительно иконки.
`void`	`setIcon(Icon defaultIcon)`	Устанавливает значок по умолчанию для кнопки.
`void`	`setIconTextGap(int iconTextGap)`	Если установлены свойства иконки и текста, это свойство определяет расстояние между ними.
`void`	`setLabel(String label)`	Устарело. - Заменено на `setText(text)`
`void`	`setLayout(LayoutManager mgr)`	Устанавливает менеджер компоновки для этого контейнера, см. `Container.setLayout(LayoutManager)` для полного описания этого метода.
`void`	`setMargin(Insets m)`	Устанавливает отступ между границей кнопки и меткой.
`void`	`setMnemonic(char mnemonic)`	Этот метод устарел, пожалуйста, используйте `setMnemonic(int)` для установки мнемоники кнопки.
`void`	`setMnemonic(int mnemonic)`	Устанавливает мнемонику клавиатуры в текущей модели.
`void`	`setModel(ButtonModel newModel)`	Устанавливает модель, которую представляет эта кнопка.
`void`	`setMultiClickThreshhold(long threshold)`	Устанавливает время (в миллисекундах), необходимое между нажатиями мыши для кнопки, чтобы сгенерировать соответствующие события действий.
`void`	`setPressedIcon(Icon pressedIcon)`	Устанавливает нажатую иконку для кнопки.
`void`	`setRolloverEnabled(boolean b)`	Устанавливает свойство `rolloverEnabled`, которое должно быть `true` для отображения эффектов наведения.
`void`	`setRolloverIcon(Icon rolloverIcon)`	Устанавливает иконку наведения для кнопки.
`void`	`setRolloverSelectedIcon(Icon rolloverSelectedIcon)`	Устанавливает иконку наведения для выделенной кнопки.
`void`	`setSelected(boolean b)`	Устанавливает состояние кнопки.
`void`	`setSelectedIcon(Icon selectedIcon)`	Устанавливает выбранную иконку для кнопки.
`void`	`setText(String text)`	Устанавливает текст кнопки.
`void`	`setUI(ButtonUI ui)`	Устанавливает объект L&F, который отображает этот компонент.
`void`	`setVerticalAlignment(int alignment)`	Устанавливает вертикальное выравнивание иконки и текста.
`void`	`setVerticalTextPosition(int textPosition)`	Устанавливает вертикальное положение текста относительно иконки.
`void`	`updateUI()`	Сбрасывает свойство пользовательского интерфейса до значения из текущей темы оформления.

Methods declared in class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods declared in class java.awt.Container

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusDownCycle, validate, validateTree

Methods declared in class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods declared in class java.lang.Object

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

Подробное описание полей

MODEL_CHANGED_PROPERTY

public static final String MODEL_CHANGED_PROPERTY

Идентифицирует изменение модели кнопки.

См. также:

TEXT_CHANGED_PROPERTY

public static final String TEXT_CHANGED_PROPERTY

Идентифицирует изменение текста кнопки.

См. также:

MNEMONIC_CHANGED_PROPERTY

public static final String MNEMONIC_CHANGED_PROPERTY

Идентифицирует изменение мнемоники кнопки.

См. также:

MARGIN_CHANGED_PROPERTY

public static final String MARGIN_CHANGED_PROPERTY

Идентифицирует изменение отступов кнопки.

См. также:

VERTICAL_ALIGNMENT_CHANGED_PROPERTY

public static final String VERTICAL_ALIGNMENT_CHANGED_PROPERTY

Идентифицирует изменение вертикального выравнивания кнопки.

См. также:

HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY

public static final String HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY

Идентифицирует изменение горизонтального выравнивания кнопки.

См. также:

VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

public static final String VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

Идентифицирует изменение вертикального расположения текста кнопки.

См. также:

HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY

public static final String HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY

Идентифицирует изменение горизонтального расположения текста кнопки.

См. также:

BORDER_PAINTED_CHANGED_PROPERTY

public static final String BORDER_PAINTED_CHANGED_PROPERTY

Идентифицирует изменение отображения рамки (отображается или нет).

См. также:

FOCUS_PAINTED_CHANGED_PROPERTY

public static final String FOCUS_PAINTED_CHANGED_PROPERTY

Идентифицирует изменение отображения рамки при фокусе (отображается или нет).

См. также:

ROLLOVER_ENABLED_CHANGED_PROPERTY

public static final String ROLLOVER_ENABLED_CHANGED_PROPERTY

Идентифицирует изменение состояния "rollover" (активации при наведении курсора) на "отключено" или обратно на "включено".

См. также:

CONTENT_AREA_FILLED_CHANGED_PROPERTY

public static final String CONTENT_AREA_FILLED_CHANGED_PROPERTY

Идентифицирует изменение состояния отображения области содержимого кнопки.

См. также:

ICON_CHANGED_PROPERTY

public static final String ICON_CHANGED_PROPERTY

Идентифицирует изменение значка кнопки.

См. также:

PRESSED_ICON_CHANGED_PROPERTY

public static final String PRESSED_ICON_CHANGED_PROPERTY

Идентифицирует изменение значка при нажатии на кнопку.

См. также:

SELECTED_ICON_CHANGED_PROPERTY

public static final String SELECTED_ICON_CHANGED_PROPERTY

Идентифицирует изменение значка при выделении кнопки.

См. также:

ROLLOVER_ICON_CHANGED_PROPERTY

public static final String ROLLOVER_ICON_CHANGED_PROPERTY

Идентифицирует изменение значка при наведении курсора на кнопку.

См. также:

ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY

public static final String ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY

Идентифицирует изменение значка при наведении курсора на выбранную кнопку.

См. также:

DISABLED_ICON_CHANGED_PROPERTY

public static final String DISABLED_ICON_CHANGED_PROPERTY

Идентифицирует изменение значка при отключении кнопки.

См. также:

DISABLED_SELECTED_ICON_CHANGED_PROPERTY

public static final String DISABLED_SELECTED_ICON_CHANGED_PROPERTY

Идентифицирует изменение значка при отключении и выделении кнопки.

См. также:

model

protected ButtonModel model

Модель данных, определяющая состояние кнопки.

changeListener

protected ChangeListener changeListener

changeListener модели кнопки.

actionListener

protected ActionListener actionListener

ActionListener модели кнопки.

itemListener

protected ItemListener itemListener

ItemListener модели кнопки.

changeEvent

protected transient ChangeEvent changeEvent

Для каждого экземпляра кнопки нужен только один ChangeEvent, так как состояние события зависит только от свойства источника. Источником сгенерированных событий всегда является "this".

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

AbstractButton

protected AbstractButton()

Конструктор для вызова подклассами.

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

setHideActionText

@BeanProperty(expert=true, description="Whether the text of the button should come from the <code>Action</code>.") public void setHideActionText(boolean hideActionText)

Устанавливает свойство hideActionText, определяющее, отображает ли кнопка текст из Action. Это полезно только в том случае, если на кнопку был установлен Action.

Параметры:

hideActionText - true, если свойство text кнопки не должно отражать свойство Action; по умолчанию false

С момента:

1.6

См. также:

getHideActionText

public boolean getHideActionText()

Возвращает значение свойства hideActionText, которое определяет, отображает ли кнопка текст из Action. Это полезно только если на кнопке установлен Action.

Returns:: true, если свойство кнопки text не должно отражать свойство Action; по умолчанию false
Since:: 1.6

getText

public String getText()

Возвращает текст кнопки.

Returns:

текст кнопки

См. также:

setText

@BeanProperty(preferred=true, visualUpdate=true, description="The button\'s text.") public void setText(String text)

Устанавливает текст кнопки.

Parameters:

text - строка, используемая для установки текста

См. также:

isSelected

public boolean isSelected()

Возвращает состояние кнопки. True, если кнопка переключатель выбрана, false — если нет.

Returns:: true, если кнопка переключатель выбрана, иначе false

setSelected

public void setSelected(boolean b)

Устанавливает состояние кнопки. Обратите внимание, что этот метод не вызывает actionEvent. Вызовите doClick, чтобы выполнить программное изменение состояния.

Parameters:: b - true, если кнопка выбрана, иначе false

doClick

public void doClick()

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

doClick

public void doClick(int pressTime)

Выполняет программный "щелчок". Это делает то же, что и при нажатии и отпускании пользователем кнопки. Кнопка визуально остается "нажатой" в течение pressTime миллисекунд.

Parameters:: pressTime - время удержания кнопки в миллисекундах

setMargin

@BeanProperty(visualUpdate=true, description="The space between the button\'s border and the label.") public void setMargin(Insets m)

Устанавливает отступ между границей кнопки и меткой. Установка значения null приведет к использованию кнопкой стандартного отступа. Стандартный объект Border кнопки будет использовать это значение для создания правильного отступа. Однако, если для кнопки задан нестандартный отступ, за создание соответствующего отступа отвечает объект Border (в противном случае это свойство будет фактически проигнорировано).

Parameters:: m - отступ между границей и меткой

getMargin

public Insets getMargin()

Возвращает отступ между границей кнопки и меткой.

Returns:

объект Insets, определяющий отступ между границей кнопки и меткой

См. также:

getIcon

public Icon getIcon()

Возвращает стандартный значок.

Returns:

стандартный Icon

См. также:

setIcon

@BeanProperty(visualUpdate=true, description="The button\'s default icon") public void setIcon(Icon defaultIcon)

Устанавливает стандартный значок кнопки. Этот значок также используется в качестве значка "нажатия" и "отключен", если явно не задан значок нажатия.

Parameters:

defaultIcon - значок, используемый в качестве стандартного изображения

См. также:

getPressedIcon

public Icon getPressedIcon()

Возвращает значок для нажатой кнопки.

Returns:

свойство pressedIcon

См. также:

setPressedIcon

@BeanProperty(visualUpdate=true, description="The pressed icon for the button.") public void setPressedIcon(Icon pressedIcon)

Устанавливает значок для нажатой кнопки.

Parameters:

pressedIcon - значок, используемый в качестве изображения "нажатия"

См. также:

getSelectedIcon

public Icon getSelectedIcon()

Возвращает значок для выделенной кнопки.

Returns:

свойство selectedIcon

См. также:

setSelectedIcon

@BeanProperty(visualUpdate=true, description="The selected icon for the button.") public void setSelectedIcon(Icon selectedIcon)

Устанавливает значок для выделенной кнопки.

Parameters:

selectedIcon - значок, используемый в качестве изображения "выделения"

См. также:

getRolloverIcon

public Icon getRolloverIcon()

Возвращает значок при наведении курсора на кнопку.

Returns:

свойство rolloverIcon

См. также:

setRolloverIcon

@BeanProperty(visualUpdate=true, description="The rollover icon for the button.") public void setRolloverIcon(Icon rolloverIcon)

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

Parameters:

rolloverIcon - значок, используемый в качестве изображения "при наведении"

См. также:

getRolloverSelectedIcon

public Icon getRolloverSelectedIcon()

Возвращает значок при наведении курсора на выделенную кнопку.

Returns:

свойство rolloverSelectedIcon

См. также:

setRolloverSelectedIcon

@BeanProperty(visualUpdate=true, description="The rollover selected icon for the button.") public void setRolloverSelectedIcon(Icon rolloverSelectedIcon)

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

Parameters:

rolloverSelectedIcon - значок, используемый в качестве изображения "выделенного при наведении"

См. также:

getDisabledIcon

public Icon getDisabledIcon()

Возвращает значок, используемый кнопкой при ее отключении. Если значок для отключения не задан, это приведет к вызову метода look and feel для создания соответствующего значка.

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

Returns:

свойство disabledIcon

См. также:

setDisabledIcon

@BeanProperty(visualUpdate=true, description="The disabled icon for the button.") public void setDisabledIcon(Icon disabledIcon)

Устанавливает значок для отключения кнопки.

Parameters:

disabledIcon - значок, используемый в качестве изображения "отключено"

См. также:

getDisabledSelectedIcon

public Icon getDisabledSelectedIcon()

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

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

Returns:

свойство disabledSelectedIcon

См. также:

setDisabledSelectedIcon

@BeanProperty(visualUpdate=true, description="The disabled selection icon for the button.") public void setDisabledSelectedIcon(Icon disabledSelectedIcon)

Устанавливает значок для выделенной отключенной кнопки.

Parameters:

disabledSelectedIcon - значок, используемый в качестве изображения "выделено и отключено"

См. также:

getVerticalAlignment

public int getVerticalAlignment()

Возвращает вертикальное выравнивание текста и значка.

Returns:

свойство verticalAlignment, одно из следующих значений:

SwingConstants.CENTER (по умолчанию)
SwingConstants.TOP
SwingConstants.BOTTOM

setVerticalAlignment

@BeanProperty(visualUpdate=true, enumerationValues={"SwingConstants.TOP","SwingConstants.CENTER","SwingConstants.BOTTOM"}, description="The vertical alignment of the icon and text.") public void setVerticalAlignment(int alignment)

Устанавливает вертикальное выравнивание значка и текста.

Parameters:

alignment - одно из следующих значений:

SwingConstants.CENTER (по умолчанию)
SwingConstants.TOP
SwingConstants.BOTTOM

Throws:

IllegalArgumentException - если выравнивание не соответствует одному из допустимых значений, перечисленных выше

getHorizontalAlignment

public int getHorizontalAlignment()

Возвращает горизонтальное выравнивание значка и текста. По умолчанию для AbstractButton установлено значение SwingConstants.CENTER, но подклассы, такие как JCheckBox, могут использовать другое значение по умолчанию.

Returns:

свойство horizontalAlignment, одно из следующих значений:

SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING

setHorizontalAlignment

@BeanProperty(visualUpdate=true, enumerationValues={"SwingConstants.LEFT","SwingConstants.CENTER","SwingConstants.RIGHT","SwingConstants.LEADING","SwingConstants.TRAILING"}, description="The horizontal alignment of the icon and text.") public void setHorizontalAlignment(int alignment)

Устанавливает горизонтальное выравнивание значка и текста. По умолчанию для AbstractButton установлено значение SwingConstants.CENTER, но подклассы, такие как JCheckBox, могут использовать другое значение по умолчанию.

Parameters:

alignment - значение выравнивания, одно из следующих значений:

SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING

Throws:

IllegalArgumentException - если выравнивание не является одним из допустимых значений

getVerticalTextPosition

public int getVerticalTextPosition()

Возвращает вертикальное положение текста относительно значка.

Returns:

свойство verticalTextPosition, одно из следующих значений:

SwingConstants.CENTER (по умолчанию)
SwingConstants.TOP
SwingConstants.BOTTOM

setVerticalTextPosition

@BeanProperty(visualUpdate=true, enumerationValues={"SwingConstants.TOP","SwingConstants.CENTER","SwingConstants.BOTTOM"}, description="The vertical position of the text relative to the icon.") public void setVerticalTextPosition(int textPosition)

Устанавливает вертикальное положение текста относительно значка.

Parameters:

textPosition - одно из следующих значений:

SwingConstants.CENTER (по умолчанию)
SwingConstants.TOP
SwingConstants.BOTTOM

getHorizontalTextPosition

public int getHorizontalTextPosition()

Возвращает горизонтальное положение текста относительно значка.

Returns:

свойство horizontalTextPosition, одно из следующих значений:

SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING (по умолчанию)

setHorizontalTextPosition

@BeanProperty(visualUpdate=true, enumerationValues={"SwingConstants.LEFT","SwingConstants.CENTER","SwingConstants.RIGHT","SwingConstants.LEADING","SwingConstants.TRAILING"}, description="The horizontal position of the text relative to the icon.") public void setHorizontalTextPosition(int textPosition)

Устанавливает горизонтальное положение текста относительно значка.

Parameters:

textPosition - одно из следующих значений:

SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING (по умолчанию)

Throws:

IllegalArgumentException - если textPosition не соответствует одному из допустимых значений, перечисленных выше

getIconTextGap

public int getIconTextGap()

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

Returns:

целое число, равное количеству пикселей между текстом и значком.

Since:

1.4

See Also:

setIconTextGap

@BeanProperty(visualUpdate=true, description="If both the icon and text properties are set, this property defines the space between them.") public void setIconTextGap(int iconTextGap)

Если установлены свойства как значка, так и текста, данное свойство определяет расстояние между ними.

Значение по умолчанию равно 4 пикселям.

Это свойство JavaBeans.

Parameters:

iconTextGap - расстояние между значком и текстом, если эти свойства установлены.

Since:

1.4

See Also:

checkHorizontalKey

protected int checkHorizontalKey(int key, String exception)

Проверяет, является ли аргумент key допустимым значением для свойств horizontalAlignment и horizontalTextPosition. Допустимые значения:

SwingConstants.RIGHT
SwingConstants.LEFT
SwingConstants.CENTER
SwingConstants.LEADING
SwingConstants.TRAILING

Parameters:

key - проверяемое значение свойства

exception - сообщение, используемое в IllegalArgumentException при недопустимом значении

Returns:

аргумент key

Throws:

IllegalArgumentException - если ключ не соответствует одному из допустимых значений, перечисленных выше

See Also:

checkVerticalKey

protected int checkVerticalKey(int key, String exception)

Проверяет, является ли аргумент key допустимым значением для вертикальных свойств. Допустимые значения:

SwingConstants.CENTER
SwingConstants.TOP
SwingConstants.BOTTOM

Parameters:: key - проверяемое значение свойства; exception - сообщение, используемое в IllegalArgumentException при недопустимом значении
Returns:: аргумент key
Throws:: IllegalArgumentException - если ключ не соответствует одному из допустимых значений, перечисленных выше

removeNotify

public void removeNotify()

Уведомляет компонент о том, что у него больше нет родительского компонента. При вызове этого метода все KeyboardAction, настроенные в цепочке родительских компонентов, удаляются. Этот метод вызывается внутренне инструментарием и не должен вызываться программами напрямую.

Overrides:

removeNotify в классе JComponent

Since:

1.6

See Also:

setActionCommand

public void setActionCommand(String actionCommand)

Устанавливает команду действия для этой кнопки.

Parameters:: actionCommand - команда действия для этой кнопки

getActionCommand

public String getActionCommand()

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

Returns:: команда действия для этой кнопки

setAction

@BeanProperty(visualUpdate=true, description="the Action instance connected with this ActionEvent source") public void setAction(Action a)

Устанавливает Action. Новый Action заменяет любой ранее установленный Action, но не влияет на ActionListeners, независимо добавленные с помощью addActionListener. Если Action уже зарегистрирован как ActionListener для кнопки, он не регистрируется повторно.

Установка Action приводит к немедленному изменению всех свойств, описанных в Поддержка Action в компонентах Swing. Впоследствии свойства кнопки автоматически обновляются по мере изменения свойств Action.

Этот метод использует три других метода для установки и отслеживания значений свойств Action. Он использует метод configurePropertiesFromAction для немедленного изменения свойств кнопки. Для отслеживания изменений значений свойств Action этот метод регистрирует PropertyChangeListener, возвращенное методом createActionPropertyChangeListener. По умолчанию PropertyChangeListener вызывает метод actionPropertyChanged при изменении свойства в Action.

Parameters:

a - Action для AbstractButton или null

Since:

1.3

See Also:

getAction

public Action getAction()

Возвращает текущий установленный Action для этого источника ActionEvent, или null, если Action не установлен.

Returns:

Action для этого источника ActionEvent или null

Since:

1.3

See Also:

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)

Устанавливает свойства этой кнопки, чтобы они соответствовали свойствам в указанном Action. Дополнительная информация о том, какие свойства устанавливаются, приведена в разделе Компоненты Swing, поддерживающие Action.

Parameters:

a - the Action, от которого следует получить свойства, или null

Since:

1.3

See Also:

actionPropertyChanged

protected void actionPropertyChanged(Action action, String propertyName)

Обновляет состояние кнопки в ответ на изменения свойств связанного действия. Этот метод вызывается из PropertyChangeListener, возвращаемого методом createActionPropertyChangeListener. Подклассам обычно не нужно вызывать его. Подклассы, которые поддерживают дополнительные Action свойства, должны переопределять его и метод configurePropertiesFromAction.

Список свойств, которые устанавливаются этим методом, приведен в таблице в разделе Компоненты Swing, поддерживающие Action.

Parameters:

action - the Action, связанный с этой кнопкой

propertyName - имя свойства, которое изменилось

Since:

1.6

See Also:

createActionPropertyChangeListener

protected PropertyChangeListener createActionPropertyChangeListener(Action a)

Создаёт и возвращает PropertyChangeListener, который отвечает за прослушивание изменений от указанного Action и обновление соответствующих свойств.

Предупреждение: Если вы наследуете этот класс, не создавайте анонимный внутренний класс. В противном случае срок существования кнопки будет привязан к сроку существования Action.

Parameters:

a - действие кнопки

Returns:

the PropertyChangeListener

Since:

1.3

See Also:

isBorderPainted

public boolean isBorderPainted()

Возвращает свойство borderPainted.

Returns:

значение свойства borderPainted

See Also:

setBorderPainted

@BeanProperty(visualUpdate=true, description="Whether the border should be painted.") public void setBorderPainted(boolean b)

Устанавливает свойство borderPainted. Если true и у кнопки есть граница, то граница отображается. Значение по умолчанию для свойства borderPainted равно true.

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

Parameters:

b - если true и свойство border не null, граница отображается

See Also:

paintBorder

protected void paintBorder(Graphics g)

Отображает границу кнопки, если свойство BorderPainted равно true и у кнопки есть граница.

Overrides:

paintBorder в классе JComponent

Parameters:

g - контекст Graphics для рисования

See Also:

isFocusPainted

public boolean isFocusPainted()

Возвращает свойство paintFocus.

Returns:

свойство paintFocus

See Also:

setFocusPainted

@BeanProperty(visualUpdate=true, description="Whether focus should be painted") public void setFocusPainted(boolean b)

Устанавливает свойство paintFocus, которое должно быть true для отображения состояния фокуса. Значение свойства paintFocus по умолчанию равно true. Некоторые стили отображения могут не отображать состояние фокуса; в этом случае они проигнорируют это свойство.

Parameters:

b - если true, состояние фокуса должно быть отображено

See Also:

isContentAreaFilled

public boolean isContentAreaFilled()

Возвращает свойство contentAreaFilled.

Returns:

свойство contentAreaFilled

See Also:

setContentAreaFilled

@BeanProperty(visualUpdate=true, description="Whether the button should paint the content area or leave it transparent.") public void setContentAreaFilled(boolean b)

Устанавливает свойство contentAreaFilled. Если true, кнопка будет отображать область содержимого. Если вы хотите получить прозрачную кнопку, например, кнопку только с иконкой, установите это свойство в false. Не вызывайте setOpaque(false). Значение свойства contentAreaFilled по умолчанию равно true.

Эта функция может изменить свойство opaque компонента.

Точное поведение вызова этой функции зависит от конкретного компонента и L&F.

Parameters:

b - если true, содержимое должно быть заполнено; если false, область содержимого не заполнена

See Also:

isRolloverEnabled

public boolean isRolloverEnabled()

Возвращает свойство rolloverEnabled.

Returns:

значение свойства rolloverEnabled

See Also:

setRolloverEnabled

@BeanProperty(visualUpdate=true, description="Whether rollover effects should be enabled.") public void setRolloverEnabled(boolean b)

Устанавливает свойство rolloverEnabled, которое должно быть true для того, чтобы эффекты наведения курсора сработали. Значение свойства rolloverEnabled по умолчанию равно false. Некоторые стили отображения могут не реализовывать эффекты наведения курсора; в этом случае они проигнорируют это свойство.

Parameters:

b - если true, эффекты наведения курсора должны быть отображены

See Also:

getMnemonic

public int getMnemonic()

Возвращает горячую клавишу из текущей модели.

Returns:: горячую клавишу из модели

setMnemonic

@BeanProperty(visualUpdate=true, description="the keyboard character mnemonic") public void setMnemonic(int mnemonic)

Устанавливает горячую клавишу в текущей модели. Горячая клавиша — это ключ, который при нажатии вместе с модификатором мыши (обычно Alt) активирует эту кнопку, если фокус находится в окне предка этой кнопки.

Горячая клавиша должна соответствовать одному ключу на клавиатуре и должна быть задана с использованием одного из VK_XXX кодов клавиш, определенных в java.awt.event.KeyEvent. Эти коды и более широкий набор кодов для международных клавиатур можно получить с помощью java.awt.event.KeyEvent.getExtendedKeyCodeForChar. Горячие клавиши регистронезависимы; поэтому нажатие клавиши с соответствующим кодом активирует кнопку независимо от того, была ли нажата клавиша Shift.

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

Parameters:

mnemonic - код клавиши, представляющий горячую клавишу

See Also:

setMnemonic

@BeanProperty(visualUpdate=true, description="the keyboard character mnemonic") public void setMnemonic(char mnemonic)

Этот метод устарел. Используйте setMnemonic(int) для установки горячей клавиши кнопки. Этот метод предназначен только для обработки символьных значений, которые находятся между 'a' и 'z' или 'A' и 'Z'.

Parameters:

mnemonic - символ, определяющий значение горячей клавиши

See Also:

setDisplayedMnemonicIndex

@BeanProperty(visualUpdate=true, description="the index into the String to draw the keyboard character mnemonic at") public void setDisplayedMnemonicIndex(int index) throws IllegalArgumentException

Предоставляет подсказку для внешнего вида о том, какой символ в тексте должен быть декорирован для представления мнемоники. Не все внешние виды могут поддерживать это. Значение -1 указывает на то, что мнемоники нет, символ мнемоники не содержится в строке или разработчик не хочет, чтобы мнемоника отображалась.

Значение этого параметра обновляется по мере изменения свойств, связанных с мнемоникой (например, сама мнемоника, текст...). Вам нужно вызывать этот метод только в том случае, если вы не хотите, чтобы по умолчанию символ был подчеркнут. Например, если текст был «Save As» с мнемоникой «a», и вы хотите, чтобы «A» был декорирован, как «Save As», вам нужно будет вызвать setDisplayedMnemonicIndex(5) после вызова setMnemonic(KeyEvent.VK_A).

Параметры:

index - Индекс в строке для подчеркивания

Исключения:

IllegalArgumentException - будет выброшено, если index >= длины текста или < -1

С версии:

1.4

См. также:

getDisplayedMnemonicIndex

public int getDisplayedMnemonicIndex()

Возвращает символ, как индекс, для которого внешний вид должен обеспечить декорирование в качестве представления символа мнемоники.

Возвращает:

индекс, представляющий символ мнемоники

С версии:

1.4

См. также:

setMultiClickThreshhold

public void setMultiClickThreshhold(long threshold)

Задает количество времени (в миллисекундах), необходимое между событиями нажатия мыши, чтобы кнопка генерировала соответствующие события действия. После того, как произойдет первое нажатие мыши (и сгенерируется событие действия), любые последующие события нажатия мыши, которые происходят с интервалами меньше порогового значения, будут игнорироваться, и соответствующее событие действия не будет генерироваться. По умолчанию пороговое значение равно 0, что означает, что для каждого нажатия мыши будет срабатывать событие действия, независимо от того, как быстро происходят щелчки мышью. В кнопках, где это поведение нежелательно (например, кнопка «OK» в диалоговом окне), это пороговое значение следует установить на соответствующее положительное значение.

Параметры:

threshold - количество времени, необходимое между событиями нажатия мыши для генерации соответствующих событий действия

Исключения:

IllegalArgumentException - если пороговое значение < 0

С версии:

1.4

См. также:

getMultiClickThreshhold

public long getMultiClickThreshhold()

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

Возвращает:

количество времени, необходимое между событиями нажатия мыши для генерации соответствующих событий действия

С версии:

1.4

См. также:

getModel

public ButtonModel getModel()

Возвращает модель, которую представляет эта кнопка.

Возвращает:

свойство model

См. также:

setModel

@BeanProperty(description="Model that the Button uses.") public void setModel(ButtonModel newModel)

Задает модель, которую представляет эта кнопка.

Параметры:

newModel - новая ButtonModel

См. также:

getUI

public ButtonUI getUI()

Возвращает объект L&F, который отрисовывает этот компонент.

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

getUI в классе JComponent

Возвращает:

объект ButtonUI

См. также:

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the LookAndFeel.") public void setUI(ButtonUI ui)

Задает объект L&F, который отрисовывает этот компонент.

Параметры:

ui - объект ButtonUI L&F

См. также:

updateUI

public void updateUI()

Сбрасывает свойство UI до значения из текущего внешнего вида. Подтипы AbstractButton должны переопределить это для обновления UI. Например, JButton может сделать следующее:

      setUI((ButtonUI)UIManager.getUI(
          "ButtonUI", "javax.swing.plaf.basic.BasicButtonUI", this));

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

updateUI в классе JComponent

См. также:

addImpl

protected void addImpl(Component comp, Object constraints, int index)

Добавляет указанный компонент в этот контейнер с указанным индексом, см. Container.addImpl(Component, Object, int) для полного описания этого метода.

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

addImpl в классе Container

Параметры:

comp - компонент, который нужно добавить

constraints - объект, выражающий ограничения компоновки для этого компонента

index - позиция в списке контейнера, в которую нужно вставить компонент, где -1 означает добавить в конец

Исключения:

IllegalArgumentException - если index недействителен

IllegalArgumentException - при добавлении родительского контейнера к самому себе

IllegalArgumentException - при добавлении окна в контейнер

С версии:

1.5

См. также:

setLayout

public void setLayout(LayoutManager mgr)

Задает менеджер компоновки для этого контейнера, см. Container.setLayout(LayoutManager) для полного описания этого метода.

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

setLayout в классе Container

Параметры:

mgr - указанный менеджер компоновки

С версии:

1.5

См. также:

addChangeListener

public void addChangeListener(ChangeListener l)

Добавляет ChangeListener к кнопке.

Параметры:: l - слушатель, который нужно добавить

removeChangeListener

public void removeChangeListener(ChangeListener l)

Удаляет ChangeListener из кнопки.

Параметры:: l - слушатель, который нужно удалить

getChangeListeners

@BeanProperty(bound=false) public ChangeListener[] getChangeListeners()

Возвращает массив всех ChangeListener, добавленных в этот AbstractButton с помощью addChangeListener().

Возвращает:: все добавленные ChangeListener или пустой массив, если слушатели не были добавлены
С версии:: 1.4

fireStateChanged

protected void fireStateChanged()

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

См. также:

addActionListener

public void addActionListener(ActionListener l)

Добавляет ActionListener к кнопке.

Параметры:: l - ActionListener, который нужно добавить

removeActionListener

public void removeActionListener(ActionListener l)

Удаляет ActionListener из кнопки. Если слушатель является текущим установленным Action для кнопки, то Action устанавливается в null.

Параметры:: l - слушатель, который нужно удалить

getActionListeners

@BeanProperty(bound=false) public ActionListener[] getActionListeners()

Возвращает массив всех ActionListener, добавленных в этот AbstractButton с помощью addActionListener().

Возвращает:: все добавленные ActionListener или пустой массив, если слушатели не были добавлены
С версии:: 1.4

createChangeListener

protected ChangeListener createChangeListener()

Подклассы, которые хотят обработать ChangeEvents по-другому, могут переопределить этот метод, чтобы вернуть другую реализацию ChangeListener.

Returns:: новая ChangeListener

fireActionPerformed

protected void fireActionPerformed(ActionEvent event)

Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлениям об этом типе события. Экземпляр события создается лениво с использованием параметра event.

Parameters:

event — объект ActionEvent

See Also:

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent event)

Parameters:

event — объект ItemEvent

See Also:

createActionListener

protected ActionListener createActionListener()

Возвращает ActionListener, который добавляется к модели.

Returns:: ActionListener

createItemListener

protected ItemListener createItemListener()

Возвращает ItemListener, который добавляется к модели.

Returns:: ItemListener

setEnabled

public void setEnabled(boolean b)

Включает (или выключает) кнопку.

Overrides:

setEnabled в классе JComponent

Parameters:

b — true для включения кнопки, иначе false

See Also:

getLabel

@Deprecated public String getLabel()

Устарело.

- Заменено на getText

Возвращает текст метки.

Returns:: строку String, содержащую метку

setLabel

@Deprecated @BeanProperty(description="Replace by setText(text)") public void setLabel(String label)

Устарело.

- Заменено на setText(text)

Устанавливает текст метки.

Parameters:: label — строку String, содержащую текст

addItemListener

public void addItemListener(ItemListener l)

Добавляет ItemListener к checkbox.

Specified by:

addItemListener в интерфейсе ItemSelectable

Parameters:

l — добавляемый ItemListener

See Also:

removeItemListener

public void removeItemListener(ItemListener l)

Удаляет ItemListener из кнопки.

Specified by:

removeItemListener в интерфейсе ItemSelectable

Parameters:

l — удаляемый ItemListener

See Also:

getItemListeners

@BeanProperty(bound=false) public ItemListener[] getItemListeners()

Возвращает массив всех ItemListener, добавленных к этому AbstractButton с помощью addItemListener().

Returns:: все добавленные ItemListener или пустой массив, если слушатели не добавлены
Since:: 1.4

getSelectedObjects

@BeanProperty(bound=false) public Object[] getSelectedObjects()

Возвращает массив (длиной 1) содержащий метку или null, если кнопка не выбрана.

Specified by:: getSelectedObjects в интерфейсе ItemSelectable
Returns:: массив, содержащий 1 объект: текст кнопки, если элемент выбран; иначе null

init

protected void init(String text, Icon icon)

Инициализация AbstractButton.

Parameters:: text — текст кнопки; icon — изображение Icon для отображения на кнопке

imageUpdate

public boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)

Если иконка кнопки для текущего состояния кнопки является null или не является ImageIcon с Image, равным переданному Image, вернуть false; иначе делегирует вызов суперклассу.

Specified by:

imageUpdate в интерфейсе ImageObserver

Overrides:

imageUpdate в классе Component

Parameters:

img — Image для сравнения

infoflags — флаги, используемые для перерисовки кнопки при обновлении изображения и определяющие, сколько необходимо перерисовать

x — координата x

y — координата y

w — ширина

h — высота

Returns:

false, если флаги infoflags указывают, что изображение полностью загружено; true в противном случае.

See Also:

paramString

protected String paramString()

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

Переопределение paramString для предоставления информации о специфических новых аспектах компонентов JFC.

Overrides:: paramString в классе JComponent
Returns:: строковое представление этого AbstractButton

© 1993, 2023, 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/21/docs/api/java.desktop/javax/swing/AbstractButton.html