java.awt
类 Menu

java.lang.Object
  java.awt.MenuComponent
      java.awt.MenuItem
          java.awt.Menu

所有已实现的接口：

MenuContainer, Serializable, Accessible

直接已知子类：

PopupMenu

public class Menu
extends MenuItem
implements MenuContainer, Accessible

Menu 对象是从菜单栏部署的下拉式菜单组件。

菜单可以是任意分离式 菜单。可以打开分离式菜单，并从其父菜单栏或菜单中拖开。释放鼠标按钮之后，它仍然在屏幕上。分离菜单的机制与平台有关，因为分离式菜单的外观由其同位体确定。对于不支持分离式菜单的平台，分离属性会被忽略。

菜单中的每一项都必须属于 MenuItem 类。它可以是 MenuItem 的一个实例、子菜单（Menu 的一个实例）、或复选框（CheckboxMenuItem 的一个实例）。

从以下版本开始：

JDK1.0

另请参见：

MenuItem, CheckboxMenuItem, 序列化表格

Menu

public Menu()
     throws HeadlessException

构造具有空标签的新菜单。此菜单不是分离式菜单。

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

从以下版本开始：

JDK1.1

另请参见：

GraphicsEnvironment.isHeadless()

Menu

public Menu(String label)
     throws HeadlessException

构造具有指定标签的新菜单。此菜单不是分离式菜单。

参数：

label - 菜单栏或其他菜单（此菜单是其子菜单）中菜单的标签。

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另请参见：

GraphicsEnvironment.isHeadless()

Menu

public Menu(String label,
            boolean tearOff)
     throws HeadlessException

构造具有指定标签的新菜单，指示该菜单是否可以分离。

可能并非 AWT 的所有实现都支持分离功能。如果特定的实现不支持分离式菜单，则此值会被默认忽略。

参数：

label - 菜单栏或其他菜单（此菜单是其子菜单）中菜单的标签。

tearOff - 如果为 true，则该菜单为分离式菜单。

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

从以下版本开始：

JDK1.0.

另请参见：

GraphicsEnvironment.isHeadless()

addNotify

public void addNotify()

创建该菜单的同位体。该同位体允许我们修改该菜单的外观，而不更改其功能。

覆盖：

类 MenuItem 中的 addNotify

removeNotify

public void removeNotify()

移除该菜单的同位体。该同位体允许我们修改该菜单的外观，而不更改其功能。

覆盖：

类 MenuComponent 中的 removeNotify

isTearOff

public boolean isTearOff()

指示此菜单是否为分离式菜单。

AWT 的所有实现都不支持分离功能。如果特定的实现不支持分离式菜单，则此值会被默认忽略。

返回：

如果这是一个分离式菜单，则返回 true；否则返回 false。

getItemCount

public int getItemCount()

获取此菜单中的项数。

返回：

此菜单中的项数。

从以下版本开始：

JDK1.1

countItems

@Deprecated
public int countItems()

已过时。 从 JDK version 1.1 开始，已由 getItemCount() 取代。

getItem

public MenuItem getItem(int index)

获取此菜单的指定索引处的项。

参数：

index - 要返回的项的位置。

返回：

指定索引处的项。

add

public MenuItem add(MenuItem mi)

将指定的菜单项添加到此菜单。如果该菜单项为另一个菜单的一部分，则从该菜单移除它。

参数：

mi - 要添加的菜单项

返回：

已添加的菜单项

另请参见：

insert(java.lang.String, int), insert(java.awt.MenuItem, int)

add

public void add(String label)

将带有指定标签的项添加到此菜单。

参数：

label - 该项上的文本

另请参见：

insert(java.lang.String, int), insert(java.awt.MenuItem, int)

insert

public void insert(MenuItem menuitem,
                   int index)

将菜单项插入到此菜单的指定位置。

参数：

menuitem - 要插入的菜单项。

index - 菜单项应插入的位置。

抛出：

IllegalArgumentException - 如果 index 的值小于零

从以下版本开始：

JDK1.1

另请参见：

add(java.lang.String), add(java.awt.MenuItem)

insert

public void insert(String label,
                   int index)

将带有指定标签的菜单项插入到此菜单的指定位置。这是 insert(menuItem, index) 的一个便捷方法。

参数：

label - 项的文本

index - 菜单项应插入的位置

抛出：

IllegalArgumentException - 如果 index 的值小于零

从以下版本开始：

JDK1.1

另请参见：

add(java.lang.String), add(java.awt.MenuItem)

addSeparator

public void addSeparator()

将一个分隔线或连字符添加到菜单的当前位置。

另请参见：

insertSeparator(int)

insertSeparator

public void insertSeparator(int index)

在指定的位置插入分隔符。

参数：

index - 菜单分隔符应插入的位置。

抛出：

IllegalArgumentException - 如果 index 的值小于 0。

从以下版本开始：

JDK1.1

另请参见：

addSeparator()

remove

public void remove(int index)

从此菜单移除指定索引处的菜单项。

参数：

index - 要移除的项的位置。

remove

public void remove(MenuComponent item)

从此菜单移除指定的菜单项。

指定者：

接口 MenuContainer 中的 remove

参数：

item - 要从该菜单移除的项。如果 item 为 null，或不在此菜单中，则此方法不执行任何操作。

removeAll

public void removeAll()

从此菜单移除所有项。

从以下版本开始：

JDK1.0.

paramString

public String paramString()

返回表示此 Menu 状态的字符串。此方法仅用于调试目的，对于这两个实现，返回的字符串的内容和格式可能有所不同。返回的字符串可能为空，但不可能为 null。

覆盖：

类 MenuItem 中的 paramString

返回：

此菜单的参数字符串

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此菜单关联的 AccessibleContext。对于菜单，AccessibleContext 会采用 AccessibleAWTMenu 的窗体。必要时创建一个新的 AccessibleAWTDialog 实例。

指定者：

接口 Accessible 中的 getAccessibleContext

覆盖：

类 MenuItem 中的 getAccessibleContext

返回：

用作此菜单的 AccessibleContext 的 AccessibleAWTMenu

从以下版本开始：

1.3

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