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

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

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

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

С:

1.2

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`JToggleButton.AccessibleJToggleButton`	Этот класс реализует поддержку доступности для класса `JToggleButton`.
`static class`	`JToggleButton.ToggleButtonModel`	Модель кнопки переключения

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

AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

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

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

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

Конструктор	Описание
`JToggleButton()`	Создаёт кнопку переключения, которая изначально не выбрана, без задания текста или изображения.
`JToggleButton(String text)`	Создаёт кнопку переключения, которая не выбрана, с указанным текстом.
`JToggleButton(String text, boolean selected)`	Создаёт кнопку переключения с указанным текстом и состоянием выбора.
`JToggleButton(String text, Icon icon)`	Создаёт кнопку переключения, которая изначально не выбрана, с указанным текстом и изображением.
`JToggleButton(String text, Icon icon, boolean selected)`	Создаёт кнопку переключения с указанным текстом, изображением и состоянием выбора.
`JToggleButton(Action a)`	Создаёт кнопку переключения, где свойства берутся из предоставленного действия.
`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 на значение из текущей темы оформления.

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

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

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

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

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

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

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

JToggleButton

public JToggleButton()

Создаёт кнопку переключения (toggle button), которая изначально не выбрана, без текста и изображения.

JToggleButton

public JToggleButton(Icon icon)

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

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

JToggleButton

public JToggleButton(Icon icon, boolean selected)

Создаёт кнопку переключения (toggle button) с указанным изображением и состоянием выбора, но без текста.

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

JToggleButton

public JToggleButton(String text)

Создаёт кнопку переключения (toggle button), которая изначально не выбрана, с указанным текстом.

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

JToggleButton

public JToggleButton(String text, boolean selected)

Создаёт кнопку переключения (toggle button) с указанным текстом и состоянием выбора.

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

JToggleButton

public JToggleButton(Action a)

Создаёт кнопку переключения (toggle button), свойства которой взяты из предоставленного объекта Action.

Параметры:: a - экземпляр объекта Action
С момента:: 1.3

JToggleButton

public JToggleButton(String text, Icon icon)

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

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

JToggleButton

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

Создаёт кнопку переключения (toggle button) с указанным текстом, изображением и состоянием выбора.

Параметры:: 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)

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

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

requestFocus в классе Component

Параметры:

cause - причина запроса фокуса

С момента:

См. также:

requestFocusInWindow

public boolean requestFocusInWindow(FocusEvent.Cause cause)

Если эта кнопка переключения (toggle button) является членом группы 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/JToggleButton.html