javax.swing
类 JMenuItem

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

所有已实现的接口：

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

直接已知子类：

JCheckBoxMenuItem, JMenu, JRadioButtonMenuItem

public class JMenuItem
extends AbstractButton
implements Accessible, MenuElement

菜单中的项的实现。菜单项本质上是位于列表中的按钮。当用户选择“按钮”时，则执行与菜单项关联的操作。JPopupMenu 中包含的 JMenuItem 正好执行该功能。

通过 Action 可以配置菜单，并进行一定程度的控制。对菜单项使用 Action 有许多直接配置菜单项所不及的优点。有关更多信息，请参阅支持 Action 的 Swing 组件，可以在 The Java Tutorial 中的 How to Use Actions 一节找到更多信息。

有关更多文档和示例，请参见 The Java Tutorial 中的 How to Use Menus 一节。

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

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

另请参见：

JPopupMenu, JMenu, JCheckBoxMenuItem, JRadioButtonMenuItem

JMenuItem

public JMenuItem()

创建不带有设置文本或图标的 JMenuItem。

JMenuItem

public JMenuItem(Icon icon)

创建带有指定图标的 JMenuItem。

参数：

icon - JMenuItem 的图标

JMenuItem

public JMenuItem(String text)

创建带有指定文本的 JMenuItem。

参数：

text - JMenuItem 的文本

JMenuItem

public JMenuItem(Action a)

创建从指定的 Action 获取其属性的菜单项。

参数：

a - JMenuItem 的操作

从以下版本开始：

1.3

JMenuItem

public JMenuItem(String text,
                 Icon icon)

创建带有指定文本和图标的 JMenuItem。

参数：

text - JMenuItem 的文本

icon - JMenuItem 的图标

JMenuItem

public JMenuItem(String text,
                 int mnemonic)

创建带有指定文本和键盘助记符的 JMenuItem。

参数：

text - JMenuItem 的文本

mnemonic - JMenuItem 的键盘助记符

setModel

public void setModel(ButtonModel newModel)

设置此按钮表示的模型。

覆盖：

类 AbstractButton 中的 setModel

参数：

newModel - 新的 ButtonModel

另请参见：

AbstractButton.getModel()

init

protected void init(String text,
                    Icon icon)

利用指定文本和图标初始化菜单项。

覆盖：

类 AbstractButton 中的 init

参数：

text - JMenuItem 的文本

icon - JMenuItem 的图标

setUI

public void setUI(MenuItemUI ui)

设置呈现此组件的外观对象。

参数：

ui - JMenuItemUI L&F 对象

另请参见：

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

利用当前外观的值重置 UI 属性。

覆盖：

类 AbstractButton 中的 updateUI

另请参见：

JComponent.updateUI()

getUIClassID

public String getUIClassID()

返回用于构造呈现此组件时使用的 L&F 类名称的后缀。

覆盖：

类 JComponent 中的 getUIClassID

返回：

字符串 "MenuItemUI"

另请参见：

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

setArmed

public void setArmed(boolean b)

将菜单项标识为“调出”。如果鼠标指针在此项上时释放鼠标按钮，则激发菜单的操作事件。如果在其他地方释放鼠标按钮，则不激发事件，而菜单项将缩回。

参数：

b - true 表示调出菜单项以供选择

isArmed

public boolean isArmed()

返回菜单项是否被“调出”。

返回：

如果菜单项为调出状态，可供选择，则返回 true

另请参见：

setArmed(boolean)

setEnabled

public void setEnabled(boolean b)

启用或禁用菜单项。

覆盖：

类 AbstractButton 中的 setEnabled

参数：

b - true 表示启用项

另请参见：

Component.isEnabled(), Component.isLightweight()

setAccelerator

public void setAccelerator(KeyStroke keyStroke)

设置修改键，它能直接调用菜单项的操作侦听器而不必显示菜单的层次结构。UI 负责安装正确的操作。注意，当键入键盘加速器时，不管目前是否显示菜单，它都会运行。

参数：

keyStroke - 将作为加速器的 KeyStroke

getAccelerator

public KeyStroke getAccelerator()

返回作为菜单项的加速器的 KeyStroke。

返回：

标识加速键的 KeyStroke 对象

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)

在此按钮上设置属性以匹配指定 Action 中的属性。有关关于设置了哪些属性的更多信息，请参阅支持 Action 的 Swing 组件。

覆盖：

类 AbstractButton 中的 configurePropertiesFromAction

参数：

a - 从中获取属性的 Action，或为 null

从以下版本开始：

1.3

另请参见：

Action, AbstractButton.setAction(javax.swing.Action)

actionPropertyChanged

protected void actionPropertyChanged(Action action,
                                     String propertyName)

更新按钮的状态以响应相关的操作中的属性更改。从 createActionPropertyChangeListener 返回的 PropertyChangeListener 中调用此方法。子类通常不需要调用此方法。支持其他 Action 属性的子类应该重写此方法以及 configurePropertiesFromAction。

有关此方法设置的属性的列表，请参阅支持 Action 的 Swing 组件处的表。

覆盖：

类 AbstractButton 中的 actionPropertyChanged

参数：

action - 与此按钮关联的 Action

propertyName - 已更改属性的名称

从以下版本开始：

1.6

另请参见：

Action, AbstractButton.configurePropertiesFromAction(javax.swing.Action)

processMouseEvent

public void processMouseEvent(MouseEvent e,
                              MenuElement[] path,
                              MenuSelectionManager manager)

如有必要，通过使用 MenuSelectionManager 的 API 处理从 MenuSelectionManager 转发的鼠标事件并更改菜单选择。

注：不必将事件转发到子组件。此操作可以通过 MenuSelectionManager 自动完成。

指定者：

接口 MenuElement 中的 processMouseEvent

参数：

e - MouseEvent

path - MenuElement 路径数组

manager - MenuSelectionManager

processKeyEvent

public void processKeyEvent(KeyEvent e,
                            MenuElement[] path,
                            MenuSelectionManager manager)

如有必要，通过使用 MenuSelectionManager 的 API 处理从 MenuSelectionManager 转发的键事件并更改菜单选择。

注：不必将事件转发到子组件。此操作可以通过 MenuSelectionManager 自动完成。

指定者：

接口 MenuElement 中的 processKeyEvent

参数：

e - KeyEvent

path - MenuElement 路径数组

manager - MenuSelectionManager

processMenuDragMouseEvent

public void processMenuDragMouseEvent(MenuDragMouseEvent e)

处理菜单中的鼠标拖动。

参数：

e - MenuDragMouseEvent 对象

processMenuKeyEvent

public void processMenuKeyEvent(MenuKeyEvent e)

处理菜单中的快捷键。

参数：

e - MenuKeyEvent 对象

fireMenuDragMouseEntered

protected void fireMenuDragMouseEntered(MenuDragMouseEvent event)

通知所有对此事件类型上的通知感兴趣的已注册侦听器。

参数：

event - MenuMouseDragEvent

另请参见：

EventListenerList

fireMenuDragMouseExited

protected void fireMenuDragMouseExited(MenuDragMouseEvent event)

通知所有对此事件类型上的通知感兴趣的已注册侦听器。

参数：

event - MenuDragMouseEvent

另请参见：

EventListenerList

fireMenuDragMouseDragged

protected void fireMenuDragMouseDragged(MenuDragMouseEvent event)

通知所有对此事件类型上的通知感兴趣的已注册侦听器。

参数：

event - MenuDragMouseEvent

另请参见：

EventListenerList

fireMenuDragMouseReleased

protected void fireMenuDragMouseReleased(MenuDragMouseEvent event)

通知所有对此事件类型上的通知感兴趣的已注册侦听器。

参数：

event - MenuDragMouseEvent

另请参见：

EventListenerList

fireMenuKeyPressed

protected void fireMenuKeyPressed(MenuKeyEvent event)

通知所有对此事件类型上的通知感兴趣的已注册侦听器。

参数：

event - MenuKeyEvent

另请参见：

EventListenerList

fireMenuKeyReleased

protected void fireMenuKeyReleased(MenuKeyEvent event)

通知所有对此事件类型上的通知感兴趣的已注册侦听器。

参数：

event - MenuKeyEvent

另请参见：

EventListenerList

fireMenuKeyTyped

protected void fireMenuKeyTyped(MenuKeyEvent event)

通知所有对此事件类型上的通知感兴趣的已注册侦听器。

参数：

event - MenuKeyEvent

另请参见：

EventListenerList

menuSelectionChanged

public void menuSelectionChanged(boolean isIncluded)

当选择或取消选择 MenuElement 时由 MenuSelectionManager 调用。

指定者：

接口 MenuElement 中的 menuSelectionChanged

参数：

isIncluded - 如果此菜单项位于发生更改的菜单路径部分，则为 true；如果此菜单项位于发生更改的菜单路径部分，但该路径的这一特殊部分与更改前相同，则为 false

另请参见：

MenuSelectionManager.setSelectedPath(MenuElement[])

getSubElements

public MenuElement[] getSubElements()

此方法返回包含此菜单组件的子菜单组件的数组。

指定者：

接口 MenuElement 中的 getSubElements

返回：

MenuElement 的数组

getComponent

public Component getComponent()

返回用于绘制此对象的 java.awt.Component。返回的组件用于转换事件并检测事件是否位于菜单组件中。

指定者：

接口 MenuElement 中的 getComponent

返回：

绘制此菜单项的 Component

addMenuDragMouseListener

public void addMenuDragMouseListener(MenuDragMouseListener l)

将 MenuDragMouseListener 添加到菜单项。

参数：

l - 要添加的 MenuDragMouseListener

removeMenuDragMouseListener

public void removeMenuDragMouseListener(MenuDragMouseListener l)

从菜单项中移除 MenuDragMouseListener。

参数：

l - 要移除的 MenuDragMouseListener

getMenuDragMouseListeners

public MenuDragMouseListener[] getMenuDragMouseListeners()

返回利用 addMenuDragMouseListener() 添加到此 JMenuItem 的所有 MenuDragMouseListener 组成的数组。

返回：

添加的所有 MenuDragMouseListener，如果没有添加侦听器，则返回一个空数组

从以下版本开始：

1.4

addMenuKeyListener

public void addMenuKeyListener(MenuKeyListener l)

将 MenuKeyListener 添加到菜单项。

参数：

l - 要添加的 MenuKeyListener

removeMenuKeyListener

public void removeMenuKeyListener(MenuKeyListener l)

从菜单项中移除 MenuKeyListener。

参数：

l - 要移除的 MenuKeyListener

getMenuKeyListeners

public MenuKeyListener[] getMenuKeyListeners()

返回利用 addMenuKeyListener() 添加到此 JMenuItem 的所有 MenuKeyListener 的数组。

返回：

添加的所有 MenuKeyListener，如果没有添加侦听器，则返回一个空数组

从以下版本开始：

1.4

paramString

protected String paramString()

返回此 JMenuItem 的字符串表示形式。此方法仅在进行调试的时候使用，对于各个实现，所返回字符串的内容和格式可能有所不同。返回的字符串可能为空，但不可能为 null。

覆盖：

类 AbstractButton 中的 paramString

返回：

此 JMenuItem 的字符串表示形式

getAccessibleContext

public AccessibleContext getAccessibleContext()

返回与此 JMenuItem 关联的 AccessibleContext。对于 JMenuItem，AccessibleContext 采用的是 AccessibleJMenuItem 的形式。必要时创建一个新的 AccessibleJMenuItme 实例。

指定者：

接口 Accessible 中的 getAccessibleContext

覆盖：

类 JComponent 中的 getAccessibleContext

返回：

充当此 JMenuItem 的 AccessibleContext 的 AccessibleJMenuItem

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。