Java Platform 1.2
Beta 4

Class com.sun.java.swing.JCheckBox

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--com.sun.java.swing.JComponent
                    |
                    +--com.sun.java.swing.AbstractButton
                          |
                          +--com.sun.java.swing.JToggleButton
                                |
                                +--com.sun.java.swing.JCheckBox

public class JCheckBox
extends JToggleButton
implements Accessible
An implementation of a CheckBox -- an item that can be selected or deselected, and which displays its state to the user. In a group of checkboxes, multiple checkboxes can be selected. See How to Use CheckBoxes in The Java Tutorial for further documentation.

For the keyboard keys used by this component in the standard Look and Feel (L&F) renditions, see the JCheckBox key assignments.

Warning: serialized objects of this class will not be compatible with future swing releases. The current serialization support is appropriate for short term storage or RMI between Swing1.0 applications. It will not be possible to load serialized Swing1.0 objects with future releases of Swing. The JDK1.2 release of Swing will be the compatibility baseline for the serialized form of Swing objects.

See Also:
JRadioButton, Serialized Form

Inner Class Summary
protected   JCheckBox.AccessibleJCheckBox
          The class used to obtain the accessible role for this object.
 
Inner classes inherited from class com.sun.java.swing.JToggleButton
JToggleButton.AccessibleJToggleButton , JToggleButton.ToggleButtonModel
 
Inner classes inherited from class com.sun.java.swing.AbstractButton
AbstractButton.AccessibleAbstractButton , AbstractButton.ButtonChangeListener
 
Inner classes inherited from class com.sun.java.swing.JComponent
JComponent.AccessibleJComponent
 
Fields inherited from class com.sun.java.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
 
Fields inherited from class com.sun.java.swing.JComponent
accessibleContext , listenerList , TOOL_TIP_TEXT_KEY , ui , UNDEFINED_CONDITION , WHEN_ANCESTOR_OF_FOCUSED_COMPONENT , WHEN_FOCUSED , WHEN_IN_FOCUSED_WINDOW
 
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT , CENTER_ALIGNMENT , LEFT_ALIGNMENT , RIGHT_ALIGNMENT , TOP_ALIGNMENT
 
Constructor Summary
JCheckBox()
          Creates an initially unselected checkbox button with no text, no icon.
JCheckBox(Icon icon, boolean selected)
          Creates a checkbox with an icon and specifies whether or not it is initially selected.
JCheckBox(Icon icon)
          Creates an initially unselected checkbox with an icon.
JCheckBox(String text, boolean selected)
          Creates a checkbox with text and specifies whether or not it is initially selected.
JCheckBox(String text, Icon icon, boolean selected)
          Creates a checkbox with text and icon, and specifies whether or not it is initially selected.
JCheckBox(String text, Icon icon)
          Creates an initially unselected checkbox with the specified text and icon.
JCheckBox(String text)
          Creates an initially unselected checkbox with text.
 
Method Summary
 AccessibleContext getAccessibleContext()
          Get the AccessibleContext associated with this JComponent
 String getUIClassID()
          Returns a string that specifies the name of the L&F class that renders this component.
 void updateUI()
          Notification from the UIFactory that the L&F has changed.
 
Methods inherited from class com.sun.java.swing.AbstractButton
addActionListener , addChangeListener , addItemListener , checkHorizontalKey , checkVerticalKey , createActionListener , createChangeListener , createItemListener , doClick , doClick , fireActionPerformed , fireItemStateChanged , fireStateChanged , getActionCommand , getDisabledIcon , getDisabledSelectedIcon , getHorizontalAlignment , getHorizontalTextPosition , getIcon , getLabel , getMargin , getMnemonic , getModel , getPressedIcon , getRolloverIcon , getRolloverSelectedIcon , getSelectedIcon , getSelectedObjects , getText , getUI , getVerticalAlignment , getVerticalTextPosition , init , isBorderPainted , isContentAreaFilled , isFocusPainted , isRolloverEnabled , isSelected , paintBorder , removeActionListener , removeChangeListener , removeItemListener , setActionCommand , setBorderPainted , setContentAreaFilled , setDisabledIcon , setDisabledSelectedIcon , setEnabled , setFocusPainted , setHorizontalAlignment , setHorizontalTextPosition , setIcon , setLabel , setMargin , setMnemonic , setMnemonic , setModel , setPressedIcon , setRolloverEnabled , setRolloverIcon , setRolloverSelectedIcon , setSelected , setSelectedIcon , setText , setUI , setVerticalAlignment , setVerticalTextPosition
 
Methods inherited from class com.sun.java.swing.JComponent
addAncestorListener , addNotify , addPropertyChangeListener , addVetoableChangeListener , computeVisibleRect , contains , createToolTip , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , fireVetoableChange , getActionForKeyStroke , getAlignmentX , getAlignmentY , getAutoscrolls , getBorder , getBounds , getClientProperty , getComponentGraphics , getConditionForKeyStroke , getDebugGraphicsOptions , getGraphics , getHeight , getInsets , getInsets , getLocation , getMaximumSize , getMinimumSize , getNextFocusableComponent , getPreferredSize , getRegisteredKeyStrokes , getRootPane , getSize , getToolTipLocation , getToolTipText , getToolTipText , getTopLevelAncestor , getVisibleRect , getWidth , getX , getY , grabFocus , hasFocus , isDoubleBuffered , isFocusCycleRoot , isFocusTraversable , isLightweightComponent , isManagingFocus , isOpaque , isOptimizedDrawingEnabled , isPaintingTile , isRequestFocusEnabled , isValidateRoot , paint , paintChildren , paintComponent , paintImmediately , paintImmediately , processComponentKeyEvent , processFocusEvent , processKeyEvent , processMouseMotionEvent , putClientProperty , registerKeyboardAction , registerKeyboardAction , removeAncestorListener , removeNotify , removePropertyChangeListener , removeVetoableChangeListener , repaint , repaint , requestDefaultFocus , requestFocus , resetKeyboardActions , reshape , revalidate , scrollRectToVisible , setAlignmentX , setAlignmentY , setAutoscrolls , setBorder , setDebugGraphicsOptions , setDoubleBuffered , setMaximumSize , setMinimumSize , setNextFocusableComponent , setOpaque , setPreferredSize , setRequestFocusEnabled , setToolTipText , setUI , setVisible , unregisterKeyboardAction , update
 
Methods inherited from class java.awt.Container
add , add , add , add , add , addContainerListener , addImpl , countComponents , deliverEvent , doLayout , findComponentAt , findComponentAt , getComponent , getComponentAt , getComponentAt , getComponentCount , getComponents , getLayout , insets , invalidate , isAncestorOf , layout , list , list , locate , minimumSize , paintComponents , paramString , preferredSize , print , printComponents , processContainerEvent , processEvent , remove , remove , removeAll , removeContainerListener , setLayout , validate , validateTree
 
Methods inherited from class java.awt.Component
action , add , addComponentListener , addFocusListener , addInputMethodListener , addKeyListener , addMouseListener , addMouseMotionListener , addPropertyChangeListener , bounds , checkImage , checkImage , coalesceEvents , contains , createImage , createImage , disable , disableEvents , dispatchEvent , enable , enable , enableEvents , enableInputMethods , getBackground , getBounds , getColorModel , getComponentOrientation , getCursor , getDropTarget , getFont , getFontMetrics , getForeground , getInputContext , getInputMethodRequests , getLocale , getLocation , getLocationOnScreen , getName , getParent , getPeer , getSize , getToolkit , getTreeLock , gotFocus , handleEvent , hide , imageUpdate , inside , isDisplayable , isEnabled , isLightweight , isShowing , isValid , isVisible , keyDown , keyUp , list , list , list , location , lostFocus , mouseDown , mouseDrag , mouseEnter , mouseExit , mouseMove , mouseUp , move , nextFocus , paintAll , postEvent , prepareImage , prepareImage , printAll , processComponentEvent , processInputMethodEvent , processMouseEvent , remove , removeComponentListener , removeFocusListener , removeInputMethodListener , removeKeyListener , removeMouseListener , removeMouseMotionListener , removePropertyChangeListener , repaint , repaint , repaint , resize , resize , setBackground , setBounds , setBounds , setComponentOrientation , setCursor , setDropTarget , setFont , setForeground , setLocale , setLocation , setLocation , setName , setSize , setSize , show , show , size , toString , transferFocus
 
Methods inherited from class java.lang.Object
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait
 

Constructor Detail

JCheckBox

public JCheckBox()
Creates an initially unselected checkbox button with no text, no icon.

JCheckBox

public JCheckBox(Icon icon)
Creates an initially unselected checkbox with an icon.
Parameters:
icon - the Icon image to display

JCheckBox

public JCheckBox(Icon icon,
                 boolean selected)
Creates a checkbox with an icon and specifies whether or not it is initially selected.
Parameters:
icon - the Icon image to display
selected - a boolean value indicating the initial selection state. If true the checkbox is selected

JCheckBox

public JCheckBox(String text)
Creates an initially unselected checkbox with text.
Parameters:
text - the text of the checkbox.

JCheckBox

public JCheckBox(String text,
                 boolean selected)
Creates a checkbox with text and specifies whether or not it is initially selected.
Parameters:
text - the text of the checkbox.
selected - a boolean value indicating the initial selection state. If true the checkbox is selected

JCheckBox

public JCheckBox(String text,
                 Icon icon)
Creates an initially unselected checkbox with the specified text and icon.
Parameters:
text - the text of the checkbox.
icon - the Icon image to display

JCheckBox

public JCheckBox(String text,
                 Icon icon,
                 boolean selected)
Creates a checkbox with text and icon, and specifies whether or not it is initially selected.
Parameters:
text - the text of the checkbox.
icon - the Icon image to display
selected - a boolean value indicating the initial selection state. If true the checkbox is selected
Method Detail

updateUI

public void updateUI()
Notification from the UIFactory that the L&F has changed.
Overrides:
updateUI in class JToggleButton
See Also:
JComponent.updateUI()

getUIClassID

public String getUIClassID()
Returns a string that specifies the name of the L&F class that renders this component.
Returns:
"CheckBoxUI"
Overrides:
getUIClassID in class JToggleButton
See Also:
JComponent.getUIClassID(), UIDefaults.getUI(com.sun.java.swing.JComponent)

getAccessibleContext

public AccessibleContext getAccessibleContext()
Get the AccessibleContext associated with this JComponent
Specified by:
getAccessibleContext in interface Accessible
Returns:
the AccessibleContext of this JComponent
Overrides:
getAccessibleContext in class JToggleButton

Java Platform 1.2
Beta 4

Submit a bug or feature
Submit comments/suggestions about new javadoc look
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.
This documentation was generated with a post-Beta4 version of Javadoc.