モジュール java.desktop

パッケージ javax.swing

クラスJCheckBox

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.AbstractButton

javax.swing.JToggleButton

javax.swing.JCheckBox

すべての実装されたインタフェース:

ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible, SwingConstants

@JavaBean(description="A component which can be selected or deselected.") public class JCheckBox extends JToggleButton implements Accessible

チェックボックス(選択または選択解除が可能で、その状態をユーザーに表示する項目)の実装です。 規則にしたがって、グループから任意の数のチェックボックスを選択できます。 チェックボックスの使用方法の詳細と例については、『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

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラス	説明
protected class	JCheckBox.AccessibleJCheckBox	このクラスはJCheckBoxクラスのアクセシビリティ・サポートを実装しています。

クラスjavax.swing.JToggleButtonで宣言されたネストされたクラス/インタフェース

JToggleButton.AccessibleJToggleButton, 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

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final String	BORDER_PAINTED_FLAT_CHANGED_PROPERTY	flatプロパティに対する変更を識別します。

クラス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

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
JCheckBox()	初期状態で選択されていない、テキストおよびアイコンなしのチェックボックス・ボタンを生成します。
JCheckBox(String text)	初期状態で選択されていない、テキスト付きのチェックボックスを生成します。
JCheckBox(String text, boolean selected)	テキスト付きのチェックボックスを生成し、それが初期状態で選択されるかどうかを指定します。
JCheckBox(String text, Icon icon)	初期状態で選択されていない、指定されたテキストおよびアイコン付きのチェックボックスを生成します。
JCheckBox(String text, Icon icon, boolean selected)	テキストおよびアイコン付きのチェックボックスを生成し、それが初期状態で選択されるかどうかを指定します。
JCheckBox(Action a)	指定されたActionからプロパティを取得するチェックボックスを生成します。
JCheckBox(Icon icon)	初期状態で選択されていない、アイコン付きのチェックボックスを生成します。
JCheckBox(Icon icon, boolean selected)	アイコン付きのチェックボックスを生成し、それが初期状態で選択されるかどうかを指定します。

メソッドのサマリー

修飾子と型	メソッド	説明
AccessibleContext	getAccessibleContext()	このJCheckBoxに関連付けられたAccessibleContextを取得します。
String	getUIClassID()	このコンポーネントをレンダリングするL&Fクラスの名前を指定する文字列を返します。
boolean	isBorderPaintedFlat()	borderPaintedFlatプロパティの値を取得します。
protected String	paramString()	このJCheckBoxの文字列表現を返します。
void	setBorderPaintedFlat(boolean b)	チェックボックス・ボーダーの外見についてのヒントをルック・アンド・フィールに与えるborderPaintedFlatプロパティを設定します。
void	updateUI()	現在のルック・アンド・フィールからの値にUIプロパティをリセットします。

クラスjavax.swing.JToggleButtonで宣言されたメソッド

requestFocus, requestFocusInWindow

クラス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

フィールド詳細

BORDER_PAINTED_FLAT_CHANGED_PROPERTY

public static final String BORDER_PAINTED_FLAT_CHANGED_PROPERTY

flatプロパティに対する変更を識別します。

関連項目:

• 定数フィールド値

コンストラクタの詳細

JCheckBox

public JCheckBox()

初期状態で選択されていない、テキストおよびアイコンなしのチェックボックス・ボタンを生成します。

JCheckBox

public JCheckBox(Icon icon)

初期状態で選択されていない、アイコン付きのチェックボックスを生成します。

パラメータ:

icon - 表示するIconイメージ

JCheckBox

public JCheckBox(Icon icon, boolean selected)

アイコン付きのチェックボックスを生成し、それが初期状態で選択されるかどうかを指定します。

パラメータ:

icon - 表示するIconイメージ

selected - 初期選択状態を示すboolean値。 trueの場合、チェックボックスが選択される

JCheckBox

public JCheckBox(String text)

初期状態で選択されていない、テキスト付きのチェックボックスを生成します。

パラメータ:

text - チェックボックスのテキスト。

JCheckBox

public JCheckBox(Action a)

指定されたActionからプロパティを取得するチェックボックスを生成します。

パラメータ:

a - 新しいチェックボックスを指定するために使用されるAction

導入されたバージョン:

1.3

JCheckBox

public JCheckBox(String text, boolean selected)

テキスト付きのチェックボックスを生成し、それが初期状態で選択されるかどうかを指定します。

パラメータ:

text - チェックボックスのテキスト。

selected - 初期選択状態を示すboolean値。 trueの場合、チェックボックスが選択される

JCheckBox

public JCheckBox(String text, Icon icon)

初期状態で選択されていない、指定されたテキストおよびアイコン付きのチェックボックスを生成します。

パラメータ:

text - チェックボックスのテキスト。

icon - 表示するIconイメージ

JCheckBox

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

テキストおよびアイコン付きのチェックボックスを生成し、それが初期状態で選択されるかどうかを指定します。

パラメータ:

text - チェックボックスのテキスト。

icon - 表示するIconイメージ

selected - 初期選択状態を示すboolean値。 trueの場合、チェックボックスが選択される

メソッドの詳細

setBorderPaintedFlat

@BeanProperty(visualUpdate=true, description="Whether the border is painted flat.") public void setBorderPaintedFlat(boolean b)

チェックボックス・ボーダーの外見についてのヒントをルック・アンド・フィールに与えるborderPaintedFlatプロパティを設定します。 JCheckBoxインスタンスがJTableやJTreeなどのコンポーネントでレンダリングとして使われている場合、このプロパティは通常trueに設定されます。 borderPaintedFlatプロパティのデフォルト値はfalseです。 このメソッドはプロパティ変更イベントをトリガーします。 均一なボーダーを実装しないルック・アンド・フィールではこのプロパティは無視されます。

パラメータ:

b - trueの場合はボーダーの均一なペイントが要求され、falseの場合は通常のボーダー・ペイントが要求される

導入されたバージョン:

1.3

関連項目:

• isBorderPaintedFlat()

isBorderPaintedFlat

public boolean isBorderPaintedFlat()

borderPaintedFlatプロパティの値を取得します。

戻り値:

borderPaintedFlatプロパティの値

導入されたバージョン:

1.3

関連項目:

• setBorderPaintedFlat(boolean)

updateUI

public void updateUI()

現在のルック・アンド・フィールからの値にUIプロパティをリセットします。

オーバーライド:

updateUI、クラスJToggleButton

関連項目:

• JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false, expert=true, description="A string that specifies the name of the L&F class") public String getUIClassID()

このコンポーネントをレンダリングするL&Fクラスの名前を指定する文字列を返します。

オーバーライド:

getUIClassID、クラスJToggleButton

戻り値:

CheckBoxUIの文字列

関連項目:

• JComponent.getUIClassID()
• UIDefaults.getUI(javax.swing.JComponent)

paramString

protected String paramString()

このJCheckBoxの文字列表現を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、nullにはできません。これは、JFCコンポーネントに固有な新しい面です。

オーバーライド:

paramString、クラスJToggleButton

戻り値:

このJCheckBoxの文字列表現

getAccessibleContext

@BeanProperty(bound=false, expert=true, description="The AccessibleContext associated with this CheckBox.") public AccessibleContext getAccessibleContext()

このJCheckBoxに関連付けられたAccessibleContextを取得します。 JCheckBoxの場合、AccessibleContextはAccessibleJCheckBoxの形式を取ります。 必要に応じて新規のAccessibleJCheckBoxインスタンスが生成されます。

定義:

getAccessibleContext、インタフェースAccessible

オーバーライド:

getAccessibleContext、クラスJToggleButton

戻り値:

このJCheckBoxのAccessibleContextとして機能するAccessibleJCheckBox