Класс 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`, у которой есть другая выбранная кнопка переключения, которая может быть владельцем фокуса, а аргумент cause фокуса указывает на активацию окна или действие перехода к фокусу в любом направлении, то результат выполнения метода такой же, как вызов `Component.requestFocus(FocusEvent.Cause)` для выбранной кнопки переключения в группе.
`boolean`	`requestFocusInWindow(FocusEvent.Cause cause)`	Если эта кнопка переключения является членом `ButtonGroup`, у которой есть другая выбранная кнопка переключения, которая может быть владельцем фокуса, а аргумент cause фокуса указывает на активацию окна или действие перехода к фокусу в любом направлении, то результат выполнения метода такой же, как вызов `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()

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

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, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/JToggleButton.html