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

可以选择或取消选择的菜单项。 如果选择，菜单项通常会在其旁边显示一个复选标记。 如果未选择或取消选择，则菜单项将不显示复选标记。 像常规菜单项一样，复选框菜单项可以具有与其关联的文本或图形图标，或两者兼有。

无论是isSelected / setSelected或getState / setState可以用来确定/指定菜单项的选择状态。 优选的方法是isSelected和setSelected ，它适用于所有菜单和按钮。 存在与其他组件集兼容的getState和setState方法。

菜单项可以配置，以及一定程度的控制，通过Action秒。 使用带有菜单项的Action除了直接配置菜单项之外还有很多好处。 请参阅Swing Components Supporting Action了解更多详情，您可以找到更多信息How to Use Actions ，在Java教程的部分。

有关使用复选框菜单项的更多信息和示例，请参阅Java教程中的 How to Use Menus 。

警告： Swing不是线程安全的。 欲了解更多信息，请参阅Swing's Threading Policy 。

警告：此类的序列化对象与将来的Swing版本不兼容。 当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。 从1.4开始，对所有JavaBeans的长期存储的支持已经添加到java.beans包中。 请参阅XMLEncoder 。

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	JCheckBoxMenuItem.AccessibleJCheckBoxMenuItem 这个类实现了可访问性支持 JCheckBoxMenuItem类。

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.BaselineResizeBehavior, 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

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

accessibleContext, 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 and Description
JCheckBoxMenuItem() 创建一个没有设置文本或图标的初始未选择的复选框菜单项。
JCheckBoxMenuItem(Action a) 创建一个菜单项，其属性取自提供的操作。
JCheckBoxMenuItem(Icon icon) 创建一个带有图标的最初未选中的复选框菜单项。
JCheckBoxMenuItem(String text) 用文本创建一个初始未选择的复选框菜单项。
JCheckBoxMenuItem(String text, boolean b) 创建具有指定文本和选择状态的复选框菜单项。
JCheckBoxMenuItem(String text, Icon icon) 使用指定的文本和图标创建最初未选择的复选框菜单项。
JCheckBoxMenuItem(String text, Icon icon, boolean b) 创建带有指定文本，图标和选择状态的复选框菜单项。

方法摘要

Modifier and Type	Method and Description
AccessibleContext	getAccessibleContext() 获取与此JCheckBoxMenuItem关联的AccessibleContext。
Object[]	getSelectedObjects() 返回一个包含复选框菜单项标签的数组（长度1），如果未选中该复选框，则返回null。
boolean	getState() 返回项目的选择状态。
String	getUIClassID() 返回呈现此组件的L＆F类的名称。
protected String	paramString() 返回此JCheckBoxMenuItem的字符串表示形式。
void	setState(boolean b) 设置项目的选择状态。

Methods inherited from class javax.swing.JMenuItem

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

Methods inherited from class javax.swing.AbstractButton

addActionListener, addChangeListener, addImpl, addItemListener, checkHorizontalKey, checkVerticalKey, 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, getText, getUI, getVerticalAlignment, getVerticalTextPosition, imageUpdate, isBorderPainted, isContentAreaFilled, isFocusPainted, isRolloverEnabled, isSelected, paintBorder, removeActionListener, removeChangeListener, removeItemListener, removeNotify, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setFocusPainted, setHideActionText, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setIconTextGap, setLabel, setLayout, setMargin, setMnemonic, setMnemonic, setMultiClickThreshhold, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, setText, setUI, setVerticalAlignment, setVerticalTextPosition

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

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

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

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

JCheckBoxMenuItem

public JCheckBoxMenuItem()

创建一个没有设置文本或图标的初始未选择的复选框菜单项。

JCheckBoxMenuItem

public JCheckBoxMenuItem(Icon icon)

创建一个带有图标的最初未选中的复选框菜单项。

参数

icon - icon的图标。

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text)

用文本创建一个初始未选择的复选框菜单项。

参数

text - text的文本

JCheckBoxMenuItem

public JCheckBoxMenuItem(Action a)

创建一个菜单项，其属性取自提供的操作。

从以下版本开始：

1.3

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text,
                         Icon icon)

使用指定的文本和图标创建最初未选择的复选框菜单项。

参数

text - text的文本

icon - icon的图标

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text,
                         boolean b)

创建具有指定文本和选择状态的复选框菜单项。

参数

text - 复选框菜单项的文本。

b - 复选框菜单项的选中状态

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text,
                         Icon icon,
                         boolean b)

创建带有指定文本，图标和选择状态的复选框菜单项。

参数

text - 复选框菜单项的文本

icon - 复选框菜单项的图标

b - 复选框菜单项的选中状态

方法详细信息

getUIClassID

public String getUIClassID()

返回呈现此组件的L＆F类的名称。

重写：

getUIClassID在 JMenuItem

结果

“CheckBoxMenuItemUI”

另请参见：

JComponent.getUIClassID() ， UIDefaults.getUI(javax.swing.JComponent)

getState

public boolean getState()

返回项目的选择状态。 此方法仅适用于AWT兼容性。 新代码应该使用isSelected（）。

结果

如果选择项目，则为true

setState

public void setState(boolean b)

设置项目的选择状态。 此方法仅适用于AWT兼容性。 新代码应该使用setSelected（）。

参数

b - 一个布尔值，指示项目的选择状态，其中true =选择

getSelectedObjects

public Object[] getSelectedObjects()

返回一个包含复选框菜单项标签的数组（长度1），如果未选中该复选框，则返回null。

Specified by:

getSelectedObjects在界面 ItemSelectable

重写：

getSelectedObjects在 AbstractButton

结果

一个包含一个对象的数组 - 菜单项的文本 - 如果该项被选中; 否则为空

paramString

protected String paramString()

返回此JCheckBoxMenuItem的字符串表示形式。 该方法仅用于调试目的，并且返回的字符串的内容和格式可能因实现而异。 返回的字符串可能为空，但可能不是null 。

重写：

paramString在 JMenuItem

结果

这个JCheckBoxMenuItem的字符串表示形式。

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此JCheckBoxMenuItem关联的AccessibleContext。 对于JCheckBoxMenuItems，AccessibleContext采用AccessibleJCheckBoxMenuItem的形式。 如有必要，将创建一个新的AccessibleJCheckBoxMenuItem实例。

Specified by:

getAccessibleContext在界面 Accessible

重写：

getAccessibleContext在 JMenuItem

结果

AccessibleJCheckBoxMenuItem用作AccessibleJCheckBoxMenuItem的AccessibleContext