Класс 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
См. также:
JRadioButton, JCheckBox, Сериализованная форма

Вложенные классы

Модификатор и тип Класс Описание
protected class  JToggleButton.AccessibleJToggleButton

Этот класс реализует поддержку доступности для класса JToggleButton.
static class  JToggleButton.ToggleButtonModel

Модель ToggleButton

Вложенные классы/интерфейсы, объявленные в классе 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)

Создаёт кнопку переключения, где свойства берутся из предоставленного 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 на значение из текущей темы оформления.

Методы, объявленные в классе 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, 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, hide, 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"
См. также:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

requestFocus

public void requestFocus(FocusEvent.Cause cause)

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

Переопределяет:
requestFocus в классе Component
Параметры:
cause - причина запроса фокуса
С момента:
9
См. также:
ButtonGroup, Component.requestFocus(FocusEvent.Cause), FocusEvent.Cause

requestFocusInWindow

public boolean requestFocusInWindow(FocusEvent.Cause cause)

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

Переопределяет:
requestFocusInWindow в классе Component
Параметры:
cause - причина запроса фокуса
Возвращает:
false если запрос изменения фокуса гарантированно завершится неудачей; true если он, скорее всего, завершится успехом
С момента:
9
См. также:
ButtonGroup, Component.requestFocusInWindow(FocusEvent.Cause), FocusEvent.Cause

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

Spec-Zone .ru
спецификации, руководства, описания, API