类 java.awt.Menu

java.lang.Object
   |
   +----java.awt.MenuComponent
           |
           +----java.awt.MenuItem
                   |
                   +----java.awt.Menu

public class Menu

extends MenuItem

implements MenuContainer

下列类的父类：

PopupMenu

Menu 对象是菜单条上使用的下拉菜单组件。

一个菜单能选则为一 分离 菜单。能打开一分离菜单，也能将之拖离它的父菜单条或菜单。释放鼠标按钮后，它仍保持在屏幕上。分离菜单的机制与平台有关，因此分离菜单的外观由它的同级件决定。在不支持分离菜单的平台中，忽略分离属性。

菜单中的每项必定属于 MenuItem类。可为 MenuItem、submenu(Menu的实例)、或复选框(CheckboxMenuItem的实例)的实例。

来自：

JDK1.0

参见：

MenuItem, CheckboxMenuItem

构造子索引

Menu()

用一空标签创建一新菜单。

Menu(String)

用指定标签创建一新菜单。

Menu(String, boolean)

用指定标签创建一新菜单。

方法索引

add(MenuItem)

为此菜单添加指定的菜单项。

add(String)

用指定标签，为此菜单添加一项。

addNotify()

创建菜单的同级件。

addSeparator()

在菜单的当前位置添加一分割行或一 hypen。

countItems()

不推荐使用该方法。

getItem(int)

获取当前菜单中对应给定下标的菜单项。

getItemCount()

获取当前菜单的项数。

insert(MenuItem, int)

在菜单的指定位置插入一菜单项。

insert(String, int)

在菜单的指定位置，用指定标签插入一菜单项。

insertSeparator(int)

在指定位置插入一分割行。

isTearOff()

表明当前菜单是否是分离(tear-off)菜单。

paramString()

返回表示当前菜单状态的参数串。

remove(int)

从当前菜单中，删除指定下标的菜单项。

remove(MenuComponent)

删除菜单中的指定菜单项。

removeAll()

删除菜单中的所有项。

removeNotify()

删除菜单的同级件。

构造子

 public Menu()

用一空标签创建一新菜单。 此菜单不是分离(tear-off)菜单。

 public Menu(String label)

用指定标签创建一新菜单。 此菜单不是分离(tear-off)菜单。

参数：

label - 菜单条中的菜单标签；若该菜单是一 submenu，则是另一菜单标签。

 public Menu(String label,
             boolean tearOff)

用指定标签创建一新菜单。 如果 tearOff 是 true, 则菜单是分离的。

所有的 AWT 实现并不都支持分离功能。如果某个特定的实现不支持分离(tear-off)菜单，忽略此值。

参数：

label - 菜单条中的菜单标签；当该菜单是一 submenu，则是另一菜单标签。

tearOff - 若为 true, 则菜单是分离菜单。

方法

 public void addNotify()

创建菜单的同级件。 该同级件允许在不改变菜单功能的情况下改变其外观。

覆盖：

类 MenuItem 中的 addNotify

 public void removeNotify()

删除菜单的同级件。 该同级件允许在不改变菜单功能的情况下改变其外观。

覆盖：

类 MenuComponent 中的 removeNotify

 public boolean isTearOff()

表明当前菜单是否是分离(tear-off)菜单。

所有的 AWT 实现并不都支持分离功能。如果某个特定的实现不支持分离(tear-off)菜单，则忽略此值。

返回值：

如果是分离菜单则为true；否则为 false。

 public int getItemCount()

获取当前菜单的项数。

返回值：

菜单的项数。

 public int countItems()

注释：不推荐使用 countItems() 方法。 同 JDK 1.1 版中的方法一样，用 getItemCount() 替换。

 public MenuItem getItem(int index)

获取当前菜单中对应给定下标的菜单项。

参数：

index - 返回的菜单项位置。

返回值：

指定下标对应的菜单项。

 public MenuItem add(MenuItem mi)

为此菜单添加指定的菜单项。 如果此菜单项是另一菜单的部分，那么从那个菜单中删掉它。

参数：

mi - 待添加的菜单项。

返回值：

已添加的菜单项。

参见：

insert, insert

 public void add(String label)

用指定标签，为此菜单添加一项。

参数：

label - 项文本。

参见：

insert, insert

 public void insert(MenuItem menuitem,
                                      int index)

在菜单的指定位置插入一菜单项。

参数：

menuitem - 待插入的菜单项。

index - 菜单项的插入位置。

抛出： IllegalArgumentException

如果 下标 小于零。

参见：

add, add

 public void insert(String label,
                                      int index)

在菜单的指定位置，用指定标签插入一菜单项。

参数：

label - 项文本。

index - 菜单项的插入位置。

参见：

add, add

 public void addSeparator()

在菜单的当前位置添加一分割行或一 hypen。

参见：

insertSeparator

 public void insertSeparator(int index)

在指定位置插入一分割行。

参数：

index - 菜单分割行的插入位置。

抛出： IllegalArgumentException

如果 下标 小于零。

参见：

addSeparator

 public void remove(int index)

从当前菜单中，删除指定下标的菜单项。

参数：

index - 待删除的项位置。

 public void remove(MenuComponent item)

删除菜单中的指定菜单项。

参数：

item - 从菜单中将删除的项。

 public void removeAll()

删除菜单中的所有项。

 public String paramString()

返回表示当前菜单状态的参数串。 该字符串对调试有用。

覆盖：

类 MenuItem 中的 paramString