|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.AbstractButton | +--javax.swing.JMenuItem | +--javax.swing.JCheckBoxMenuItem
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. For the keyboard keys used by this component in the standard Look and Feel (L&F) renditions, see the JCheckBoxMenuItem 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 applications running the same version of Swing. A future release of Swing will provide support for long term persistence.
Inner Class Summary | |
protected class |
JCheckBoxMenuItem.AccessibleJCheckBoxMenuItem
This class implements accessibility support for the JCheckBoxMenuItem class. |
Inner classes inherited from class javax.swing.JMenuItem |
JMenuItem.AccessibleJMenuItem |
Inner classes inherited from class javax.swing.AbstractButton |
AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener |
Inner classes inherited from class javax.swing.JComponent |
JComponent.AccessibleJComponent |
Inner classes inherited from class java.awt.Container |
Container.AccessibleAWTContainer |
Inner classes inherited from class java.awt.Component |
Component.AccessibleAWTComponent |
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, NORTH, NORTH_EAST, NORTH_WEST, 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 |
requestFocus()
Override JComponent.requestFocus() to prevent grabbing the focus. |
void |
setState(boolean b)
Sets the selected-state of the item. |
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, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
public JCheckBoxMenuItem()
public JCheckBoxMenuItem(Icon icon)
icon
- the icon of the CheckBoxMenuItem.public JCheckBoxMenuItem(String text)
text
- the text of the CheckBoxMenuItempublic JCheckBoxMenuItem(Action a)
public JCheckBoxMenuItem(String text, Icon icon)
text
- the text of the CheckBoxMenuItemicon
- the icon of the CheckBoxMenuItempublic JCheckBoxMenuItem(String text, boolean b)
text
- the text of the check box menu item.b
- the selected state of the check box menu itempublic JCheckBoxMenuItem(String text, Icon icon, boolean b)
text
- the text of the check box menu itemicon
- the icon of the check box menu itemb
- the selected state of the check box menu itemMethod Detail |
public String getUIClassID()
getUIClassID
in class JMenuItem
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public boolean getState()
public void setState(boolean b)
b
- a boolean value indicating the item's
selected-state, where true=selectedpublic Object[] getSelectedObjects()
getSelectedObjects
in class AbstractButton
public void requestFocus()
JComponent.requestFocus()
to prevent grabbing the focus.requestFocus
in class JComponent
java.awt.Component
FocusEvent
,
Component.addFocusListener(java.awt.event.FocusListener)
,
Component.processFocusEvent(java.awt.event.FocusEvent)
,
Component.isFocusTraversable()
protected String paramString()
null
.paramString
in class JMenuItem
public AccessibleContext getAccessibleContext()
getAccessibleContext
in interface Accessible
getAccessibleContext
in class JMenuItem
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.