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到已经注册了对该菜单项生成的动作事件感兴趣的任何ActionListener对象。

请注意， Menu子类Menu此行为，并且不会将任何事件发送到框架，直到选择其中一个子项目为止。

另请参见：

Serialized Form

Nested Class Summary

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

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

构造方法摘要

构造方法
Constructor and Description
`MenuItem()` 构造一个带有空标签的新菜单项，而不需要键盘快捷方式。
`MenuItem(String label)` 使用指定的标签构建一个新的MenuItem，而不需要键盘快捷方式。
`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()` 获取与此MenuItem关联的AccessibleContext。
`String`	`getActionCommand()` 获取此菜单项触发的操作事件的命令名称。
`ActionListener[]`	`getActionListeners()` 返回在此菜单项上注册的所有动作侦听器的数组。
`String`	`getLabel()` 获取此菜单项的标签。
`<T extends EventListener> T[]`	`getListeners(类<T> listenerType)` 返回当前注册为 `FooListener`的所有对象的数组，此 `MenuItem` 。
`MenuShortcut`	`getShortcut()` 获取与 `MenuShortcut`对象，
`boolean`	`isEnabled()` 检查此菜单项是否启用。
`String`	`paramString()` 返回表示此 `MenuItem`的状态的字符串。
`protected void`	`processActionEvent(ActionEvent e)` 通过将这些事件发送到任何已注册的 `ActionListener`对象来处理 `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

- 构造方法详细信息
  - MenuItem
```
public MenuItem()
         throws HeadlessException
```
    构造一个带有空标签的新菜单项，而不需要键盘快捷方式。
    
    异常
    
    HeadlessException - 如果GraphicsEnvironment.isHeadless（）返回true。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - MenuItem
```
public MenuItem(String label)
         throws HeadlessException
```
    使用指定的标签构建一个新的MenuItem，而不需要键盘快捷方式。请注意，在标签中使用“ - ”保留以指示菜单项之间的分隔符。默认情况下，除分隔符之外的所有菜单项都被启用。
    
    参数
    
    label - 此菜单项的标签。
    
    异常
    
    HeadlessException - 如果GraphicsEnvironment.isHeadless（）返回true。
    
    从以下版本开始：
    
    JDK1.0
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - MenuItem
```
public MenuItem(String label,
                MenuShortcut s)
         throws HeadlessException
```
    创建一个带有相关键盘快捷方式的菜单项。请注意，在标签中使用“ - ”保留以指示菜单项之间的分隔符。默认情况下，除分隔符之外的所有菜单项都被启用。
    
    参数
    
    label - 此菜单项的标签。
    
    s - 与 MenuShortcut单项相关的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 - 与此菜 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)
```
    设置此菜单项触发的操作事件的命令名称。
    默认情况下，action命令设置为菜单项的标签。
    
    参数
    
    command - 要为此菜单项设置的动作命令。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    getActionCommand()
  - getActionCommand
```
public String getActionCommand()
```
    获取此菜单项触发的操作事件的命令名称。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    setActionCommand(java.lang.String)
  - addActionListener
```
public void addActionListener(ActionListener l)
```
    添加指定的动作侦听器以从该菜单项接收动作事件。如果l为空，则不会抛出任何异常，也不会执行任何操作。
    请参阅AWT Threading Issues有关AWT的线程模型的细节。
    
    参数
    
    l - 动作侦听器。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    removeActionListener(java.awt.event.ActionListener) ， getActionListeners() ， ActionEvent ， ActionListener
  - removeActionListener
```
public void removeActionListener(ActionListener l)
```
    删除指定的动作监听器，使其不再从此菜单项接收动作事件。如果l为空，则不会抛出任何异常，也不会执行任何操作。
    请参阅AWT Threading Issues有关AWT的线程模型的细节。
    
    参数
    
    l - 动作侦听器。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    addActionListener(java.awt.event.ActionListener) ， getActionListeners() ， ActionEvent ， ActionListener
  - getActionListeners
```
public ActionListener[] getActionListeners()
```
    返回在此菜单项上注册的所有动作侦听器的数组。
    
    结果
    
    所有此菜单项的 ActionListener s或一个空数组，如果没有动作侦听器当前注册
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    addActionListener(java.awt.event.ActionListener) ， removeActionListener(java.awt.event.ActionListener) ， ActionEvent ， ActionListener
  - getListeners
```
public <T extends EventListener> T[] getListeners(类<T> listenerType)
```
    返回当前注册为FooListener的所有对象的数组，此MenuItem 。 FooListener使用addFooListener 。
    您可以使用类文字指定listenerType参数，如FooListener.class 。例如，您可以使用以下代码查询MenuItem m其操作侦听器：
```
  ActionListener[] als = (ActionListener[])(m.getListeners(ActionListener.class)); 
```
    如果没有这样的侦听器存在，这个方法返回一个空数组。
    参数
    
    listenerType - 所请求的听众的类型; 此参数应指定从java.util.EventListener下降的java.util.EventListener
    
    结果
    
    在此菜 FooListener上注册为 FooListener的所有对象的数组，如果没有添加此类侦听器，则为空数组
    
    异常
    
    ClassCastException - 如果 listenerType没有指定实现java.util.EventListener的类或 java.util.EventListener
    
    从以下版本开始：
    
    1.3
    
    另请参见：
    
    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()
```
    获取与此MenuItem关联的AccessibleContext。对于菜单项，AccessibleContext采用AccessibleAWTMenuItem的形式。如有必要，将创建一个新的AccessibleAWTMenuItem实例。
    
    Specified by:
    
    getAccessibleContext在接口 Accessible
    
    重写：
    
    getAccessibleContext在类别 MenuComponent
    
    结果
    
    一个AccessibleAWTMenuItem，用作此MenuItem的AccessibleContext
    
    从以下版本开始：
    
    1.3

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

构造方法详细信息

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