Класс JToggleButton

javax.swing.JToggleButton

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

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

@JavaBean(defaultProperty="UIClassID", description="An implementation of a two-state button.") public class JToggleButton extends AbstractButton implements Accessible

Реализация двухпозиционной кнопки. Классы JRadioButton и JCheckBox являются подклассами этого класса. Сведения об их использовании см. в разделе Как использовать кнопки, флажки и переключатели в учебнике по Java.

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

Предупреждение: Swing не является потокобезопасным. Дополнительные сведения см. в разделе Политика Swing в отношении потоков.

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

С версии:

1.2

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`JToggleButton.AccessibleJToggleButton`	Этот класс реализует поддержку специальных возможностей для класса `JToggleButton`.
`static class`	`JToggleButton.ToggleButtonModel`	Модель ToggleButton

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

AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

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

actionListener, BORDER_PAINTED_CHANGED_PROPERTY, changeEvent, changeListener, CONTENT_AREA_FILLED_CHANGED_PROPERTY, DISABLED_ICON_CHANGED_PROPERTY, DISABLED_SELECTED_ICON_CHANGED_PROPERTY, FOCUS_PAINTED_CHANGED_PROPERTY, HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY, HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY, ICON_CHANGED_PROPERTY, itemListener, MARGIN_CHANGED_PROPERTY, MNEMONIC_CHANGED_PROPERTY, model, MODEL_CHANGED_PROPERTY, PRESSED_ICON_CHANGED_PROPERTY, ROLLOVER_ENABLED_CHANGED_PROPERTY, ROLLOVER_ICON_CHANGED_PROPERTY, ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY, SELECTED_ICON_CHANGED_PROPERTY, TEXT_CHANGED_PROPERTY, VERTICAL_ALIGNMENT_CHANGED_PROPERTY, VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

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

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

Конструктор	Описание
`JToggleButton()`	Создает изначально невыбранную кнопку-переключатель без задания текста или изображения.
`JToggleButton(String text)`	Создает невыбранную кнопку-переключатель с указанным текстом.
`JToggleButton(String text, boolean selected)`	Создает кнопку-переключатель с указанным текстом и состоянием выбора.
`JToggleButton(String text, Icon icon)`	Создает кнопку-переключатель с указанными текстом и изображением, изначально не выбранную.
`JToggleButton(String text, Icon icon, boolean selected)`	Создает кнопку-переключатель с указанными текстом, изображением и состоянием выбора.
`JToggleButton(Action a)`	Создает кнопку-переключатель, свойства которой берутся из переданного объекта Action.
`JToggleButton(Icon icon)`	Создает изначально невыбранную кнопку-переключатель с указанным изображением, но без текста.
`JToggleButton(Icon icon, boolean selected)`	Создает кнопку-переключатель с указанными изображением и состоянием выбора, но без текста.

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

Модификатор и тип	Метод	Описание
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этим JToggleButton.
`String`	`getUIClassID()`	Возвращает строку, содержащую имя класса l&f, который отображает этот компонент.
`protected String`	`paramString()`	Возвращает строковое представление этого JToggleButton.
`void`	`requestFocus(FocusEvent.Cause cause)`	Если эта кнопка-переключатель входит в `ButtonGroup`, в котором есть другая выбранная кнопка-переключатель, способная получить фокус, а аргумент причины фокуса указывает на активацию окна или перемещение фокуса в любом направлении, результат выполнения метода совпадает с вызовом `Component.requestFocus(FocusEvent.Cause)` для выбранной в группе кнопки-переключателя.
`boolean`	`requestFocusInWindow(FocusEvent.Cause cause)`	Если эта кнопка-переключатель входит в `ButtonGroup`, в котором есть другая выбранная кнопка-переключатель, способная получить фокус, а аргумент причины фокуса указывает на активацию окна или перемещение фокуса в любом направлении, результат выполнения метода совпадает с вызовом `Component.requestFocusInWindow(FocusEvent.Cause)` для выбранной в группе кнопки-переключателя.
`void`	`updateUI()`	Сбрасывает свойство UI, устанавливая его значение из текущего оформления.

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

actionPropertyChanged, addActionListener, addChangeListener, addImpl, addItemListener, checkHorizontalKey, checkVerticalKey, configurePropertiesFromAction, createActionListener, createActionPropertyChangeListener, createChangeListener, createItemListener, doClick, doClick, fireActionPerformed, fireItemStateChanged, fireStateChanged, getAction, getActionCommand, getActionListeners, getChangeListeners, getDisabledIcon, getDisabledSelectedIcon, getDisplayedMnemonicIndex, getHideActionText, getHorizontalAlignment, getHorizontalTextPosition, getIcon, getIconTextGap, getItemListeners, getLabel, getMargin, getMnemonic, getModel, getMultiClickThreshhold, getPressedIcon, getRolloverIcon, getRolloverSelectedIcon, getSelectedIcon, getSelectedObjects, getText, getUI, getVerticalAlignment, getVerticalTextPosition, imageUpdate, init, isBorderPainted, isContentAreaFilled, isFocusPainted, isRolloverEnabled, isSelected, paintBorder, removeActionListener, removeChangeListener, removeItemListener, removeNotify, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setEnabled, setFocusPainted, setHideActionText, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setIconTextGap, setLabel, setLayout, setMargin, setMnemonic, setMnemonic, setModel, setMultiClickThreshhold, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, setText, setUI, setVerticalAlignment, setVerticalTextPosition

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

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

Методы, объявленные в классе 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, 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, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

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

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

JToggleButton

public JToggleButton()

Создает изначально невыбранную кнопку-переключатель без задания текста или изображения.

JToggleButton

public JToggleButton(Icon icon)

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

Параметры:: icon — изображение, которое должна отображать кнопка

JToggleButton

public JToggleButton(Icon icon, boolean selected)

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

Параметры:: icon — изображение, которое должна отображать кнопка; selected — если значение true, кнопка изначально выбрана; в противном случае кнопка изначально не выбрана

JToggleButton

public JToggleButton(String text)

Создает невыбранную кнопку-переключатель с указанным текстом.

Параметры:: text — строка, отображаемая на кнопке-переключателе

JToggleButton

public JToggleButton(String text, boolean selected)

Создает кнопку-переключатель с указанными текстом и состоянием выбора.

Параметры:: text — строка, отображаемая на кнопке-переключателе; selected — если значение true, кнопка изначально выбрана; в противном случае кнопка изначально не выбрана

JToggleButton

public JToggleButton(Action a)

Создает кнопку-переключатель, свойства которой берутся из переданного объекта Action.

Параметры:: a — экземпляр Action
С версии:: 1.3

JToggleButton

public JToggleButton(String text, Icon icon)

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

Параметры:: text — строка, отображаемая на кнопке; icon — изображение, которое должна отображать кнопка

JToggleButton

public JToggleButton(String text, Icon icon, boolean selected)

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

Параметры:: text — текст кнопки-переключателя; icon — изображение, которое должна отображать кнопка; selected — если значение true, кнопка изначально выбрана; в противном случае кнопка изначально не выбрана

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

updateUI

public void updateUI()

Сбрасывает свойство UI, устанавливая его значение из текущего оформления.

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

updateUI в классе AbstractButton

См. также:

getUIClassID

@BeanProperty(bound=false, description="A string that specifies the name of the L&F class") public String getUIClassID()

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

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

getUIClassID в классе JComponent

Возвращает:

строку "ToggleButtonUI"

См. также:

requestFocus

public void requestFocus(FocusEvent.Cause cause)

Если эта кнопка-переключатель входит в ButtonGroup, в котором есть другая выбранная кнопка-переключатель, способная получить фокус, а аргумент причины фокуса указывает на активацию окна или перемещение фокуса в любом направлении, результат выполнения метода совпадает с вызовом Component.requestFocus(FocusEvent.Cause) для выбранной в группе кнопки-переключателя. Во всех остальных случаях результат выполнения метода совпадает с вызовом Component.requestFocus(FocusEvent.Cause) для этой кнопки-переключателя.

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

requestFocus в классе Component

Параметры:

cause — причина, по которой запрашивается фокус

С версии:

См. также:

requestFocusInWindow

public boolean requestFocusInWindow(FocusEvent.Cause cause)

Если эта кнопка-переключатель входит в ButtonGroup, в котором есть другая выбранная кнопка-переключатель, способная получить фокус, а аргумент причины фокуса указывает на активацию окна или перемещение фокуса в любом направлении, результат выполнения метода совпадает с вызовом Component.requestFocusInWindow(FocusEvent.Cause) для выбранной в группе кнопки-переключателя. Во всех остальных случаях результат выполнения метода совпадает с вызовом Component.requestFocusInWindow(FocusEvent.Cause) для этой кнопки-переключателя.

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

requestFocusInWindow в классе Component

Параметры:

cause — причина, по которой запрашивается фокус

Возвращает:

false, если запрос на изменение фокуса гарантированно завершится неудачей; true, если он, вероятно, будет успешным

С версии:

См. также:

paramString

protected String paramString()

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

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

getAccessibleContext

@BeanProperty(bound=false, expert=true, description="The AccessibleContext associated with this ToggleButton.") public AccessibleContext getAccessibleContext()

Возвращает AccessibleContext, связанный с этим JToggleButton. Для кнопок-переключателей AccessibleContext имеет вид AccessibleJToggleButton. При необходимости создается новый экземпляр AccessibleJToggleButton.

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: AccessibleJToggleButton, выполняющий роль AccessibleContext для этого JToggleButton

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/JToggleButton.html