JavaTM 2 Platform
Standard Ed. 5.0

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」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK バージョン 1.4 以降は、java.beans パッケージですべての JavaBeans の長期記憶がサポートされます。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.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)
          テキストおよびアイコン付きのチェックボックスを生成し、それが初期状態で選択されるかどうかを指定します。
 
メソッドの概要
protected  void configurePropertiesFromAction(Action a)
          Action インスタンスの値に従って ActionEvent ソースのプロパティを設定するファクトリメソッドです。
protected  PropertyChangeListener createActionPropertyChangeListener(Action a)
          ActionEvent ソースを Action インスタンスのプロパティの変更として更新するのに使う PropertyChangeListener を生成するファクトリメソッドです。
 AccessibleContext getAccessibleContext()
          この JCheckBox に関連付けられた AccessibleContext を返します。
 String getUIClassID()
          このコンポーネントを描画する L&F クラスの名前を文字列で返します。
 boolean isBorderPaintedFlat()
          borderPaintedFlat プロパティの値を取得します。
protected  String paramString()
          この JCheckBox の文字列表現を返します。
 void setBorderPaintedFlat(boolean b)
          チェックボックスボーダの外見についてのヒントを Look & Feel (L&F) に与える borderPaintedFlat プロパティを設定します。
 void updateUI()
          現在の Look & Feel からの値に UI プロパティをリセットします。
 
クラス javax.swing.AbstractButton から継承されたメソッド
addActionListener, addChangeListener, addImpl, addItemListener, checkHorizontalKey, checkVerticalKey, createActionListener, createChangeListener, createItemListener, doClick, doClick, fireActionPerformed, fireItemStateChanged, fireStateChanged, getAction, getActionCommand, getActionListeners, getChangeListeners, getDisabledIcon, getDisabledSelectedIcon, getDisplayedMnemonicIndex, 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, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setEnabled, setFocusPainted, 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, 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, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, 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, transferFocusBackward, 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, 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, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, 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 (L&F) に与える borderPaintedFlat プロパティを設定します。JCheckBox インスタンスが JTableJTree などのコンポーネントでレンダリングとして使われている場合、このプロパティは通常 true に設定されます。borderPaintedFlat プロパティのデフォルト値は false です。このメソッドはプロパティ変更イベントをトリガします。均一なボーダを実装しない Look & Feel (L&F) ではこのプロパティは無視されます。

パラメータ:
b - true の場合は、ボーダの均一なペイントが要求され、false の場合は、通常のボーダペイントが要求されます。
関連項目:
isBorderPaintedFlat()

isBorderPaintedFlat

public boolean isBorderPaintedFlat()
borderPaintedFlat プロパティの値を取得します。

戻り値:
borderPaintedFlat プロパティの値
関連項目:
setBorderPaintedFlat(boolean)

updateUI

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

オーバーライド:
クラス JToggleButton 内の updateUI
関連項目:
JComponent.updateUI()

getUIClassID

public String getUIClassID()
このコンポーネントを描画する L&F クラスの名前を文字列で返します。

オーバーライド:
クラス JToggleButton 内の getUIClassID
戻り値:
CheckBoxUI の文字列
関連項目:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)
Action インスタンスの値に従って ActionEvent ソースのプロパティを設定するファクトリメソッドです。設定されるプロパティはサブクラスによって異なります。デフォルトでは、設定されるプロパティは TextMnemonicEnabledActionCommand、および ToolTipText です。

オーバーライド:
クラス AbstractButton 内の configurePropertiesFromAction
パラメータ:
a - プロパティの取得元 Action、または null
導入されたバージョン:
1.3
関連項目:
Action, AbstractButton.setAction(javax.swing.Action)

createActionPropertyChangeListener

protected PropertyChangeListener createActionPropertyChangeListener(Action a)
ActionEvent ソースを Action インスタンスのプロパティの変更として更新するのに使う PropertyChangeListener を生成するファクトリメソッドです。最新の状態で保持する必要のあるプロパティのセットがデフォルトプロパティ (Text、Icon、Enabled、ToolTipText) と異なる場合は、独自の PropertyChangeListener を提供するためにサブクラスがこのメソッドをオーバーライドします。 PropertyChangeListeners は ActionEvent ソースへの強い参照を保持しないようにします。これは、ActionEvent ソースおよびその包含関係の階層にあるすべてのコンポーネントのガベージコレクションを遅らせる可能性があるからです。

オーバーライド:
クラス AbstractButton 内の createActionPropertyChangeListener
パラメータ:
a - ボタンの新しいアクション
導入されたバージョン:
1.3
関連項目:
Action, AbstractButton.setAction(javax.swing.Action)

paramString

protected String paramString()
この JCheckBox の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。これは、JFC コンポーネントの新しい特殊な面です。

オーバーライド:
クラス JToggleButton 内の paramString
戻り値:
この JCheckBox の文字列表現

getAccessibleContext

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

定義:
インタフェース Accessible 内の getAccessibleContext
オーバーライド:
クラス JToggleButton 内の getAccessibleContext
戻り値:
この JCheckBox の AccessibleContext として機能する AccessibleJCheckBox

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。