MenuItem (Java Platform SE 8 )

java.lang.Object
- java.awt.MenuComponent
- - java.awt.MenuItem

All Implemented Interfaces:

Serializable， Accessible

已知直接子类：

CheckboxMenuItem， Menu
```
public class MenuItem
extends MenuComponent
implements Accessible
```
在菜单中的所有项目必须属于类 MenuItem，或它的一个子类。
默认MenuItem对象体现了一个简单的标记菜单项。

这张图片的一个菜单栏显示五个菜单项：
前面两项简单的菜单项，标记"Basic"和"Simple"。以下这两项是一个分隔符，这本身就是一个菜单项，与标签"-"创建。接下来是CheckboxMenuItem标记"Check"实例。最后的菜单项的子菜单和子菜单"More Examples"标记，这是Menu实例。

当菜单项被选中，AWT发送一个动作事件到菜单项。因为事件是ActionEvent实例的方法，processEvent检测事件并传递给processActionEvent。后一种方法是将事件的已注册事件的行动菜单项产生兴趣的任何ActionListener对象。

注意，子类Menu重写此行为和不发送任何事件框架的一项选择之前。

另请参见：

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected class`	`MenuItem.AccessibleAWTMenuItem` 用于提供辅助支持内部类的默认菜单项。

Nested classes/interfaces inherited from class java.awt.MenuComponent
MenuComponent.AccessibleAWTMenuComponent

构造方法摘要

构造方法
Constructor and Description
`MenuItem()` 构建了一个新的菜单项和一个空的标签，没有键盘快捷键。
`MenuItem(String label)` 构建与指定的标签，没有键盘快捷键的一个新的菜单项。
`MenuItem(String label, MenuShortcut s)` 用相关的键盘快捷键创建一个菜单项。

方法摘要

所有方法接口方法具体的方法弃用的方法
Modifier and Type	Method and Description
`void`	`addActionListener(ActionListener l)` 添加指定的操作侦听器从该菜单项接收操作事件。
`void`	`addNotify()` 创建菜单项的对等点。
`void`	`deleteShortcut()` 删除与此相关的任何 `MenuShortcut`对象菜单项。
`void`	`disable()` 过时的。作为JDK 1.1版本，取而代之的`setEnabled(boolean)`。
`protected void`	`disableEvents(long eventsToDisable)` 在指定的事件掩码参数定义的事件中禁用此菜单项的事件传递。
`void`	`enable()` 过时的。作为JDK 1.1版本，取而代之的`setEnabled(boolean)`。
`void`	`enable(boolean b)` 过时的。作为JDK 1.1版本，取而代之的`setEnabled(boolean)`。
`protected void`	`enableEvents(long eventsToEnable)` 使用指定的事件掩码参数来定义事件传递到此菜单项中的事件
`AccessibleContext`	`getAccessibleContext()` 获取与该菜单项关联的accessiblecontext。
`String`	`getActionCommand()` 获取由此菜单项发射的动作事件的命令名称。
`ActionListener[]`	`getActionListeners()` 返回在这个菜单项上注册的所有操作侦听器的数组。
`String`	`getLabel()` 获取此菜单项的标签。
`<T extends EventListener> T[]`	`getListeners(类<T> listenerType)` 返回对象的当前注册为 `FooListener`s在这 `MenuItem`数组。
`MenuShortcut`	`getShortcut()` 得到这个菜单项关联的 `MenuShortcut`对象，
`boolean`	`isEnabled()` 检查此菜单项是否已启用。
`String`	`paramString()` 返回一个字符串，表示此 `MenuItem`状态。
`protected void`	`processActionEvent(ActionEvent e)` 在此菜单项发生的过程动作事件，派遣他们到任何注册 `ActionListener`对象。
`protected void`	`processEvent(AWTEvent e)` 在此菜单项上处理事件。
`void`	`removeActionListener(ActionListener l)` 移除指定的动作侦听器，所以它不再从该菜单项接收动作事件。
`void`	`setActionCommand(String command)` 设置由此菜单项发射的动作事件的命令名。
`void`	`setEnabled(boolean b)` 设置是否可以选择此菜单项。
`void`	`setLabel(String label)` 将此菜单项的标签设置为指定的标签。
`void`	`setShortcut(MenuShortcut s)` 设置此菜单项关联的 `MenuShortcut`对象。

Methods inherited from class java.awt.MenuComponent
dispatchEvent, getFont, getName, getParent, getPeer, getTreeLock, postEvent, removeNotify, setFont, setName, toString

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - MenuItem
```
public MenuItem()
         throws HeadlessException
```
    构建了一个新的菜单项和一个空的标签，没有键盘快捷键。
    
    异常
    
    HeadlessException -如果graphicsenvironment isheadless()返回true。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - MenuItem
```
public MenuItem(String label)
         throws HeadlessException
```
    构建与指定的标签，没有键盘快捷键的一个新的菜单项。请注意，在标签中使用“-”表示在菜单项之间的分隔符。默认情况下，除了分隔符以外的所有菜单项都已启用。
    
    参数
    
    label -此菜单项的标签。
    
    异常
    
    HeadlessException -如果graphicsenvironment isheadless()返回true。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - MenuItem
```
public MenuItem(String label,
                MenuShortcut s)
         throws HeadlessException
```
    用相关的键盘快捷键创建一个菜单项。请注意，在标签中使用“-”表示在菜单项之间的分隔符。默认情况下，除了分隔符以外的所有菜单项都已启用。
    
    参数
    
    label -此菜单项的标签。
    
    s - MenuShortcut这个菜单项关联的实例。
    
    异常
    
    HeadlessException -如果graphicsenvironment isheadless()返回true。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
- 方法详细信息
  - addNotify
```
public void addNotify()
```
    创建菜单项的对等点。的对等允许我们修改菜单项的外观，而不改变其功能。
  - getLabel
```
public String getLabel()
```
    获取此菜单项的标签。
    
    结果
    
    此菜单项的标签，或 null如果该菜单项没有标签。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    setLabel(java.lang.String)
  - setLabel
```
public void setLabel(String label)
```
    将此菜单项的标签设置为指定的标签。
    
    参数
    
    label -新的标签，无标签或 null。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    getLabel()
  - isEnabled
```
public boolean isEnabled()
```
    检查此菜单项是否已启用。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    setEnabled(boolean)
  - setEnabled
```
public void setEnabled(boolean b)
```
    设置是否可以选择此菜单项。
    
    参数
    
    b -如果 true，使该菜单项；如果 false，禁用它。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    isEnabled()
  - enable
```
@Deprecated
public void enable()
```
    过时的。作为JDK 1.1版本，取而代之的setEnabled(boolean)。
  - enable
```
@Deprecated
public void enable(boolean b)
```
    过时的。作为JDK 1.1版本，取而代之的setEnabled(boolean)。
  - disable
```
@Deprecated
public void disable()
```
    过时的。作为JDK 1.1版本，取而代之的setEnabled(boolean)。
  - getShortcut
```
public MenuShortcut getShortcut()
```
    得到这个菜单项关联的 MenuShortcut对象，
    
    结果
    
    这个菜单项关联的菜单快捷方式，或 null如果没有被指定。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    setShortcut(java.awt.MenuShortcut)
  - setShortcut
```
public void setShortcut(MenuShortcut s)
```
    设置此菜单项关联的 MenuShortcut对象。如果已与此菜单项关联的菜单快捷方式，则替换它。
    
    参数
    
    s -与此菜单项关联的菜单快捷方式。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    getShortcut()
  - deleteShortcut
```
public void deleteShortcut()
```
    删除与此相关的任何 MenuShortcut对象菜单项。
    
    从以下版本开始：
    
    JDK1.1
  - enableEvents
```
protected final void enableEvents(long eventsToEnable)
```
    使事件交付该菜单项的事件是由指定的事件掩码参数
    从事件类型是自动启用当听众，类型添加到菜单项，这种方法只需要调用子类的MenuItem渴望拥有指定的事件类型传递给processEvent无论听众是注册。
    定义
    
    参数
    
    eventsToEnable的事件掩码定义的事件类型
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    processEvent(java.awt.AWTEvent)， disableEvents(long)， Component.enableEvents(long)
  - disableEvents
```
protected final void disableEvents(long eventsToDisable)
```
    在指定的事件掩码参数定义的事件中禁用此菜单项的事件传递。
    
    参数
    
    eventsToDisable的事件掩码定义的事件类型
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    processEvent(java.awt.AWTEvent)， enableEvents(long)， Component.disableEvents(long)
  - setActionCommand
```
public void setActionCommand(String command)
```
    设置由此菜单项发射的动作事件的命令名。
    默认情况下，操作命令将设置为菜单项的标签。
    
    参数
    
    command要设置该菜单项的命令。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    getActionCommand()
  - getActionCommand
```
public String getActionCommand()
```
    获取由此菜单项发射的动作事件的命令名称。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    setActionCommand(java.lang.String)
  - addActionListener
```
public void addActionListener(ActionListener l)
```
    添加指定的操作侦听器从该菜单项接收操作事件。如果L为空，则不会引发异常，并没有执行任何动作。
    指对AWT的线程模型的细节AWT Threading Issues。
    
    参数
    
    l的监听行动。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    removeActionListener(java.awt.event.ActionListener)， getActionListeners()， ActionEvent， ActionListener
  - removeActionListener
```
public void removeActionListener(ActionListener l)
```
    移除指定的动作侦听器，所以它不再从该菜单项接收动作事件。如果L为空，则不会引发异常，并没有执行任何动作。
    指对AWT的线程模型的细节AWT Threading Issues。
    
    参数
    
    l的监听行动。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    addActionListener(java.awt.event.ActionListener)， getActionListeners()， ActionEvent， ActionListener
  - getActionListeners
```
public ActionListener[] getActionListeners()
```
    返回在这个菜单项上注册的所有操作侦听器的数组。
    
    结果
    
    所有这些菜单项的 ActionListeners或空数组如果没有行动的听众正在注册
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    addActionListener(java.awt.event.ActionListener)， removeActionListener(java.awt.event.ActionListener)， ActionEvent， ActionListener
  - getListeners
```
public <T extends EventListener> T[] getListeners(类<T> listenerType)
```
    返回对象的当前注册为 FooListeners在这 MenuItem数组。 FooListeners使用 addFooListener方法注册。如果没有这样
    您可以指定一个类的listenerType字面的说法，如FooListener.class。例如，你可以查询其监听行动与下面的代码MenuItem m：
```
ALS功能[ ] =（action [ ]）（m.getlisteners（action。类））；
```
    听众的存在，此方法将返回空数组。
    参数
    
    listenerType -听众的类型要求；这个参数应该指定一个接口，从 java.util.EventListener
    
    结果
    
    所有对象注册为该菜单项 FooListeners数组，或一个空数组如果没有这样的听众已添加
    
    异常
    
    ClassCastException -如果 listenerType不指定一个类或接口实现 java.util.EventListener
    
    从以下版本开始：
    
    一点三
    
    另请参见：
    
    getActionListeners()
  - processEvent
```
protected void processEvent(AWTEvent e)
```
    在此菜单项上处理事件。如果事件是 ActionEvent实例，它调用 processActionEvent， MenuItem定义的另一种方法。
    目前，菜单项只支持动作事件。
    
    注意，如果参数是null行为是不可能导致异常。
    
    重写：
    
    processEvent 方法重写，继承类 MenuComponent
    
    参数
    
    e -事件
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    processActionEvent(java.awt.event.ActionEvent)
  - processActionEvent
```
protected void processActionEvent(ActionEvent e)
```
    在此菜单项发生的过程动作事件，派遣他们到任何注册 ActionListener对象。此方法不被调用，除非此组件启用了动作事件。动作事件启用时，发生以下情况之一：
    - 一个ActionListener对象是通过addActionListener注册。
    - 动作事件能够通过enableEvents。
    注意，如果参数是null行为是不可能导致异常。
    参数
    
    e -动作事件
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    ActionEvent， ActionListener， enableEvents(long)
  - paramString
```
public String paramString()
```
    返回一个字符串，表示此 MenuItem状态。这种方法的目的是用于调试目的，其含量和返回的字符串格式不同的实现可能会有所不同。返回的字符串是空的但可能不 null。
    
    重写：
    
    paramString 方法重写，继承类 MenuComponent
    
    结果
    
    此菜单项的参数字符串
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    获取与该菜单项关联的accessiblecontext。为菜单项的accessiblecontext以一个accessibleawtmenuitem形式。一个新的accessibleawtmenuitem实例被创建时。
    
    Specified by:
    
    getAccessibleContext 接口 Accessible
    
    重写：
    
    getAccessibleContext 方法重写，继承类 MenuComponent
    
    结果
    
    一个accessibleawtmenuitem作为该菜单项的accessiblecontext
    
    从以下版本开始：
    
    一点三

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class MenuItem

Nested Class Summary

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

构造方法摘要

方法摘要

Methods inherited from class java.awt.MenuComponent

Methods inherited from class java.lang.Object

Constructor Detail

MenuItem

MenuItem

MenuItem

方法详细信息

addNotify

getLabel

setLabel

isEnabled

setEnabled

enable

enable

disable

getShortcut

setShortcut

deleteShortcut

enableEvents

disableEvents

setActionCommand

getActionCommand

addActionListener

removeActionListener

getActionListeners

getListeners

processEvent

processActionEvent

paramString

getAccessibleContext