JavaTM 2 Platform
Standard Ed. 5.0

java.awt
类 MenuComponent

java.lang.Object
  继承者 java.awt.MenuComponent
所有已实现的接口:
Serializable
直接已知子类:
MenuBar, MenuItem

public abstract class MenuComponent
extends Object
implements Serializable

抽象类 MenuComponent 是所有与菜单相关的组件的超类。在这一方面,类 MenuComponent 与 AWT 组件的抽象超类 Component 相似。

菜单组件接收并处理 AWT 事件,就像组件通过方法 processEvent 执行的操作一样。

从以下版本开始:
JDK1.0
另请参见:
序列化表格

嵌套类摘要
protected  class MenuComponent.AccessibleAWTMenuComponent
          用于为可访问性提供默认支持的 MenuComponent 的内部类。
 
构造方法摘要
MenuComponent()
          创建 MenuComponent
 
方法摘要
 void dispatchEvent(AWTEvent e)
           
 AccessibleContext getAccessibleContext()
          获取与此 MenuComponent 关联的 AccessibleContext
 Font getFont()
          获取用于此菜单组件的字体。
 String getName()
          获取该菜单组件的名称。
 MenuContainer getParent()
          返回此菜单组件的父容器。
 java.awt.peer.MenuComponentPeer getPeer()
          已过时。 从 JDK version 1.1 开始,程序不应直接操作同位体。
protected  Object getTreeLock()
          获取此组件的锁定对象(拥有该线程同步监视器的对象),用于 AWT 组件树和布局操作。
protected  String paramString()
          返回表示此 MenuComponent 状态的字符串。
 boolean postEvent(Event evt)
          已过时。 从 JDK version 1.1 开始,已由 dispatchEvent 取代。
protected  void processEvent(AWTEvent e)
          处理发生在此菜单组件上的事件。
 void removeNotify()
          移除该菜单组件的同位体。
 void setFont(Font f)
          将用于此菜单组件的字体设置为指定字体。
 void setName(String name)
          将该组件的名称设置为指定字符串。
 String toString()
          返回此菜单组件的表示形式。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

MenuComponent

public MenuComponent()
              throws HeadlessException
创建 MenuComponent

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

getName

public String getName()
获取该菜单组件的名称。

返回:
该菜单组件的名称
从以下版本开始:
JDK1.1
另请参见:
setName(java.lang.String)

setName

public void setName(String name)
将该组件的名称设置为指定字符串。

参数:
name - 菜单组件的名称
从以下版本开始:
JDK1.1
另请参见:
getName()

getParent

public MenuContainer getParent()
返回此菜单组件的父容器。

返回:
包含此菜单组件的菜单组件,如果此菜单组件就是最外部组件,即该菜单栏本身,则返回 null

getPeer

@Deprecated
public java.awt.peer.MenuComponentPeer getPeer()
已过时。 从 JDK version 1.1 开始,程序不应直接操作同位体。


getFont

public Font getFont()
获取用于此菜单组件的字体。

返回:
在此菜单组件中使用的字体(如果存在);否则,返回 null
另请参见:
setFont(java.awt.Font)

setFont

public void setFont(Font f)
将用于此菜单组件的字体设置为指定字体。除非此菜单组件的所有子组件指定其他字体,否则它们也使用此字体。

有些平台可能不支持对菜件组件的所有字体属性的设置;在这种情况下,调用 setFont 将对此菜单组件的不受支持的字体属性没有任何效果。除非此菜单组件的子菜单组件指定其他字体,否则,如果基础平台支持此字体,则这些子组件将使用该字体。

参数:
f - 要设置的字体
另请参见:
getFont(), Font.getAttributes(), TextAttribute

removeNotify

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


postEvent

@Deprecated
public boolean postEvent(Event evt)
已过时。 从 JDK version 1.1 开始,已由 dispatchEvent 取代。

将指定的事件发布到该菜单。此方法是 Java 1.0 事件系统的一部分,维持它仅为了向后兼容。不鼓励使用它,它将来可能不受支持。

参数:
evt - 将要发生的事件

dispatchEvent

public final void dispatchEvent(AWTEvent e)

processEvent

protected void processEvent(AWTEvent e)
处理发生在此菜单组件上的事件。

注意,如果此事件参数为 null,则此行为是不确定的,而且可能导致异常。

参数:
e - 事件
从以下版本开始:
JDK1.1

paramString

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

返回:
此菜单组件的参数字符串

toString

public String toString()
返回此菜单组件的表示形式。

覆盖:
Object 中的 toString
返回:
此菜单组件的字符串表示形式

getTreeLock

protected final Object getTreeLock()
获取此组件的锁定对象(拥有该线程同步监视器的对象),用于 AWT 组件树和布局操作。

返回:
此组件的锁定对象

getAccessibleContext

public AccessibleContext getAccessibleContext()
获取与此 MenuComponent 关联的 AccessibleContext。由此基类实现的方法返回 null。扩展 MenuComponent 的类应实现此方法,以返回与该子类关联的 AccessibleContext

返回:
MenuComponentAccessibleContext

JavaTM 2 Platform
Standard Ed. 5.0

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

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