java.awt

Class Menu

java.lang.Object

java.awt.MenuComponent

java.awt.MenuItem

java.awt.Menu

All Implemented Interfaces:

MenuContainer， Serializable， Accessible

已知直接子类：

PopupMenu

public class Menu
extends MenuItem
implements MenuContainer, Accessible

一个 Menu对象下拉菜单组件，从菜单栏的部署。

菜单可以是一个可选的空撕下菜单。一个撕裂的菜单可以打开，并拖走它的父菜单栏或菜单。它仍然在屏幕上后，鼠标按钮已被释放。关闭菜单的机制是依赖于平台的，因为撕裂菜单的外观和感觉是由它的对等点决定的。在不支持撕裂菜单的平台上，忽略掉属性的属性。

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

从以下版本开始：

JDK1.0

另请参见：

MenuItem， CheckboxMenuItem， Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	Menu.AccessibleAWTMenu 用于提供可访问性的默认支持的菜单的内部类。

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

MenuItem.AccessibleAWTMenuItem

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

MenuComponent.AccessibleAWTMenuComponent

构造方法摘要

构造方法

Constructor and Description
Menu() 用空标签构造一个新的菜单。
Menu(String label) 用指定的标签构造一个新的菜单。
Menu(String label, boolean tearOff) 用指定的标签构造一个新的菜单，指示菜单是否可以被撕裂。

方法摘要

Modifier and Type	Method and Description
MenuItem	add(MenuItem mi) 将指定的菜单项添加到此菜单中。
void	add(String label) 在该菜单中添加一个带有指定标签的项目。
void	addNotify() 创建菜单的对等点。
void	addSeparator() 添加分隔线，或该菜单，到当前位置。
int	countItems() 过时的。 作为JDK 1.1版本，取而代之的getItemCount()。
AccessibleContext	getAccessibleContext() 获取与此相关的accessiblecontext菜单。
MenuItem	getItem(int index) 获取位于此菜单的指定索引处的项目。
int	getItemCount() 获取此菜单中的项目数。
void	insert(MenuItem menuitem, int index) 在指定位置将菜单项插入到该菜单中。
void	insert(String label, int index) 在指定位置将指定的标签插入到该菜单中的菜单项。
void	insertSeparator(int index) 在指定位置插入分离器。
boolean	isTearOff() 指示此菜单是否是一个菜单项的菜单项。
String	paramString() 返回一个字符串，表示此 Menu状态。
void	remove(int index) 从该菜单中移除指定索引处的菜单项。
void	remove(MenuComponent item) 从该菜单中删除指定的菜单项。
void	removeAll() 从这个菜单中移除所有项目。
void	removeNotify() 删除菜单的对等点。

Methods inherited from class java.awt.MenuItem

addActionListener, deleteShortcut, disable, disableEvents, enable, enable, enableEvents, getActionCommand, getActionListeners, getLabel, getListeners, getShortcut, isEnabled, processActionEvent, processEvent, removeActionListener, setActionCommand, setEnabled, setLabel, setShortcut

Methods inherited from class java.awt.MenuComponent

dispatchEvent, getFont, getName, getParent, getPeer, getTreeLock, postEvent, setFont, setName, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.awt.MenuContainer

getFont, postEvent

Constructor Detail

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()

创建菜单的对等点。的对等允许我们修改菜单的外观，而不改变其功能。

重写：

addNotify 方法重写，继承类 MenuItem

removeNotify

public void removeNotify()

删除菜单的对等点。的对等允许我们修改菜单的外观，而不改变其功能。

重写：

removeNotify 方法重写，继承类 MenuComponent

isTearOff

public boolean isTearOff()

指示此菜单是否是一个菜单项的菜单项。

撕裂的功能可能不被所有实现AWT支持。如果一个特定的实现不支持撕裂菜单，这个值被忽略了。

结果

如果这是一个 true撕下菜单； false否则。

getItemCount

public int getItemCount()

获取此菜单中的项目数。

结果

此菜单中的项目数。

从以下版本开始：

JDK1.1

countItems

@Deprecated
public int countItems()

过时的。 作为JDK 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)

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

Specified by:

remove 接口 MenuContainer

参数

item -项目是从菜单中删除。如果 item是 null或不在这个菜单，这个方法不。

removeAll

public void removeAll()

从这个菜单中移除所有项目。

从以下版本开始：

JDK1.0。

paramString

public String paramString()

返回一个字符串，表示此 Menu状态。此方法仅用于调试目的，返回的字符串的内容和格式可能会在实现过程中有所不同。返回的字符串是空的但可能不 null。

重写：

paramString 方法重写，继承类 MenuItem

结果

此菜单的参数字符串

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此相关的accessiblecontext菜单。对菜单的accessiblecontext以一个accessibleawtmenu形式。一个新的accessibleawtmenu实例被创建时。

Specified by:

getAccessibleContext 接口 Accessible

重写：

getAccessibleContext 方法重写，继承类 MenuItem

结果

一个accessibleawtmenu作为此菜单的accessiblecontext

从以下版本开始：

一点三