Класс 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 являются подклассами этого класса. Информацию об их использовании можно найти в Как использовать кнопки, флажки и радиокнопки, разделе учебника The Java Tutorial.

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

См. также:

JComponent.updateUI()

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, 2021, 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/17/docs/api/java.desktop/javax/swing/JToggleButton.html