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

public class JCheckBox
extends JToggleButton
implements Accessible

チェックボックス (選択または選択解除が可能で、その状態をユーザーに表示する項目) の実装です。規則にしたがって、グループから任意の数のチェックボックスを選択できます。チェックボックスの使用方法の詳細と例については、『The Java Tutorial』の「How to Use Buttons, Check Boxes, and Radio Buttons」を参照してください。

ボタンは構成可能で、Action を使ってある程度まで制御できます。ボタンに対して Action を使用すると、直接ボタンを構成するよりも多くの利点があります。詳細は、「Action をサポートする Swing コンポーネント」を参照してください。また、『The Java Tutorial』の「How to Use Actions」も参照してください。

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

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。1.4 以降、すべての JavaBeans^TM 用の長期間の格納サポートが java.beans パッケージに追加されています。XMLEncoder を参照してください。

関連項目:

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 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 から継承されたフィールド

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

クラス java.awt.Component から継承されたフィールド

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

インタフェース 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

インタフェース java.awt.image.ImageObserver から継承されたフィールド

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

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

コンストラクタ

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

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
AccessibleContext	getAccessibleContext() この JCheckBox に関連付けられた AccessibleContext を取得します。
String	getUIClassID() このコンポーネントをレンダリングする L&F クラスの名前を指定する文字列を返します。
boolean	isBorderPaintedFlat() borderPaintedFlat プロパティーの値を取得します。
protected String	paramString() この JCheckBox の文字列表現を返します。
void	setBorderPaintedFlat(boolean b) チェックボックスボーダーの外見についてのヒントを Look & Feel (LF) に与える borderPaintedFlat プロパティーを設定します。
void	updateUI() 現在の Look & Feel からの値に 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, 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, 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, getPeer, 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, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, 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 からプロパティーを取得するチェックボックスを生成します。

導入されたバージョン:

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

public void setBorderPaintedFlat(boolean b)

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

パラメータ:

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

導入されたバージョン:

1.3

関連項目:

isBorderPaintedFlat()

isBorderPaintedFlat

public boolean isBorderPaintedFlat()

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

戻り値:

borderPaintedFlat プロパティーの値

導入されたバージョン:

1.3

関連項目:

setBorderPaintedFlat(boolean)

updateUI

public void updateUI()

現在の Look & Feel からの値に UI プロパティーをリセットします。

オーバーライド:

updateUI 、クラス: JToggleButton

関連項目:

JComponent.updateUI()

getUIClassID

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

public AccessibleContext getAccessibleContext()

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

定義:

getAccessibleContext 、インタフェース: Accessible

オーバーライド:

getAccessibleContext 、クラス: JToggleButton

戻り値:

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