javax.swing
Class JCheckBoxMenuItem

java.lang.Object   
  java.awt.Component   
      java.awt.Container   
          javax.swing.JComponent   
              javax.swing.AbstractButton   
                  javax.swing.JMenuItem   
                      javax.swing.JCheckBoxMenuItem

All Implemented Interfaces:

ImageObserver , ItemSelectable , MenuContainer , Serializable , Accessible , MenuElement , SwingConstants

public class JCheckBoxMenuItem
extends JMenuItem   
implements SwingConstants   , Accessible   

A menu item that can be selected or deselected. If selected, the menu item typically appears with a checkmark next to it. If unselected or deselected, the menu item appears without a checkmark. Like a regular menu item, a check box menu item can have either text or a graphic icon associated with it, or both.

Either isSelected/setSelected or getState/setState can be used to determine/specify the menu item's selection state. The preferred methods are isSelected and setSelected, which work for all menus and buttons. The getState and setState methods exist for compatibility with other component sets.

For further information and examples of using check box menu items, see How to Use Menus, a section in The Java Tutorial.

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 applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeans^TM has been added to the java.beans package. Please see XMLEncoder .

See Also:

Serialized Form

Nested Class Summary

protected class

JCheckBoxMenuItem.AccessibleJCheckBoxMenuItem This class implements accessibility support for the JCheckBoxMenuItem class.

Nested classes/interfaces inherited from class javax.swing.JMenuItem

JMenuItem.AccessibleJMenuItem

Nested classes/interfaces inherited from class javax.swing.AbstractButton

AbstractButton.AccessibleAbstractButton , AbstractButton.ButtonChangeListener

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent , Component.BltBufferStrategy , Component.FlipBufferStrategy

Field Summary

Fields inherited from class 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

Fields inherited from class javax.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

Fields inherited from interface 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

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

JCheckBoxMenuItem ()
Creates an initially unselected check box menu item with no set text or icon.

JCheckBoxMenuItem (Action a)
Creates a menu item whose properties are taken from the Action supplied.

JCheckBoxMenuItem (Icon icon)
Creates an initially unselected check box menu item with an icon.

JCheckBoxMenuItem (String text)
Creates an initially unselected check box menu item with text.

JCheckBoxMenuItem (String text, boolean b)
Creates a check box menu item with the specified text and selection state.

JCheckBoxMenuItem (String text, Icon icon)
Creates an initially unselected check box menu item with the specified text and icon.

JCheckBoxMenuItem (String text, Icon icon, boolean b)
Creates a check box menu item with the specified text, icon, and selection state.

Method Summary

AccessibleContext	getAccessibleContext () Gets the AccessibleContext associated with this JCheckBoxMenuItem.
Object []	getSelectedObjects () Returns an array (length 1) containing the check box menu item label or null if the check box is not selected.
boolean	getState () Returns the selected-state of the item.
String	getUIClassID () Returns the name of the L&F class that renders this component.
protected String	paramString () Returns a string representation of this JCheckBoxMenuItem.
void	setState (boolean b) Sets the selected-state of the item.

Methods inherited from class javax.swing.JMenuItem

addMenuDragMouseListener , addMenuKeyListener , configurePropertiesFromAction , createActionPropertyChangeListener , fireMenuDragMouseDragged , fireMenuDragMouseEntered , fireMenuDragMouseExited , fireMenuDragMouseReleased , fireMenuKeyPressed , fireMenuKeyReleased , fireMenuKeyTyped , getAccelerator , getComponent , getMenuDragMouseListeners , getMenuKeyListeners , getSubElements , init , isArmed , menuSelectionChanged , processKeyEvent , processMenuDragMouseEvent , processMenuKeyEvent , processMouseEvent , removeMenuDragMouseListener , removeMenuKeyListener , setAccelerator , setArmed , setEnabled , setUI , updateUI

Methods inherited from class javax.swing.AbstractButton

addActionListener , addChangeListener , addImpl