类 java.awt.Component

java.lang.Object
   |
   +----java.awt.Component

public abstract class Component

extends Object

implements ImageObserver, MenuContainer, Serializable

下列类的父类：

Button, Canvas, Checkbox, Choice, Container, Label, List, Scrollbar, TextComponent

component 是一个具有图形表示的对象，它可显示在屏幕上，与用户进行交互。一个典型的图形用户界面中的按钮、复选框和滚动条都是组件的例子。

Component 类是没有菜单的 AWT 组件的抽象父类。可直接扩展类 Component 来创建一个轻量级组件。一个轻量级组件不能与本地不透明窗口相关联的。

变量索引

BOTTOM_ALIGNMENT

getAlignmentY 方法的易于使用的常量。

CENTER_ALIGNMENT

getAlignmentY 和 getAlignmentX 方法的易于使用的常量。

LEFT_ALIGNMENT

getAlignmentX 方法的易于使用的常量。

RIGHT_ALIGNMENT

getAlignmentX 方法的易于使用的常量。

TOP_ALIGNMENT

getAlignmentY 方法的易于使用的常量。

构造子索引

Component()

构造一个新建组件。

方法索引

action(Event, Object)

不推荐使用该方法。

add(PopupMenu)

将指定的弹出式菜单添加到组件。

addComponentListener(ComponentListener)

添加指定的组件监听者，接收来自这个组件的组件事件。

addFocusListener(FocusListener)

加入一指定的焦点监听器，接收来自这个组件中的焦点事件。

addKeyListener(KeyListener)

添加指定的按按键监听者，接收来自这个组件的键盘事件。

addMouseListener(MouseListener)

添加指定的鼠标监听者，接收来自这个组件的鼠标事件。

addMouseMotionListener(MouseMotionListener)

添加指定的鼠标移动监听者，接收来自这个组件的鼠标移动事件。

addNotify()

通知这个组件它已被添加到一个容器中，并且若需要它的一个同级件，则将创建它的同级件。

bounds()

不推荐使用该方法。

checkImage(Image, ImageObserver)

返回指定图像的屏幕表示结构的状态。

checkImage(Image, int, int, ImageObserver)

返回指定图像的屏幕表示结构的状态。

contains(int, int)

检查这个组件是否“包含”指定的点，其中 x 和 y 值是相对于这个组件的坐标系而定义的。

contains(Point)

检查这个组件是否包含“指定”的点，其中，点的 x 和 y 坐标是相对于这个组件的坐标系而定义的。

createImage(ImageProducer)

用指定图像生产者创建一个图像。

createImage(int, int)

创建一个可在双重缓冲器中使用的屏幕外缓冲区的可绘制的图像。

deliverEvent(Event)

不推荐使用该方法。

disable()

不推荐使用该方法。

disableEvents(long)

由指定的事件掩码参数定义的事件被禁止传送到这个组件。

dispatchEvent(AWTEvent)

分配一个事件给这个组件或它的一个子组件。

doLayout()

提示布局管理器来对这个组件进行布局。

enable()

不推荐使用该方法。

enable(boolean)

不推荐使用该方法。

enableEvents(long)

使由指定的事件掩码参数定义的事件可被传送到这个组件。

getAlignmentX()

返回沿 X 轴 的对齐方式。

getAlignmentY()

返回沿 Y 轴 的对齐方式。

getBackground()

获取这个组件的背景色。

getBounds()

获取这个组件的 Rectangle 对象格式的边界。

getColorModel()

获取用于显示输出设备上的组件的 ColorModel 的实例。

getComponentAt(int, int)

确定这个组件或它的一个直接子组件是否包含 (x, y) 位置，若包含，则返回包含的组件。

getComponentAt(Point)

返回包含指定点的组件或子组件。

getCursor()

获取设置在这个组件上的光标。

getFont()

获取这个组件的字体。

getFontMetrics(Font)

获取指定字体的字体度量。

getForeground()

获取这个组件的前景色。

getGraphics()

获取这个组件的一个图形上下文。

getLocale()

获取这个组件的语言环境。

getLocation()

获取这个组件的位置，组件位置用一个指明组件左上角的点来表示。

getLocationOnScreen()

获取这个组件的位置，组件位置用屏幕坐标系中指明组件左上角的点来表示。

getMaximumSize()

获取这个组件的最大尺寸。

getMinimumSize()

获取这个组件的最小尺寸。

getName()

获取这个组件的名字。

getParent()

获取这个组件的父类。

getPeer()

不推荐使用该方法。

getPreferredSize()

获取这个组件的最佳尺寸。

getSize()

返回这个组件的 Dimension 对象格式的大小。

getToolkit()

获取这个组件的工具箱。

getTreeLock()

获取这个组件的 AWT 组件树的加锁对象 ( 该对象拥有线程同步控制器 ) 和布局操作。

gotFocus(Event, Object)

不推荐使用该方法。

handleEvent(Event)

不推荐使用该方法。

hide()

不推荐使用该方法。

imageUpdate(Image, int, int, int, int, int)

当图像改变时重新绘制组件。

inside(int, int)

不推荐使用该方法。

invalidate()

使这个组件无效。

isEnabled()

确定这个组件是否可使用。

isFocusTraversable()

返回表示是否可使用 Tab 或 Shift-Tab 键盘焦点遍历这个组件的标志的值。

isShowing()

确定这个组件是否显示在屏幕上。

isValid()

确定这个组件是否有效。

isVisible()

确定这个组件是否可见。

keyDown(Event, int)

不推荐使用该方法。

keyUp(Event, int)

不推荐使用该方法。

layout()

不推荐使用该方法。

list()

打印这个组件的打印清单到标准系统输出流 System.out 。

list(PrintStream)

打印这个组件的打印清单到指定输出流中。

list(PrintStream, int)

打印组件的打印清单到指定的打印流，该清单在指定缩进位置处开始。

list(PrintWriter)

打印一个打印清单到指定的打印写程序。

list(PrintWriter, int)

打印一个打印清单到指定的打印写程序，该清单从指定的缩进位置处开始。

locate(int, int)

不推荐使用该方法。

location()

不推荐使用该方法。

lostFocus(Event, Object)

不推荐使用该方法。

minimumSize()

不推荐使用该方法。

mouseDown(Event, int, int)

不推荐使用该方法。

mouseDrag(Event, int, int)

不推荐使用该方法。

mouseEnter(Event, int, int)

不推荐使用该方法。

mouseExit(Event, int, int)

不推荐使用该方法。

mouseMove(Event, int, int)

不推荐使用该方法。

mouseUp(Event, int, int)

不推荐使用该方法。

move(int, int)

不推荐使用该方法。

nextFocus()

不推荐使用该方法。

paint(Graphics)

绘制这个组件。

paintAll(Graphics)

绘制这个组件和它的所有子组件。

paramString()

返回表示这个组件状态的参数字符串。

postEvent(Event)

不推荐使用该方法。

preferredSize()

不推荐使用该方法。

prepareImage(Image, ImageObserver)

预备一个绘制在这个组件上的图像。

prepareImage(Image, int, int, ImageObserver)

预备一个以指定的宽度和高度绘制在这个组件上的图像。

print(Graphics)

打印这个组件。

printAll(Graphics)

打印这个组件和它的所有子组件。

processComponentEvent(ComponentEvent)

通过将组件事件分配给任意一个已注册的 ComponentListener 对象，来处理发生在这个组件上的组件事件，。

processEvent(AWTEvent)

处理发生在这个组件上的事件。

processFocusEvent(FocusEvent)

通过将焦点事件分配给任意一个已注册的 FocusListener 对象，来处理发生在这个组件上的焦点事件。

processKeyEvent(KeyEvent)

通过将键盘事件分配给任意一个已注册的 对象，来处理发生在这个组件上的键盘事件。

processMouseEvent(MouseEvent)

通过将鼠标事件分配给任意一个已注册的 MouseListener 对象，来处理发生在这个组件上的鼠标事件。

processMouseMotionEvent(MouseEvent)

通过将鼠标移动事件分配给任意一个已注册的 MouseMotionListener 对象，来处理发生在这个组件上的鼠标移动事件。

remove(MenuComponent)

从组件中删除指定的弹出式菜单。

removeComponentListener(ComponentListener)

删除指定的组件监听者，使其不再接收来自这个组件的组件事件。

removeFocusListener(FocusListener)

删除指定的焦点监听者，使其不再接收来自这个组件的焦点事件。

removeKeyListener(KeyListener)

删除指定的按按键监听者，使其不再接收来自这个组件的键盘事件。

removeMouseListener(MouseListener)

删除指定的鼠标监听者，使其不再接收来自这个组件的鼠标事件。

removeMouseMotionListener(MouseMotionListener)

删除指定的鼠标移动监听者，使其不再接收来自这个组件的鼠标移动事件。

removeNotify()

通知这个组件它已被从它所在的容器中删除，并且若存在它的一个同级件，则撤消同级件。

repaint()

重新绘制这个组件。

repaint(int, int, int, int)

重新绘制这个组件的指定的矩形。

repaint(long)

重新绘制这个组件。

repaint(long, int, int, int, int)

在 tm 毫秒内，重新绘制这个组件的指定的矩形。

requestFocus()

这个组件请求获得输入焦点。

reshape(int, int, int, int)

不推荐使用该方法。

resize(Dimension)

不推荐使用该方法。

resize(int, int)

不推荐使用该方法。

setBackground(Color)

设置这个组件的背景色。

setBounds(int, int, int, int)

移动并重置这个组件的尺寸。

setBounds(Rectangle)

移动并重置这个组件的尺寸，使其与新的边界矩形 r 一致。

setCursor(Cursor)

设置光标图像为预定义的光标。

setEnabled(boolean)

根据参数 b 的值，设置这个组件可以使用或禁用。

setFont(Font)

设置这个组件的字体。

setForeground(Color)

设置这个组件的前景色。

setLocale(Locale)

设置这个组件的语言环境。

setLocation(int, int)

将这个组件移动到新位置。

setLocation(Point)

将这个组件移动到新位置。

setName(String)

设置组件名为指定字符串。

setSize(Dimension)

重置这个组件的尺寸，使其具有宽度 d.width 和高度 d.height 。

setSize(int, int)

重置这个组件的尺寸，使其具有宽度 width 和 height 。

setVisible(boolean)

根据参数 b 的值确定显示或隐藏这个组件。

show()

不推荐使用该方法。

show(boolean)

不推荐使用该方法。

size()

不推荐使用该方法。

toString()

返回这个组件的字符串表示和它的值。

transferFocus()

将焦点传送到下一个组件。

update(Graphics)

更改这个组件。

validate()

确保这个组件的布局有效。

变量

 public static final float TOP_ALIGNMENT

getAlignmentY 方法的易于使用的常量。它指定一个组件顶部对齐方式。

参见：

getAlignmentY

 public static final float CENTER_ALIGNMENT

getAlignmentY 和 getAlignmentX 方法的易于使用的常量。它指定了一个组件居中对齐方式。

参见：

getAlignmentX, getAlignmentY

 public static final float BOTTOM_ALIGNMENT

getAlignmentY 方法的易于使用的常量。它指定了一个组件底部对齐方式。

参见：

getAlignmentY

 public static final float LEFT_ALIGNMENT

getAlignmentX 方法的易于使用的常量。它指定一个组件左对齐方式。

参见：

getAlignmentX

 public static final float RIGHT_ALIGNMENT

getAlignmentX 方法的易于使用的常量。它指定一个组件右对齐方式。

参见：

getAlignmentX

构造子

 protected Component()

构造一个新建组件。可直接扩展类 Component 来创建一个轻量级组件。这个组件不使用不透明的本地窗口。轻量级组件必须放在组件树中更高层次的本地容器中 ( 例如，放在一个 Frame 对象中 ) 。

方法

 public String getName()

获取这个组件的名字。

返回值：

这个组件的名字。

参见：

setName

 public void setName(String name)

设置组件名为指定字符串。

参数：

name - 表示这个组件名字的字符串

参见：

getName

 public Container getParent()

获取这个组件的父代。

返回值：

这个组件的父代容器。

 public ComponentPeer getPeer()

注意：不推荐使用 getPeer() 方法。 同 JDK 1.1 版一样，程序不应直接操作同级件。

 public final Object getTreeLock()

获取这个组件的 AWT 组件树的加锁对象 ( 该对象拥有线程同步控制器 ) 和布局操作。

返回值：

这个组件的加锁对象。

 public Toolkit getToolkit()

获取这个组件的工具箱。注意包含一个组件的框架控制这个组件使用哪个工具箱。因此，如果组件从一个框架移到另一框架中，它使用的工具箱可能改变。

返回值：

这个组件的工具箱。

 public boolean isValid()

确定这个组件是否有效。组件首次显示在屏幕时，是无效的。

返回值：

若组件有效，则返回 true ；否则返回 false 。

参见：

validate, invalidate

 public boolean isVisible()

确定这个组件是否可见。组件初始是可见的，诸如 Frame 等顶层组件是例外情况。

返回值：

若组件可见，则返回 true ；否则返回 false 。

参见：

setVisible

 public boolean isShowing()

确定这个组件是否显示在屏幕上。它意味着这个组件必须是可见的，并且它必须包含在一个可见的正在显示的容器。

返回值：

若组件显示，则返回 true ；否则返回 false 。

参见：

setVisible

 public boolean isEnabled()

确定这个组件是否可使用。可使用的组件可对用户输入进行响应，并生成事件。组件是缺省的初始可使用。可通过调用组件的 setEnabled 方法，来启用或禁用这个组件。

返回值：

若这个组件可使用，则返回 true ；否则返回 false 。

参见：

setEnabled

 public void setEnabled(boolean b)

根据参数 b 的值，确定这个组件是否可使用。可使用的组件可对用户输入进行响应，并生成事件。组件是缺省的初始可使用的。

参数：

b - 若为 true ，这个组件可以使用；否则这个组件禁用。

参见：

isEnabled

 public void enable()

注意：不推荐使用 enable() 方法。 同 JDK 1.1 版一样, 用 setEnabled(boolean)方法替换该方法。

 public void enable(boolean b)

注意：不推荐使用 enable() 方法。 同 JDK 1.1 版一样, 用 setEnabled(boolean)方法替换该方法。

 public void disable()

注意：不推荐使用 disable() 方法。 同 JDK 1.1 版一样, 用 setEnabled(boolean)方法替换该方法。

 public void setVisible(boolean b)

根据参数 b 的值确定显示或隐藏这个组件。

参数：

b - 若为 true ，显示这个组件；否则隐藏这个组件。

参见：

isVisible

 public void show()

注意：不推荐使用 show() 方法。 同 JDK 1.1 版一样，用 setVisible(boolean) 方法替换该方法。

 public void show(boolean b)

注意：不推荐使用 show() 方法。 同 JDK 1.1 版一样，用 setVisible(boolean) 方法替换该方法。

 public void hide()

注意：不推荐使用 hide() 方法。 同 JDK 1.1 版一样，用 setVisible(boolean) 方法替换该方法。

 public Color getForeground()

获取这个组件的前景色。

返回值：

这个组件的前景色。若这个组件没有前景色，返回其父代的前景色。

参见：

java.awt.Component#setForeground

 public void setForeground(Color c)

设置这个组件的前景色。

参数：

c - 这个组件的前景色。

参见：

getForeground

 public Color getBackground()

获取这个组件的背景色。

返回值：

这个组件的背景色，若这个组件没有背景色，返回其父代的背景色。

参见：

setBackground

 public void setBackground(Color c)

设置这个组件的背景色。

参数：

c - 这个组件的背景色。

参见：

getBackground

 public Font getFont()

获取这个组件的字体。

返回值：

这个组件的字体。若没有设置这个组件的字体，返回其父代的字体。

参见：

setFont

 public synchronized void setFont(Font f)

设置这个组件的字体。

参数：

f - 这个组件的字体。

参见：

getFont

 public Locale getLocale()

获取这个组件的语言环境。

返回值：

组件的语言环境。若组件没有语言环境，返回其父类的语言环境。

抛出： IllegalComponentStateException

若组件没有自己的语言环境，并且尚未被加入到一个包容层次中，该层次根据包含的父类可确定它的语言环境。

参见：

setLocale

 public void setLocale(Locale l)

设置这个组件的语言环境。

参数：

l - 这个组件的语言环境。

参见：

getLocale

 public ColorModel getColorModel()

获取用于显示输出设备的组件的 ColorModel 的实例。

返回值：

这个组件使用的颜色模型。

参见：

ColorModel, getColorModel, getColorModel

 public Point getLocation()

获取这个组件的位置，组件位置用指明组件左上角的点来表示。并且是相对于其父代的坐标系而定义的。

返回值：

一个表示组件边界的左上角在其父代的坐标系中的 Point 的示例。

参见：

setLocation, getLocationOnScreen

 public Point getLocationOnScreen()

获取这个组件的位置，组件位置用屏幕坐标系中指明组件左上角的点来表示。

返回值：

屏幕坐标系中，一个表示组件边界的左上角的 Point 实例。

参见：

setLocation, getLocation

 public Point location()

注意：不推荐使用 location() 方法。 同 JDK 1.1 版一样，用 getLocation() 方法替换该方法。

 public void setLocation(int x,
                         int y)

将这个组件移动到新位置。新位置的左上角由这个组件父代的坐标系中的 x 和 y 参数指定。

参数：

x - 父代坐标空间中，新位置左上角的 x 坐标。

y - 父代坐标空间中，新位置左上角的 y 坐标。

参见：

getLocation, setBounds

 public void move(int x,
                  int y)

注意：不推荐使用 move() 方法。 同 JDK 1.1 版一样, 用 setLocation(int, int) 方法替换该方法。

 public void setLocation(Point p)

将这个组件移动到新位置。新位置的左上角由点 p 指定。点 p 在其父代坐标空间中给出。

参数：

p - 定义新位置的左上角的点，该点在这个组件的父代坐标空间中给定。

参见：

getLocation, setBounds

 public Dimension getSize()

返回这个组件的 Dimension 对象格式的大小。 Dimension 对象的 height 域包含这个组件的高度，Dimension 对象的 width 域包含这个组件的宽度。

返回值：

表示这个组件大小的 Dimension 对象。

参见：

setSize

 public Dimension size()

注意：不推荐使用 size() 方法。 同 JDK 1.1 版一样，用 getSize() 方法替换该方法。

 public void setSize(int width,
                     int height)

重置这个组件的尺寸，使其具有宽度 width 和 height 。

参数：

width - 这个组件的以像素为单位的新宽度。

height - 这个组件的以像素为单位的新高度。

参见：

getSize, setBounds

 public void resize(int width,
                    int height)

注意：不推荐使用 resize() 方法。 同 JDK 1.1 版一样，用 setSize(int, int) 方法替换该方法。

 public void setSize(Dimension d)

重置这个组件的尺寸，使其具有宽度 d.width 和高度 d.height 。

参数：

d - 指定组件的新尺寸的尺寸对象。

参见：

setSize, setBounds

 public void resize(Dimension d)

注意：不推荐使用 resize() 方法。 同 JDK 1.1 版一样，用 setSize(int, int) 方法替换该方法。

 public Rectangle getBounds()

获取这个组件的 Rectangle 对象格式的边界。该边界指定了这个组件的宽度、高度和它相对于其父代的位置。

返回值：

表示这个组件边界的矩形。

参见：

setBounds, getLocation, getSize

 public Rectangle bounds()

注意：不推荐使用 bounds() 方法。 同 JDK 1.1 版一样，用getBounds() 方法替换该方法。

 public void setBounds(int x,
                       int y,
                       int width,
                       int height)

移动并改变组件的尺寸。组件左上角的新位置由 x 和 y 指定，组件的新尺寸由 width 和 height 指定。

参数：

x - 组件的新的 x 坐标。

y - 组件的新的 y 坐标。

width - 组件的新的宽度 。

height - 组件的新的高度。

参见：

getBounds, setLocation, setLocation, setSize, setSize

 public void reshape(int x,
                     int y,
                     int width,
                     int height)

注意：不推荐使用 reshape() 方法。 同 JDK 1.1 版一样, 用 setBounds(int, int, int, int) 方法替换该方法。

 public void setBounds(Rectangle r)

移动并重置这个组件的尺寸，使其与新的边界矩形 r 一致。这个组件的新位置由 r.x 和 r.y 指定，它的新尺寸由 r.width 和 r.height 指定。

参数：

r - 这个组件的新的边界矩形。

参见：

getBounds, setLocation, setLocation, setSize, setSize

 public Dimension getPreferredSize()

获取这个组件的最佳尺寸。

返回值：

表示这个组件的最佳尺寸的尺寸对象。

参见：

getMinimumSize, LayoutManager

 public Dimension preferredSize()

注意：不推荐使用 preferredSize()。 同 JDK 1.1 版一样，用 getPreferredSize() 方法替换该方法。

 public Dimension getMinimumSize()

获取这个组件的最小尺寸。

返回值：

表示这个组件的最小尺寸的尺寸对象。

参见：

getPreferredSize, awtLayoutManager

 public Dimension minimumSize()

注意：不推荐使用 minimumSize() 方法。 同 JDK 1.1 版一样，用 getMinimumSize() 方法替换该方法。

 public Dimension getMaximumSize()

获取这个组件的最大尺寸。

返回值：

表示这个组件的最大尺寸的尺寸对象。

参见：

getMinimumSize, getPreferredSize, LayoutManager

 public float getAlignmentX()

返回沿 X 轴 的对齐方式。它指定了这个组件相对于其它组件的对齐方式。该值应是一个介于 0 和 1 之间的数，其中 0 表示沿原点对齐，1 表示按距原点最远的点对齐，0.5 表示居中对齐等。

 public float getAlignmentY()

返回沿 Y 轴 的对齐方式。它指定了这个组件相对于其它组件的对齐方式。该值应是一个介于 0 和 1 之间的数，其中 0 表示沿原点对齐，1 表示按距原点最远的点对齐，0.5 表示居中对齐等。

 public void doLayout()

提示布局管理器来对这个组件进行布局。当对组件 ( 通常是容器 ) 进行确认时，经常调用该方法。

参见：

validate, LayoutManager

 public void layout()

注意：不推荐使用 layout() 方法。 同 JDK 1.1 版一样，用 doLayout() 方法替换该方法。

 public void validate()

确保这个组件的布局有效。该方法主要用于 Container 实例上的操作。

参见：

invalidate, doLayout, LayoutManager, validate

 public void invalidate()

使这个组件无效。这个组件和其上的所有父代被标记为需要进行布局。由于该方法经常被调用，因此它的执行速度要求较快。

参见：

validate, doLayout, LayoutManager

 public Graphics getGraphics()

获取这个组件的一个图形上下文。若这个组件目前不在屏幕上，该方法返回 null 。

返回值：

这个组件的图形上下文，若组件无图形上下文，返回 null 。

参见：

paint

 public FontMetrics getFontMetrics(Font font)

获取指定字体的字体度量。

参数：

font - 要获得其字体度量的字体。

font - 字体。

返回值：

font 的字体度量。

参见：

getFont, getPeer, getFontMetrics, getFontMetrics

 public synchronized void setCursor(Cursor cursor)

设置光标图像为预定义的光标。

参数：

cursor - 由 Cursor 类定义的一个常量。

参见：

getCursor, Cursor

 public Cursor getCursor()

获取设置在这个组件上的光标。

返回值：

组件的光标。

参见：

setCursor, Cursor

 public void paint(Graphics g)

绘制这个组件。当组件首次被显示或被破坏组件需要修正时，相应地绘制组件的内容，此时该方法被调用。Graphics 参数中的剪切矩形将被设置为需要被绘制的区域。

参数：

g - 用于绘制的图形文本。

参见：

update

 public void update(Graphics g)

更改这个组件。

AWT 调用 update 方法来响应 repaint 方法调用。在最后一次执行 update 或 paint 调用后，组件在屏幕上的显示没有改变。可以假设背景没被清除。

Component 的 update 方法执行下列操作：

• 通过填充背景色来清除这个组件。
• 设置图形上下文的颜色为这个组件的前景色。
• 调用这个组件的 paint 方法来完整地重画这个组件。

图形上下文的原点，即它的 (0, 0) 坐标点，是这个组件的左上角。图形上下文的剪切范围是这个组件的边界矩形。

参数：

g - 指定的用于修改的上下文。

参见：

paint, repaint

 public void paintAll(Graphics g)

绘制这个组件和它的所有子组件。

图形组件的原点，即它的 (0, 0) 坐标点，是这个组件的左上角。图形上下文的剪切范围是这个组件的边界矩形。

参数：

g - 用于绘制的图形上下文。

参见：

paint

 public void repaint()

重新绘制这个组件。

该方法可导致 update 方法尽快被调用。

参见：

update

 public void repaint(long tm)

重新绘制这个组件。它将导致在 tm 毫秒内调用 update 方法。

参数：

tm - 更改之前的最大延迟时间，以毫秒为单位

参见：

paint, update

 public void repaint(int x,
                     int y,
                     int width,
                     int height)

重新绘制该组件的指定的矩形。

该方法将导致这个组件的 update 方法尽快被调用。

参数：

x - x 坐标。

y - y 坐标。

width - 宽度。

height - 高度。

参见：

update

 public void repaint(long tm,
                     int x,
                     int y,
                     int width,
                     int height)

在 tm 毫秒内，重新绘制这个组件的指定的矩形。

该方法将导致这个组件的 update 方法被调用。

参数：

tm - 更改之前的最小延迟时间，以毫秒为单位

x - x 坐标。

y - y 坐标。

width - 宽度。

height - 高度。

参见：

update

 public void print(Graphics g)

打印这个组件。对于打印前必须执行特殊处理的组件，或打印方式与绘制方式不同的组件，应用应覆盖它们中的这个方法。

该方法的缺省实现调用 paint 方法。

图形上下文的原点，即它的 (0, 0) 坐标点，是这个组件的左上角。图形上下文的剪切区域是这个组件的边界矩形。

参数：

g - 用于打印的图形上下文。

参见：

paint

 public void printAll(Graphics g)

打印这个组件和它的所有子组件。

图形上下文的原点，即它的 (0, 0) 坐标点，是这个组件的左上角。图形上下文的剪切区域是这个组件的边界矩形。

参数：

g - 用于打印的图形上下文。

参见：

print

 public boolean imageUpdate(Image img,
                            int flags,
                            int x,
                            int y,
                            int w,
                            int h)

当图像改变时重新绘制这个组件。当有关图像的更多信息变为有效时，ImageObserver 的 imageUpdate 方法被调用，这些信息是以前使用诸如 Graphics 中的 drawImage 方法等异步程序请求的。可参见 imageUpdate 的定义，来获得该方法及其参数的更多信息。

由于存在比图像的位数更多的有效位，Component 的 imageUpdate 方法以增量方式绘制组件上的一个图像。

若系统特性 awt.image.incrementalDraw 丢失或它的值是 true ，图象是增量方式绘制的，若系统特性有其它值，则图像直到被完全装入才被绘制。

同样，若增量绘制有效，系统特性 awt.image.redrawrate 值被解释为一个整数，该整数给出了图像的以毫秒为单位的最大重画速率。若系统特性丢失或不能解释为一个整数，重画速率是每 100 毫秒执行一次。

对 x、y、width 和 height 参数的解释取决于 infoflags 参数的值。

参数：

img - 观察的图像。

infoflags - 参见 imageUpdate 来获得更多信息。

x - x 坐标。

y - y 坐标。

width - 宽度。

height - 高度。

返回值：

若标志表示图像已完全装入，则返回 true ；否则返回 false 。

参见：

ImageObserver, drawImage, drawImage, drawImage, drawImage, imageUpdate

 public Image createImage(ImageProducer producer)

用指定图像生产者创建一个图像。

参数：

producer - 图像生产者

返回值：

产生的图像。

 public Image createImage(int width,
                          int height)

创建一个可在双重缓冲器中使用的屏幕外缓冲区可绘制的图像。

参数：

width - 指定的宽度。

height - 指定的高度。

返回值：

一个屏幕外缓冲区可绘制图像，其可用于双重缓冲器。

 public boolean prepareImage(Image image,
                                ImageObserver observer)

预备一个绘制在这个组件上的图像。在另一个线程中异步下载图像数据，并且生成图像的合适的屏幕表示。

参数：

image - 要为其准备屏幕表示的 Image 。

observer - 预备图像时通知的 ImageObserver 对象。

返回值：

若图像已经完全预备好，则返回 true ；否则返回 false 。

 public boolean prepareImage(Image image,
                             int width,
                             int height,
                             ImageObserver observer)

预备一个以指定的宽度和高度绘制在这个组件上的图像。

在另一个线程中异步下载图像数据，并生成图像的一个合适的缩放屏幕表示。

参数：

image - 要为其准备屏幕表示的 Image 实例。

width - 期望的屏幕表示的宽度。

height - 期望的屏幕表示的高度。

observer - 预备图像时通知的 ImageObserver 对象。

返回值：

若图像已经完全预备好，则为 true ；否则 false。

参见：

ImageObserver

 public int checkImage(Image image,
                                ImageObserver observer)

返回指定图像的屏幕表示结构的状态。

该方法不能使图像开始加载。一个应用必须使用 prepareImage 方法来强迫加载一个图像。

可使用 ImageObserver 接口的交互找到该方法返回的标志上的信息。

参数：

image - 状态正被检查的 Image 对象。

observer - 预备图像时通知的 ImageObserver 对象。

返回值：

ImageObserver 标志的“位异或”，它表示哪些与图像相关的信息目前是有效的 。

参见：

prepareImage, checkImage, ImageObserver

 public int checkImage(Image image,
                       int width,
                       int height,
                       ImageObserver observer)

返回指定图像的屏幕表示结构的状态。

该方法不能使图像开始加载。一个应用必须使用 prepareImage 方法来强迫加载一个图像。

Component 的 checkImage 方法调用它的同级件的 checkImage 方法来计算标志。若这个组件还没有同级件，则调用组件的工具箱的 checkImage 方法。

可使用 ImageObserver 接口的交互找到该方法返回的标志上的信息。

参数：

image - 状态正被检查的 Image 对象。

width - 要进行状态检查的缩放版本的宽度。

height - 要进行状态检查缩放版本的高度。

observer - 预备图像时通知的 ImageObserver 对象。

返回值：

ImageObserver 标志的 位异或 ，它表示哪些与图像相关的信息目前是有效的。

参见：

prepareImage, checkImage, _top_

 public boolean contains(int x,
                         int y)

检查这个组件是否“包含”指定的点，其中 x 和 y 值是相对于这个组件的坐标系而定义的。

参数：

x - 点的 x 坐标。

y - 点的 y 坐标。

参见：

getComponentAt

 public boolean inside(int x,
                       int y)

注意：不推荐使用 inside() 方法。 同 JDK 1.1 版一样，用 contains(int, int) 方法替换该方法。

 public boolean contains(Point p)

检查这个组件是否“包含”指定的点，其中，点的 x 和 y 坐标是相对于这个组件的坐标系而定义的。

参数：

p - 点。

参见：

getComponentAt

 public Component getComponentAt(int x,
                                 int y)

确定这个组件或它的一个直接子组件是否包含 (x, y) 位置，若包含，则返回包含的组件。该方法只能查看组件的一级子组件。若点 (x, y) 位于本身有子组件的子组件内，该方法不在子组件树中向下查找。

若 (x, y) 坐标位置在其边界框内，则 Component 的 locate 方法简单地返回它本身，否则返回 null 。

参数：

x - x 坐标。

y - y 坐标。

返回值：

包含 (x, y) 位置的组件或子组件；若给出位置在这个组件外，则返回 null 。

参见：

contains

 public Component locate(int x,
                         int y)

注意：不推荐使用 locete() 方法。 同 JDK 1.1 版一样，用 getComponentAt(int, int) 方法替换该方法。

 public Component getComponentAt(Point p)

返回包含指定点的组件或子组件。

参数：

p - 点。

参见：

contains

 public void deliverEvent(Event e)

注意：不推荐使用 deliverEvent() 方法。 同 JDK 1.1 版一样，用 dispatchEvent(AWTEvent e) 方法替换该方法。

 public final void dispatchEvent(AWTEvent e)

分配一个事件给这个组件或它的一个子组件。

参数：

e - 事件

 public boolean postEvent(Event e)

注意：不推荐使用 postEvrnt() 方法。 同 JDK 1.1 版一样，用 dispatchEvent(AWTEvent) 方法替换该方法。

 public synchronized void addComponentListener(ComponentListener l)

添加指定的组件监听者，接收来自这个组件的组件事件。

参数：

l - 组件监听者。

参见：

ComponentEvent, ComponentListener, removeComponentListener

 public synchronized void removeComponentListener(ComponentListener l)

删除指定的组件监听者，使其不再接收来自这个组件的组件事件。

参数：

l - 组件监听者。

参见：

ComponentEvent, ComponentListener, addComponentListener

 public synchronized void addFocusListener(FocusListener l)

加入指定的焦点监听器，接收来自这个组件的焦点事件。

参数：

l - 焦点监听者。

参见：

FocusEvent, FocusListener, removeFocusListener

 public synchronized void removeFocusListener(FocusListener l)

删除指定的焦点监听者，使其不再接收来自这个组件的焦点事件。

参数：

l - 焦点监听者。

参见：

FocusEvent, FocusListener, addFocusListener

 public synchronized void addKeyListener(KeyListener l)

添加指定的按按键监听者，接收来自这个组件的键盘事件。

参数：

l - 按按键监听者。

参见：

KeyEvent, KeyListener, removeKeyListener

 public synchronized void removeKeyListener(KeyListener l)

删除指定的按按键监听者，使其不再接收来自这个组件的键盘事件。

参数：

l - 按按键监听者。

参见：

KeyEvent, KeyListener, addKeyListener

 public synchronized void addMouseListener(MouseListener l)

添加指定的鼠标监听者，接收来自这个组件的鼠标事件。

参数：

l - 鼠标监听者。

参见：

MouseEvent, MouseListener, removeMouseListener

 public synchronized void removeMouseListener(MouseListener l)

删除指定的鼠标监听者，使其不再接收来自这个组件的鼠标事件。

参数：

l - 鼠标监听者。

参见：

MouseEvent, MouseListener, addMouseListener

 public synchronized void addMouseMotionListener(MouseMotionListener l)

添加指定的鼠标移动监听者，接收来自这个组件的鼠标移动事件。

参数：

l - 鼠标移动监听者。

参见：

MouseMotionEvent, MouseMotionListener, removeMouseMotionListener

 public synchronized void removeMouseMotionListener(MouseMotionListener l)

删除指定的鼠标移动监听者，使其不再接收来自这个组件的鼠标移动事件。

参数：

l - 鼠标移动监听者。

参见：

MouseMotionEvent, MouseMotionListener, addMouseMotionListener

 protected final void enableEvents(long eventsToEnable)

使指定的事件掩码参数定义的事件可被传送到这个组件。

当将一个事件类型的监听者添加到这个组件中时，这个事件类型自动成为可使用的。

不论是否已注册监听者，该方法只需被 Component 的子类调用，该子类希望具有传送给 processEvent 的指定事件类型。

参数：

eventsToEnable - 定义该事件类型的事件掩码。

参见：

processEvent, disableEvents

 protected final void disableEvents(long eventsToDisable)

由指定的事件屏蔽参数定义的事件被禁止传送给这个组件。

参数：

eventsToDisable - 定义该事件类型的事件掩码。

参见：

enableEvents

 protected void processEvent(AWTEvent e)

处理发生在这个组件上的事件。该方法缺省调用事件给出类的合适的 process<event type>Event 方法。

参数：

e - 事件。

参见：

processComponentEvent, processFocusEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent

 protected void processComponentEvent(ComponentEvent e)

通过将组件事件分配给任意一个已注册的 ComponentListener 对象，来处理发生在这个组件上的组件事件。

除非这个组件可以启用组件事件，否则不能调用此方法。当如下条件之一发生时，可以启用组件事件：

• 通过 addComponentListener 方法，注册一个 ComponentListener 。
• 通过 enableEvents方法，使组件事件可以启用。

参数：

e - 组件事件。

参见：

ComponentEvent, ComponentListener, addComponentListener, enableEvents

 protected void processFocusEvent(FocusEvent e)

通过将焦点事件分配给任意一个已注册的 FocusListener 对象，来处理发生在这个组件上的焦点事件。

除非这个组件可以启用焦点事件，否则不能调用此方法。当如下条件之一发生时，可以启用焦点事件：

• 通过 addFocusListener 方法，注册一个 FocusListener 对象。
• 通过 enableEvents方法，使焦点事件可以启用。

参数：

e - 焦点事件。

参见：

FocusEvent, FocusListener, addFocusListener, enableEvents

 protected void processKeyEvent(KeyEvent e)

通过将键盘事件分配给任意一个已注册的 对象，来处理发生在这个组件上的键盘事件。

除非这个组件可以启用键盘事件，否则不能调用此方法。当如下条件之一发生时，可以启用键盘事件：

• 通过 addKeyListener 方法，注册一个 KeyListener 对象。
• 通过 enableEvents 方法，使键盘事件可以启用。

参数：

e - 键盘事件。

参见：

KeyEvent, KeyListener, addKeyListener, enableEvents

 protected void processMouseEvent(MouseEvent e)

通过将鼠事件标分配给任意一个已注册的 MouseListener 对象，来处理发生在这个组件上的鼠标事件。

除非这个组件可以启用鼠标事件，否则不能调用此方法。当如下条件之一发生时，可以启用鼠标事件：

• 通过 addMouseListener 方法，注册一个 MouseListener 对象。
• 通过 enableEvents 方法，使鼠标事件可以启用。

参数：

e - 鼠标事件。

参见：

MouseEvent, MouseListener, addMouseListener, enableEvents

 protected void processMouseMotionEvent(MouseEvent e)

通过将鼠标移动事件分配给任意一个已注册的 MouseMotionListener 对象，来处理发生在这个组件上的鼠标移动事件。

除非这个组件可以启用鼠标运动事件，否则不能调用此方法。当如下条件之一发生时，可以启用鼠标运动事件：

• 通过 addMouseMotionListener 方法，注册一个 MouseMotionListener 对象。
• 通过 enableEvents 方法，使鼠标移动事件可以启用。

参数：

e - 鼠标移动事件。

参见：

MouseMotionEvent, MouseMotionListener, addMouseMotionListener, enableEvents

 public boolean handleEvent(Event evt)

注意：不推荐使用 handleEvent() 方法。 同 JDK 1.1 版一样，用 processEvent(AWTEvent) 方法替换该方法。

 public boolean mouseDown(Event evt,
                          int x,
                          int y)

注意：不推荐使用 mouseDown() 方法。 同 JDK 1.1 版一样，用 processMouseEvent(MouseEvent) 方法替换该方法。

 public boolean mouseDrag(Event evt,
                          int x,
                          int y)

注意：不推荐使用 mouseDrag() 方法。 同 JDK 1.1 版一样，用 processMouseMotionEvent(MouseEvent) 方法替换该方法。

 public boolean mouseUp(Event evt,
                        int x,
                        int y)

注意：不推荐使用 mouseUp() 方法。 同 JDK 1.1 版一样，用 processMouseEvent(MouseEvent) 方法替换该方法。

 public boolean mouseMove(Event evt,
                          int x,
                          int y)

注意：不推荐使用 mouseMove() 方法。 同 JDK 1.1 版一样，用 processMouseMotionEvent(MouseEvent) 方法替换该方法。

 public boolean mouseEnter(Event evt,
                           int x,
                           int y)

注意：不推荐使用 mouseEnter() 方法。 同 JDK 1.1 版一样，用 processMouseEvent(MouseEvent) 方法替换该方法。

 public boolean mouseExit(Event evt,
                          int x,
                          int y)

注意：不推荐使用 mouseExit() 方法。 同 JDK 1.1 版一样，用 processMouseEvent(MouseEvent) 方法替换该方法。

 public boolean keyDown(Event evt,
                     int kly

注意：不推荐使用 keyDown() 方法。 同 JDK 1.1 版一样，用 processKeyEvent(KeyEvent) 方法替换该方法。

 public boolean keyUp(Event evt,
                      int kly

注意：不推荐使用 keyUp() 方法。 同 JDK 1.1 版一样，用 processKeyEvent(KeyEvent) 方法替换该方法。

 public boolean action(Event evt,
                       Object what)

注意：不推荐使用 action() 方法。 同 JDK 1.1 版一样，应将这个组件注册为组件上激发动作事件的 ActionListener 。

 public void addNotify()

通知这个组件它已被添加到一个容器中，并且若需要它的一个同级件，则应创建它的同级件。应使用 Container.add 调用该方法，而不能由用户代码直接调用。

参见：

removeNotify

 public void removeNotify()

通知这个组件它已被从它所在的容器中删除，并且若存在它的一个同级件，则撤消同级件。应使用 Container.remove 调用该方法，而不能由用户代码直接调用。

参见：

addNotify

 public boolean gotFocus(Event evt,
                         Object what)

注意：不推荐使用 gotFocus() 方法。 同 JDK 1.1 版一样，用 processFocusEvent(FocusEvent) 方法替换该方法。

 public boolean lostFocus(Event evt,
                          Object what)

注意：不推荐使用 lostFocus() 方法。 同 JDK 1.1 版一样，用 processFocusEvent(FocusEvent) 方法替换该方法。

 public boolean isFocusTraversable()

返回表示是否可使用 Tab 或 Shift-Tab 键盘焦点遍历这个组件的标志的值。若该方法返回“ false ”，则这个组件仍可使用 requestFocus() 方法来请求键盘焦点，但它在制表符遍历期间不能自动分配焦点。

返回值：

若组件是焦点可遍历的，则返回 true ；否则返回 false 。

 public void requestFocus()

这个组件请求获得输入焦点。

当该方法成功时，调用这个组件的 gotFocus 方法。要许可该请求，组件在屏幕上必须是可见的。

参见：

FocusEvent, addFocusListener, processFocusEvent, isFocusTraversable

 public void transferFocus()

将焦点传送到下一个组件。

参见：

requestFocus, gotFocus

 public void nextFocus()

注意：不推荐使用 nextFocus() 方法。 同 JDK 1.1 版一样，用 transferFocus() 方法替换该方法。

 public synchronized void add(PopupMenu popup)

将指定的弹出式菜单添加到组件。

参数：

popup - 要添加到组件中的弹出式菜单。

参见：

remove

 public synchronized void remove(MenuComponent popup)

删除这个组件的指定的弹出式菜单。

参数：

popup - 要删除的弹出式菜单。

参见：

add

 protected String paramString()

返回表示这个组件状态的参数字符串。该字符串对调试有用。

返回值：

该事件的参数字符串。

 public String toString()

返回这个组件的字符串表示和它的值。

返回值：

这个组件的字符串表示。

覆盖：

类 Object 中的 toString

 public void list()

打印这个组件的打印清单到标准的系统输出流 System.out 。

参见：

out

 public void list(PrintStream out)

打印这个组件的打印清单到指定的输出流。

参数：

out - 打印流。

 public void list(PrintStream out,
                  int indent

打印组件清单到指定的打印流，该清单在指定缩进位置处开始。

参数：

out - 打印流。

indent - 缩进的空格数。

参见：

println

 public void list(PrintWriter out)

打印一个打印清单到指定的打印写程序。

参数：

out - 用于打印的打印写程序。

 public void list(PrintWriter out,
                  int indent)

打印一个打印清单到指定的打印写程序，该清单从指定的缩进位置处开始。

参数：

out - 用于打印的打印写程序。

indent - 缩进的空格数。

参见：

println