モジュール java.desktop

パッケージ javax.swing

クラスJToggleButton

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.AbstractButton

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

2つの状態を持つボタンの実装です。 JRadioButtonクラスとJCheckBoxクラスは、このクラスのサブクラスです。 詳細は、『The Java Tutorial』の「How to Use Buttons, Check Boxes, and Radio Buttons」を参照してください。

ボタンは、Actionによって、構成とある程度の制御が可能です。 ボタンでActionを使用することは、ボタンを直接構成するのと比べて多くの利点があります。 詳細は「ActionをサポートするSwingコンポーネント」を参照してください。さらに、Java チュートリアルのActionsの使用方法のセクションに詳細が説明されています。

警告: Swingはスレッドに対して安全ではありません。 詳細は、「Swing's Threading Policy」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。 現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 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()	このJToggleButtonに関連付けられたAccessibleContextを取得します。
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()

初期状態で選択解除されているトグル・ボタンを、テキストおよびイメージの指定なしで作成します。

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()

このJToggleButtonに関連付けられたAccessibleContextを取得します。 トグル・ボタンの場合、AccessibleContextはAccessibleJToggleButtonの形式を取ります。 必要に応じて新規のAccessibleJToggleButtonインスタンスが作成されます。

定義:

getAccessibleContext、インタフェースAccessible

オーバーライド:

getAccessibleContext、クラスComponent

戻り値:

このJToggleButtonのAccessibleContextとして機能するAccessibleJToggleButton