JavaTM 2 Platform
Standard Ed. 5.0

java.awt
类 MenuBar

java.lang.Object
  继承者 java.awt.MenuComponent
      继承者 java.awt.MenuBar
所有已实现的接口:
MenuContainer, Serializable, Accessible

public class MenuBar
extends MenuComponent
implements MenuContainer, Accessible

MenuBar 类封装绑定到框架的菜单栏的平台概念。为了将该菜单栏与 Frame 对象关联,可以调用该框架的 setMenuBar 方法。

下面是菜单栏的外观:

ALIGN=center HSPACE=10 VSPACE=7>

菜单栏处理菜单项的键盘快捷方式,并将它们传递到其子菜单。(键盘快捷方式是可选的,它为用户提供鼠标的替代方法,可以使用快捷方式调用菜单项并执行与鼠标关联的操作。)每个菜单项都可以维护 MenuShortcut 的一个实例。MenuBar 类定义了多个方法,其中 shortcuts()getShortcutMenuItem(java.awt.MenuShortcut) 用于检索有关给定的菜单栏正在管理的快捷方式的信息。

从以下版本开始:
JDK1.0
另请参见:
Frame, Frame.setMenuBar(java.awt.MenuBar), Menu, MenuItem, MenuShortcut, 序列化表格

嵌套类摘要
protected  class MenuBar.AccessibleAWTMenuBar
          菜单栏的内部类,用于为可访问性提供默认支持。
 
从类 java.awt.MenuComponent 继承的嵌套类/接口
MenuComponent.AccessibleAWTMenuComponent
 
构造方法摘要
MenuBar()
          创建新的菜单栏。
 
方法摘要
 Menu add(Menu m)
          将指定的菜单添加到菜单栏。
 void addNotify()
          创建该菜单栏的同位体 (peer)。
 int countMenus()
          已过时。 从 JDK version 1.1 开始,由 getMenuCount() 取代。
 void deleteShortcut(MenuShortcut s)
          删除指定的菜单快捷方式。
 AccessibleContext getAccessibleContext()
          获取与此菜单栏关联的 AccessibleContext。
 Menu getHelpMenu()
          获取该菜单栏上的帮助菜单。
 Menu getMenu(int i)
          获取指定的菜单。
 int getMenuCount()
          获取该菜单栏上的菜单数。
 MenuItem getShortcutMenuItem(MenuShortcut s)
          获取与指定 MenuShortcut 对象关联的 MenuItem 的实例,如果此菜单栏正在管理的菜单项均与指定的菜单快捷方式无关联,则为 null
 void remove(int index)
          从此菜单栏移除指定索引处的菜单。
 void remove(MenuComponent m)
          从此菜单栏移除指定的菜单组件。
 void removeNotify()
          移除该菜单栏的同位体。
 void setHelpMenu(Menu m)
          将指定的菜单设置为此菜单栏的帮助菜单。
 Enumeration<MenuShortcut> shortcuts()
          获取此菜单栏正在管理的所有菜单快捷方式的枚举。
 
从类 java.awt.MenuComponent 继承的方法
dispatchEvent, getFont, getName, getParent, getPeer, getTreeLock, paramString, postEvent, processEvent, setFont, setName, toString
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
从接口 java.awt.MenuContainer 继承的方法
getFont, postEvent
 

构造方法详细信息

MenuBar

public MenuBar()
        throws HeadlessException
创建新的菜单栏。

抛出:
HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。
另请参见:
GraphicsEnvironment.isHeadless()
方法详细信息

addNotify

public void addNotify()
创建该菜单栏的同位体 (peer)。该同位体允许我们更改该菜单栏的外观,而不改变菜单栏的任何功能。


removeNotify

public void removeNotify()
移除该菜单栏的同位体。该同位体允许我们更改该菜单栏的外观,而不改变菜单栏的任何功能。

覆盖:
MenuComponent 中的 removeNotify

getHelpMenu

public Menu getHelpMenu()
获取该菜单栏上的帮助菜单。

返回:
此菜单栏上的帮助菜单。

setHelpMenu

public void setHelpMenu(Menu m)
将指定的菜单设置为此菜单栏的帮助菜单。如果此菜单栏已有帮助菜单,则从该菜单栏移除旧的帮助菜单,并替换为指定的菜单。

参数:
m - 要设置为帮助菜单的菜单

add

public Menu add(Menu m)
将指定的菜单添加到菜单栏。如果该菜单已经是另一个菜单栏的一部分,则从该菜单栏移除它。

参数:
m - 要添加的菜单
返回:
已添加的菜单
另请参见:
remove(int), remove(java.awt.MenuComponent)

remove

public void remove(int index)
从此菜单栏移除指定索引处的菜单。

参数:
index - 要移除的菜单的位置。
另请参见:
add(java.awt.Menu)

remove

public void remove(MenuComponent m)
从此菜单栏移除指定的菜单组件。

指定者:
接口 MenuContainer 中的 remove
参数:
m - 要移除的菜单组件。
另请参见:
add(java.awt.Menu)

getMenuCount

public int getMenuCount()
获取该菜单栏上的菜单数。

返回:
该菜单栏上的菜单数。
从以下版本开始:
JDK1.1

countMenus

@Deprecated
public int countMenus()
已过时。 从 JDK version 1.1 开始,由 getMenuCount() 取代。


getMenu

public Menu getMenu(int i)
获取指定的菜单。

参数:
i - 要返回的菜单的索引位置。
返回:
此菜单栏的指定索引处的菜单。

shortcuts

public Enumeration<MenuShortcut> shortcuts()
获取此菜单栏正在管理的所有菜单快捷方式的枚举。

返回:
此菜单栏正在管理的菜单快捷方式的枚举。
从以下版本开始:
JDK1.1
另请参见:
MenuShortcut

getShortcutMenuItem

public MenuItem getShortcutMenuItem(MenuShortcut s)
获取与指定 MenuShortcut 对象关联的 MenuItem 的实例,如果此菜单栏正在管理的菜单项均与指定的菜单快捷方式无关联,则为 null

参数:
s - the specified menu shortcut.
从以下版本开始:
JDK1.1
另请参见:
MenuItem, MenuShortcut

deleteShortcut

public void deleteShortcut(MenuShortcut s)
删除指定的菜单快捷方式。

参数:
s - 要删除的菜单快捷方式。
从以下版本开始:
JDK1.1

getAccessibleContext

public AccessibleContext getAccessibleContext()
获取与此菜单栏关联的 AccessibleContext。对于菜单栏,AccessibleContext 采用 AccessibleAWTMenuBar 的窗体。必要时会创建新的 AccessibleAWTMenuBar 实例。

指定者:
接口 Accessible 中的 getAccessibleContext
覆盖:
MenuComponent 中的 getAccessibleContext
返回:
用作此菜单栏的 AccessibleContext 的 AccessibleAWTMenuBar。

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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