Spec-Zone.ru › OpenJDK 24

Класс AbstractButton

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
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, а также в разделе Как использовать Action в руководстве Java.

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

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями 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
Идентифицирует изменение состояния перехода между состояниями rollover и отключенным.
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.
END_OF_DOCUMENT_MARKER
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()
Сбрасывает свойство UI до значения из текущей темы.

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
Идентифицирует изменение в модели кнопки.
См. также:
  • Constant Field Values

TEXT_CHANGED_PROPERTY

public static final String TEXT_CHANGED_PROPERTY
Идентифицирует изменение текста кнопки.
См. также:
  • Constant Field Values

MNEMONIC_CHANGED_PROPERTY

public static final String MNEMONIC_CHANGED_PROPERTY
Идентифицирует изменение мнемоники кнопки.
См. также:
  • Constant Field Values

MARGIN_CHANGED_PROPERTY

public static final String MARGIN_CHANGED_PROPERTY
Идентифицирует изменение полей кнопки.
См. также:
  • Constant Field Values

VERTICAL_ALIGNMENT_CHANGED_PROPERTY

public static final String VERTICAL_ALIGNMENT_CHANGED_PROPERTY
Идентифицирует изменение вертикального выравнивания текста кнопки.
См. также:
  • Constant Field Values

HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY

public static final String HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY
Идентифицирует изменение горизонтального выравнивания текста кнопки.
См. также:
  • Constant Field Values

VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

public static final String VERTICAL_TEXT_POSITION_CHANGED_PROPERTY
Идентифицирует изменение вертикального положения текста кнопки.
См. также:
  • Constant Field Values

HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY

public static final String HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY
Идентифицирует изменение горизонтального положения текста кнопки.
См. также:
  • Constant Field Values

BORDER_PAINTED_CHANGED_PROPERTY

public static final String BORDER_PAINTED_CHANGED_PROPERTY
Идентифицирует изменение, связанное с отрисовкой или неотрисовкой границы.
См. также:
  • Constant Field Values

FOCUS_PAINTED_CHANGED_PROPERTY

public static final String FOCUS_PAINTED_CHANGED_PROPERTY
Идентифицирует изменение, связанное с выделением границы при фокусировке.
См. также:
  • Constant Field Values

ROLLOVER_ENABLED_CHANGED_PROPERTY

public static final String ROLLOVER_ENABLED_CHANGED_PROPERTY
Идентифицирует изменение состояния "rollover" с включенного на выключенное и обратно.
См. также:
  • Constant Field Values

CONTENT_AREA_FILLED_CHANGED_PROPERTY

public static final String CONTENT_AREA_FILLED_CHANGED_PROPERTY
Идентифицирует изменение, связанное с отрисовкой области содержимого кнопки.
См. также:
  • Constant Field Values

ICON_CHANGED_PROPERTY

public static final String ICON_CHANGED_PROPERTY
Идентифицирует изменение значка кнопки.
См. также:
  • Constant Field Values

PRESSED_ICON_CHANGED_PROPERTY

public static final String PRESSED_ICON_CHANGED_PROPERTY
Идентифицирует изменение значка, используемого при нажатии кнопки.
См. также:
  • Constant Field Values

SELECTED_ICON_CHANGED_PROPERTY

public static final String SELECTED_ICON_CHANGED_PROPERTY
Идентифицирует изменение значка, используемого при выборе кнопки.
См. также:
  • Constant Field Values

ROLLOVER_ICON_CHANGED_PROPERTY

public static final String ROLLOVER_ICON_CHANGED_PROPERTY
Идентифицирует изменение значка, используемого при наведении курсора на кнопку.
См. также:
  • Constant Field Values

ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY

public static final String ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY
Идентифицирует изменение значка, используемого при наведении курсора на выбранную кнопку.
См. также:
  • Constant Field Values

DISABLED_ICON_CHANGED_PROPERTY

public static final String DISABLED_ICON_CHANGED_PROPERTY
Идентифицирует изменение значка, используемого при отключении кнопки.
См. также:
  • Constant Field Values

DISABLED_SELECTED_ICON_CHANGED_PROPERTY

public static final String DISABLED_SELECTED_ICON_CHANGED_PROPERTY
Идентифицирует изменение значка, используемого при отключении и выборе кнопки.
См. также:
  • Constant Field Values

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.
Parameters:
hideActionText - true, если свойство text кнопки не должно отражать свойство Action; значение по умолчанию — false
Since:
1.6
See Also:
  • Swing-компоненты, поддерживающие Action

getHideActionText

public boolean getHideActionText()
Возвращает значение свойства hideActionText, определяющего, отображает ли кнопка текст из Action. Это полезно только в том случае, если на кнопку установлен Action.
Returns:
true, если свойство text кнопки не должно отражать свойство Action; значение по умолчанию — false
Since:
1.6

getText

public String getText()
Возвращает текст кнопки.
Returns:
текст кнопки
See Also:
  • setText(java.lang.String)

setText

@BeanProperty(preferred=true, visualUpdate=true, description="The button's text.") public void setText(String text)
Устанавливает текст кнопки.
Parameters:
text - строка, используемая для установки текста
See Also:
  • getText()

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, за создание соответствующего отступа отвечает объект Border (иначе это свойство будет фактически проигнорировано).
Parameters:
m - отступ между границей и меткой

getMargin

public Insets getMargin()
Возвращает отступ между границей кнопки и меткой.
Returns:
объект Insets, определяющий отступ между границей кнопки и меткой
See Also:
  • setMargin(java.awt.Insets)

getIcon

public Icon getIcon()
Возвращает стандартный значок.
Returns:
стандартный Icon
See Also:
  • setIcon(javax.swing.Icon)

setIcon

@BeanProperty(visualUpdate=true, description="The button's default icon") public void setIcon(Icon defaultIcon)
Устанавливает стандартный значок кнопки. Этот значок также используется в качестве значка «нажатия» и «отключен», если явно не задан значок нажатия.
Parameters:
defaultIcon - значок, используемый в качестве стандартного изображения
See Also:
  • getIcon()
  • setPressedIcon(javax.swing.Icon)

getPressedIcon

public Icon getPressedIcon()
Возвращает значок нажатия кнопки.
Returns:
свойство pressedIcon
See Also:
  • setPressedIcon(javax.swing.Icon)

setPressedIcon

@BeanProperty(visualUpdate=true, description="The pressed icon for the button.") public void setPressedIcon(Icon pressedIcon)
Устанавливает значок нажатия кнопки.
Parameters:
pressedIcon - значок, используемый в качестве изображения «нажатия»
See Also:
  • getPressedIcon()

getSelectedIcon

public Icon getSelectedIcon()
Возвращает значок выделения кнопки.
Returns:
свойство selectedIcon
See Also:
  • setSelectedIcon(javax.swing.Icon)

setSelectedIcon

@BeanProperty(visualUpdate=true, description="The selected icon for the button.") public void setSelectedIcon(Icon selectedIcon)
Устанавливает значок выделения кнопки.
Parameters:
selectedIcon - значок, используемый в качестве изображения «выделения»
See Also:
  • getSelectedIcon()

getRolloverIcon

public Icon getRolloverIcon()
Возвращает значок наведения курсора на кнопку.
Returns:
свойство rolloverIcon
See Also:
  • setRolloverIcon(javax.swing.Icon)

setRolloverIcon

@BeanProperty(visualUpdate=true, description="The rollover icon for the button.") public void setRolloverIcon(Icon rolloverIcon)
Устанавливает значок наведения курсора на кнопку.
Parameters:
rolloverIcon - значок, используемый в качестве изображения «наведения»
See Also:
  • getRolloverIcon()

getRolloverSelectedIcon

public Icon getRolloverSelectedIcon()
Возвращает значок наведения курсора на выделенную кнопку.
Returns:
свойство rolloverSelectedIcon
See Also:
  • setRolloverSelectedIcon(javax.swing.Icon)

setRolloverSelectedIcon

@BeanProperty(visualUpdate=true, description="The rollover selected icon for the button.") public void setRolloverSelectedIcon(Icon rolloverSelectedIcon)
Устанавливает значок наведения курсора на выделенную кнопку.
Parameters:
rolloverSelectedIcon - значок, используемый в качестве изображения «выделенное наведение»
See Also:
  • getRolloverSelectedIcon()

getDisabledIcon

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

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

Returns:
свойство disabledIcon
See Also:
  • getPressedIcon()
  • setDisabledIcon(javax.swing.Icon)
  • LookAndFeel.getDisabledIcon(javax.swing.JComponent, javax.swing.Icon)

setDisabledIcon

@BeanProperty(visualUpdate=true, description="The disabled icon for the button.") public void setDisabledIcon(Icon disabledIcon)
Устанавливает значок для состояния отключения кнопки.
Parameters:
disabledIcon - значок, используемый в качестве изображения отключённого состояния
See Also:
  • getDisabledIcon()

getDisabledSelectedIcon

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

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

Возвращает:
свойство disabledSelectedIcon
См. также:
  • getDisabledIcon()
  • setDisabledSelectedIcon(javax.swing.Icon)
  • LookAndFeel.getDisabledSelectedIcon(javax.swing.JComponent, javax.swing.Icon)

setDisabledSelectedIcon

@BeanProperty(visualUpdate=true, description="The disabled selection icon for the button.") public void setDisabledSelectedIcon(Icon disabledSelectedIcon)
Устанавливает значок для отключенного выбранного состояния кнопки.
Параметры:
disabledSelectedIcon - значок, используемый в качестве изображения для отключенного выбранного состояния
См. также:
  • getDisabledSelectedIcon()

getVerticalAlignment

public int getVerticalAlignment()
Возвращает вертикальное выравнивание текста и значка.
Возвращает:
свойство 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)
Устанавливает вертикальное выравнивание значка и текста.
Параметры:
alignment - одно из следующих значений:
  • SwingConstants.CENTER (по умолчанию)
  • SwingConstants.TOP
  • SwingConstants.BOTTOM
Исключения:
IllegalArgumentException - если выравнивание не соответствует одному из допустимых значений, перечисленных выше

getHorizontalAlignment

public int getHorizontalAlignment()
Возвращает горизонтальное выравнивание значка и текста. По умолчанию для AbstractButton установлено значение SwingConstants.CENTER, но подклассы, такие как JCheckBox, могут использовать другое значение по умолчанию.
Возвращает:
свойство 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, могут использовать другое значение по умолчанию.
Параметры:
alignment - значение выравнивания, одно из следующих значений:
  • SwingConstants.RIGHT
  • SwingConstants.LEFT
  • SwingConstants.CENTER
  • SwingConstants.LEADING
  • SwingConstants.TRAILING
Исключения:
IllegalArgumentException - если выравнивание не соответствует одному из допустимых значений

getVerticalTextPosition

public int getVerticalTextPosition()
Возвращает вертикальное положение текста относительно значка.
Возвращает:
свойство 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)
Устанавливает вертикальное положение текста относительно значка.
Параметры:
textPosition - одно из следующих значений:
  • SwingConstants.CENTER (по умолчанию)
  • SwingConstants.TOP
  • SwingConstants.BOTTOM

getHorizontalTextPosition

public int getHorizontalTextPosition()
Возвращает горизонтальное положение текста относительно значка.
Возвращает:
свойство 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)
Устанавливает горизонтальное положение текста относительно значка.
Параметры:
textPosition - одно из следующих значений:
  • SwingConstants.RIGHT
  • SwingConstants.LEFT
  • SwingConstants.CENTER
  • SwingConstants.LEADING
  • SwingConstants.TRAILING (по умолчанию)
Исключения:
IllegalArgumentException - если textPosition не соответствует одному из допустимых значений, перечисленных выше

getIconTextGap

public int getIconTextGap()
Возвращает расстояние между текстом и значком, отображаемыми в этой кнопке.
Возвращает:
целое число, равное количеству пикселей между текстом и значком.
С:
1.4
См. также:
  • setIconTextGap(int)

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.

Параметры:
iconTextGap - расстояние между значком и текстом, если эти свойства установлены.
С:
1.4
См. также:
  • getIconTextGap()

checkHorizontalKey

protected int checkHorizontalKey(int key, String exception)
Проверка того, что аргумент key является допустимым значением для свойств horizontalAlignment и horizontalTextPosition. Допустимые значения:
  • SwingConstants.RIGHT
  • SwingConstants.LEFT
  • SwingConstants.CENTER
  • SwingConstants.LEADING
  • SwingConstants.TRAILING
Параметры:
key - проверяемое значение свойства
exception - сообщение, используемое в IllegalArgumentException, которое выбрасывается для недопустимого значения
Возвращает:
аргумент key
Исключения:
IllegalArgumentException - если ключ не соответствует одному из допустимых значений, перечисленных выше
См. также:
  • setHorizontalTextPosition(int)
  • setHorizontalAlignment(int)

checkVerticalKey

protected int checkVerticalKey(int key, String exception)
Проверка того, что аргумент key является допустимым значением для вертикальных свойств. Допустимые значения:
  • SwingConstants.CENTER
  • SwingConstants.TOP
  • SwingConstants.BOTTOM
Параметры:
key - проверяемое значение свойства
exception - сообщение, используемое в IllegalArgumentException, которое выбрасывается для недопустимого значения
Возвращает:
аргумент key
Исключения:
IllegalArgumentException - если ключ не соответствует одному из допустимых значений, перечисленных выше

removeNotify

public void removeNotify()
Уведомляет этот компонент о том, что он больше не имеет родительского компонента. При вызове этого метода все KeyboardAction, настроенные в цепочке родительских компонентов, удаляются. Этот метод вызывается инструментарием внутренне и не должен вызываться программами напрямую.
Переопределяет:
removeNotify в классе JComponent
С:
1.6
См. также:
  • JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

setActionCommand

public void setActionCommand(String actionCommand)
Устанавливает командную строку действия для этой кнопки.
Параметры:
actionCommand - командная строка действия для этой кнопки

getActionCommand

public String getActionCommand()
Возвращает командную строку действия для этой кнопки.
Возвращает:
командную строку действия для этой кнопки

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 приводит к немедленному изменению всех свойств, описанных в Компоненты Swing, поддерживающие Action. Впоследствии свойства кнопки автоматически обновляются при изменении свойств Action.

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

Parameters:
a - Action для AbstractButton, или null
Since:
1.3
See Also:
  • Action
  • getAction()
  • configurePropertiesFromAction(javax.swing.Action)
  • createActionPropertyChangeListener(javax.swing.Action)
  • actionPropertyChanged(javax.swing.Action, java.lang.String)

getAction

public Action getAction()
Возвращает текущее заданное Action для этого источника ActionEvent, или null, если Action не задан.
Returns:
Action для этого источника ActionEvent, или null
Since:
1.3
See Also:
  • Action
  • setAction(javax.swing.Action)

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)
Устанавливает свойства этой кнопки, чтобы соответствовать свойствам в указанном Action. Дополнительные сведения о настраиваемых свойствах см. в разделе Компоненты Swing, поддерживающие Action.
Parameters:
a - Action, из которого необходимо получить свойства, или null
Since:
1.3
See Also:
  • Action
  • setAction(javax.swing.Action)

actionPropertyChanged

protected void actionPropertyChanged(Action action, String propertyName)
Обновляет состояние кнопки в ответ на изменения свойств в связанном действии. Этот метод вызывается из PropertyChangeListener, возвращённого из createActionPropertyChangeListener. Подклассам обычно вызывать это не нужно. Подклассы, поддерживающие дополнительные Action свойства, должны переопределять этот метод и configurePropertiesFromAction.

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

Parameters:
action - Action, связанный с этой кнопкой
propertyName - имя изменённого свойства
Since:
1.6
See Also:
  • Action
  • configurePropertiesFromAction(javax.swing.Action)

createActionPropertyChangeListener

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

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

Parameters:
a - действие кнопки
Returns:
PropertyChangeListener
Since:
1.3
See Also:
  • Action
  • setAction(javax.swing.Action)

isBorderPainted

public boolean isBorderPainted()
Получает свойство borderPainted.
Returns:
значение свойства borderPainted
See Also:
  • setBorderPainted(boolean)

setBorderPainted

@BeanProperty(visualUpdate=true, description="Whether the border should be painted.") public void setBorderPainted(boolean b)
Устанавливает свойство borderPainted. Если true и кнопка имеет границу, то граница будет нарисована. Значение свойства borderPainted по умолчанию - true.

Некоторые визуальные стили (look and feels) могут не поддерживать свойство borderPainted, в этом случае они его игнорируют.

Parameters:
b - если true и свойство границы не null, то граница рисуется
See Also:
  • isBorderPainted()

paintBorder

protected void paintBorder(Graphics g)
Рисует границу кнопки, если свойство BorderPainted равно true и у кнопки есть граница.
Overrides:
paintBorder в классе JComponent
Parameters:
g - контекст Graphics, в котором необходимо нарисовать
See Also:
  • JComponent.paint(java.awt.Graphics)
  • JComponent.setBorder(javax.swing.border.Border)

isFocusPainted

public boolean isFocusPainted()
Получает свойство paintFocus.
Returns:
свойство paintFocus
See Also:
  • setFocusPainted(boolean)

setFocusPainted

@BeanProperty(visualUpdate=true, description="Whether focus should be painted") public void setFocusPainted(boolean b)
Устанавливает свойство paintFocus, которое должно быть true для отрисовки состояния фокуса. Значение свойства paintFocus по умолчанию - true. Некоторые визуальные стили (look and feels) могут не отрисовывать состояние фокуса; они проигнорируют это свойство.
Parameters:
b - если true, состояние фокуса должно быть отрисовано
See Also:
  • isFocusPainted()

isContentAreaFilled

public boolean isContentAreaFilled()
Получает свойство contentAreaFilled.
Returns:
свойство contentAreaFilled
See Also:
  • setContentAreaFilled(boolean)

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 компонента.

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

Parameters:
b - если true, область содержимого заполняется; если false, область содержимого не заполняется
See Also:
  • isContentAreaFilled()
  • JComponent.setOpaque(boolean)

isRolloverEnabled

public boolean isRolloverEnabled()
Получает свойство rolloverEnabled.
Returns:
значение свойства rolloverEnabled
See Also:
  • setRolloverEnabled(boolean)
END_OF_DOCUMENT_MARKER

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:
  • isRolloverEnabled()

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:
  • KeyEvent
  • setDisplayedMnemonicIndex(int)

setMnemonic

@BeanProperty(visualUpdate=true, description="the keyboard character mnemonic") public void setMnemonic(char mnemonic)
Этот метод устарел, используйте setMnemonic(int) для установки мнемоники для кнопки. Этот метод предназначен только для обработки символьных значений, которые находятся в диапазоне от 'a' до 'z' или от 'A' до 'Z'.
Parameters:
mnemonic - символ, определяющий значение мнемоники
See Also:
  • setMnemonic(int)

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 указывает на отсутствие мнемоники, символ мнемоники отсутствует в строке или разработчик не хочет отображать мнемонику.

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

Parameters:
index - Индекс в строке для подчеркивания
Throws:
IllegalArgumentException - будет брошено, если index больше или равно длине текста или меньше -1
Since:
1.4
See Also:
  • getDisplayedMnemonicIndex()

getDisplayedMnemonicIndex

public int getDisplayedMnemonicIndex()
Возвращает символ в виде индекса, для которого оформление должно предоставить выделение в качестве символа мнемоники.
Returns:
индекс, представляющий символ мнемоники
Since:
1.4
See Also:
  • setDisplayedMnemonicIndex(int)

setMultiClickThreshhold

public void setMultiClickThreshhold(long threshold)
Устанавливает время (в миллисекундах), необходимое между событиями нажатия мыши, чтобы кнопка сгенерировала соответствующие события действий. После первоначального нажатия мыши (и сгенерированного события действия) все последующие события нажатия мыши, которые происходят с интервалами меньше, чем порог, будут проигнорированы, и соответствующее событие действия не будет сгенерировано. По умолчанию порог равен 0, что означает, что для каждого нажатия мыши будет сгенерировано событие действия, независимо от того, как быстро происходят щелчки мыши. В кнопках, где такое поведение нежелательно (например, кнопка «ОК» в диалоговом окне), этот порог должен быть установлен на соответствующее положительное значение.
Parameters:
threshold - время, необходимое между событиями нажатия мыши, чтобы сгенерировать соответствующие события действий
Throws:
IllegalArgumentException - если порог < 0
Since:
1.4
See Also:
  • getMultiClickThreshhold()

getMultiClickThreshhold

public long getMultiClickThreshhold()
Получает время (в миллисекундах), необходимое между событиями нажатия мыши, чтобы кнопка сгенерировала соответствующие события действий.
Returns:
время, необходимое между событиями нажатия мыши, чтобы сгенерировать соответствующие события действий
Since:
1.4
See Also:
  • setMultiClickThreshhold(long)

getModel

public ButtonModel getModel()
Возвращает модель, которую представляет эта кнопка.
Returns:
свойство model
See Also:
  • setModel(javax.swing.ButtonModel)

setModel

@BeanProperty(description="Model that the Button uses.") public void setModel(ButtonModel newModel)
Устанавливает модель, которую представляет эта кнопка.
Parameters:
newModel - новая ButtonModel
See Also:
  • getModel()

getUI

public ButtonUI getUI()
Возвращает объект L&F, который отрисовывает этот компонент.
Overrides:
getUI в классе JComponent
Returns:
объект ButtonUI
See Also:
  • setUI(javax.swing.plaf.ButtonUI)

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the LookAndFeel.") public void setUI(ButtonUI ui)
Устанавливает объект L&F, который отрисовывает этот компонент.
Parameters:
ui - объект L&F ButtonUI
See Also:
  • getUI()

updateUI

public void updateUI()
Сбрасывает свойство UI до значения из текущего стиля оформления. Подклассы AbstractButton должны переопределять этот метод для обновления UI. Например, JButton может сделать следующее: 
      setUI((ButtonUI)UIManager.getUI(
          "ButtonUI", "javax.swing.plaf.basic.BasicButtonUI", this));
Overrides:
updateUI в классе JComponent
See Also:
  • JComponent.setUI(javax.swing.plaf.ComponentUI)
  • UIManager.getLookAndFeel()
  • UIManager.getUI(javax.swing.JComponent)

addImpl

protected void addImpl(Component comp, Object constraints, int index)
Добавляет указанный компонент в этот контейнер в указанном индексе, обратитесь к Container.addImpl(Component, Object, int) для полного описания этого метода.
Overrides:
addImpl в классе Container
Parameters:
comp - добавляемый компонент
constraints - объект, выражающий ограничения макета для этого компонента
index - позиция в списке контейнера, в которой следует вставить компонент, где -1 означает добавление в конец
Throws:
IllegalArgumentException - если index неверно
IllegalArgumentException - если добавляется родитель контейнера в него сам
IllegalArgumentException - если добавляется окно в контейнер
Since:
1.5
See Also:
  • Container.add(Component)
  • Container.add(Component, int)
  • Container.add(Component, java.lang.Object)
  • Container.invalidate()
  • LayoutManager
  • LayoutManager2

setLayout

public void setLayout(LayoutManager mgr)
Устанавливает менеджер компоновки для этого контейнера, см. Container.setLayout(LayoutManager) для полного описания этого метода.
Overrides:
setLayout в классе Container
Parameters:
mgr - заданный менеджер компоновки
Since:
1.5
See Also:
  • Container.doLayout()
  • Container.getLayout()
  • Container.invalidate()

addChangeListener

public void addChangeListener(ChangeListener l)
Добавляет ChangeListener к кнопке.
Parameters:
l - слушатель, который нужно добавить

removeChangeListener

public void removeChangeListener(ChangeListener l)
Удаляет ChangeListener из кнопки.
Parameters:
l - слушатель, который нужно удалить

getChangeListeners

@BeanProperty(bound=false) public ChangeListener[] getChangeListeners()
Возвращает массив всех ChangeListener, добавленных к этому AbstractButton с помощью addChangeListener().
Returns:
все добавленные ChangeListener или пустой массив, если слушатели не были добавлены
Since:
1.4

fireStateChanged

protected void fireStateChanged()
Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события. Экземпляр события создается лениво.
See Also:
  • EventListenerList

addActionListener

public void addActionListener(ActionListener l)
Добавляет ActionListener к кнопке.
Parameters:
l - добавляемый ActionListener

removeActionListener

public void removeActionListener(ActionListener l)
Удаляет ActionListener из кнопки. Если слушатель является текущим установленным Action для кнопки, то Action устанавливается в null.
Parameters:
l - слушатель, который нужно удалить

getActionListeners

@BeanProperty(bound=false) public ActionListener[] getActionListeners()
Возвращает массив всех ActionListener, добавленных к этому AbstractButton с помощью addActionListener().
Returns:
все добавленные ActionListener или пустой массив, если слушатели не были добавлены
Since:
1.4

createChangeListener

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

fireActionPerformed

protected void fireActionPerformed(ActionEvent event)
Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события. Экземпляр события создается лениво с использованием параметра event.
Parameters:
event - объект ActionEvent
See Also:
  • EventListenerList

fireItemStateChanged

protected void fireItemStateChanged(ItemEvent event)
Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события. Экземпляр события создается лениво с использованием параметра event.
Parameters:
event - объект ItemEvent
See Also:
  • EventListenerList

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:
  • Component.isEnabled()
  • Component.isLightweight()

getLabel

@Deprecated public String getLabel()
Deprecated.
- Заменён на getText
Возвращает текст метки.
Returns:
String содержащий метку

setLabel

@Deprecated @BeanProperty(description="Replace by setText(text)") public void setLabel(String label)
Deprecated.
- Заменён на setText(text)
Устанавливает текст метки.
Parameters:
label - String содержащий текст

addItemListener

public void addItemListener(ItemListener l)
Добавляет ItemListener к checkbox.
Specified by:
addItemListener в интерфейсе ItemSelectable
Parameters:
l - добавляемый ItemListener
See Also:
  • ItemEvent

removeItemListener

public void removeItemListener(ItemListener l)
Удаляет ItemListener из кнопки.
Specified by:
removeItemListener в интерфейсе ItemSelectable
Parameters:
l - удаляемый ItemListener
See Also:
  • ItemEvent

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; в противном случае делегируется суперклассу.
Определено в:
imageUpdate в интерфейсе ImageObserver
Переопределяет:
imageUpdate в классе Component
Параметры:
img - Image для сравнения
infoflags - флаги, используемые для перерисовки кнопки при обновлении изображения и определяющие, сколько нужно перерисовать
x - координата x
y - координата y
w - ширина
h - высота
Возвращает:
false, если флаги infoflags указывают, что изображение полностью загружено; true в противном случае.
См. также:
  • ImageObserver
  • Component.imageUpdate(java.awt.Image, int, int, int, int, int)

paramString

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

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

Переопределяет:
paramString в классе JComponent
Возвращает:
строковое представление этого AbstractButton

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/AbstractButton.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API