javatm platform
standard ed. 6

java.awt
类 component

java.lang.object 继承者 java.awt.component
所有<suǒ yǒu>已实现的接口:
imageobserver, menucontainer, serializable
直接已知子类:
button, canvas, checkbox, choice, container, label, list, scrollbar, textcomponent

public abstract class component
extends object
implements imageobserver, menucontainer, serializable

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

component 类是与菜单不相关的 abstract window toolkit 组件的抽象超类。还可以< kě yǐ>直接扩展类 component 来创建一个轻量级组件。轻量级组件是与本机不透明窗口不相关的组件。

序列化

存储对象时,仅保存那些符合 serializable 协议的 awt 侦听器,注意<危险信号>这一点很重要<zhòng yào>。如果具有侦听器的 awt 对象未标记为可序列化,则在 writeobject 时将会被丢弃。开发<developing>人员始终需要考虑序列化对象的意义<yì yì>。需要注意<危险信号>的一种情形是:
  import java.awt.*;  import java.awt.event.*;  import java.io.serializable;  class myapp implements actionlistener, serializable  {  bigobjectthatshouldnotbeserializedwithabutton bigone;  button abutton=new button();   myapp()  {  // oops, now abutton has a listener with a reference  // to bigone!  abutton.addactionlistener(this);  }  public void actionperformed(actionevent e)  {  system.out.println("hello there");  }  } 
在此示例中,通过 abutton 自身进行序列化会使得 myapp 及其引用的所有内容也都被序列化。问题<wèn tí>是,原本没打算序列化的侦听器也被同时序列化了。为分别判断 myappactionlistener 是否可序列化,可使用一个嵌套类,如下面示例所示:
  import java.awt.*;  import java.awt.event.*;  import java.io.serializable;  class myapp java.io.serializable  {   bigobjectthatshouldnotbeserializedwithabutton bigone;   button abutton=new button();   static class myactionlistener implements actionlistener   {   public void actionperformed(actionevent e)   {   system.out.println("hello there");   }   }   myapp()   {   abutton.addactionlistener(new myactionlistener());   }  } 

:有关 awt 和 swing 所用绘制机制的更多信息,包括<included>如何<how>编写最高效的绘制代码的信息,请参阅 painting in awt and swing

有关焦点子系统的详情,请参阅 the java tutorial 中的 how to use the focus subsystem 部分,以及 focus specification 了解更多信息。

另请参见:
序列化表格

嵌套类摘要
protected  classcomponent.accessibleawtcomponent
          用来为可访问<fǎng wèn>性提供默认支持<support>的 component 的内部类。
static classcomponent.baselineresizebehavior
          常见<cháng jiàn>方式的枚举,指示组件的基线可以< kě yǐ>随大小的更改而更改。
protected  classcomponent.bltbufferstrategy
          用于将屏幕外的画面以位图传输方式传输到一个组件的内部类。
protected  classcomponent.flipbufferstrategy
          在组件上翻转缓冲区的内部类。
 
字段摘要
static floatbottom_alignment
          getalignmenty 的易于使用的常量。
static floatcenter_alignment
          getalignmentygetalignmentx 的易于使用的常量。
static floatleft_alignment
          getalignmentx 的易于使用的常量。
static floatright_alignment
          getalignmentx 的易于使用的常量。
static floattop_alignment
          getalignmenty() 的易于使用的常量。
 
从接口 java.awt.image.imageobserver 继承的字段
abort, allbits, error, framebits, height, properties, somebits, width
 
构造方法摘要
protected component()
          构造一个新组件。
 
方法摘要
 booleanaction(event evt,object what)
          已过时。 从 jdk version 1.1 开始<appeared>,应该<yīng gāi>将此组件作为组件(激发动作事件)上的 actionlistener 来注册。
 voidadd(popupmenu popup)
          向组件添加指定的弹出菜单。
 voidaddcomponentlistener(componentlistener l)
          添加指定的组件侦听器,以接收发自此组件的组件事件。
 voidaddfocuslistener(focuslistener l)
          添加指定的焦点侦听器,以便当此组件获得输入焦点时能够接收发自此组件的焦点事件。
 voidaddhierarchyboundslistener(hierarchyboundslistener l)
          添加指定的层次结构边界侦听器,以便当此容器所属的层次结构发生<occasionally occurred>变化时接收发自此组件的层次结构边界事件。
 voidaddhierarchylistener(hierarchylistener l)
          添加指定的层次结构侦听器,以便当此容器所属的层次结构发生<occasionally occurred>变化时接收发自此组件的层次结构变化事件。
 voidaddinputmethodlistener(inputmethodlistener l)
          添加指定的输入方法侦听器,以接收发自此组件的输入方法事件。
 voidaddkeylistener(keylistener l)
          添加指定的按键侦听器,以接收发自此组件的按键事件。
 voidaddmouselistener(mouselistener l)
          添加指定的鼠标侦听器,以接收发自此组件的鼠标事件。
 voidaddmousemotionlistener(mousemotionlistener l)
          添加指定的鼠标移动侦听器,以接收发自此组件的鼠标移动事件。
 voidaddmousewheellistener(mousewheellistener l)
          添加指定的鼠标滚轮侦听器,以接收发自此组件的鼠标滚轮事件。
 voidaddnotify()
          通过将此 component 连接到一个本机屏幕资源使其成为<chéng wéi>可显示的。
 voidaddpropertychangelistener(propertychangelistener listener)
          向侦听器列表添加一个 propertychangelistener。
 voidaddpropertychangelistener(string propertyname,propertychangelistener listener)
          向指定属性的侦听器列表添加一个 propertychangelistener。
 voidapplycomponentorientation(componentorientation orientation)
          设置此组件及其包含的所有组件的 componentorientation 属性。
 booleanarefocustraversalkeysset(int id)
          返回是否为此 component 显式定义了给定焦点遍历操作的焦点遍历键 set。
 rectanglebounds()
          已过时。 从 jdk version 1.1 开始<appeared>,由 getbounds() 取代。
 intcheckimage(image image,imageobserver observer)
          返回指定图像屏幕表示的构造状态。
 intcheckimage(image image,int width,int height,imageobserver observer)
          返回指定图像屏幕表示的构造状态。
protected  awteventcoalesceevents(awtevent existingevent,awtevent newevent)
          将正发送的事件与现有事件组合在一起<开房去><with>。
 booleancontains(int x,int y)
          检查组件是否“包含”指定的点,其中 xy 是相对于此组件的坐标系定义的。
 booleancontains(point p)
          检查组件是否“包含”指定的点,其中该点的 xy 坐标是相对于此组件的坐标系定义的。
 imagecreateimage(imageproducer producer)
          根据指定的图像生成器创建一幅图像。
 imagecreateimage(int width,int height)
          创建一幅用于双缓冲的、可在屏幕外绘制的图像。
 volatileimagecreatevolatileimage(int width,int height)
          创建一幅用于双缓冲的、可变的、可在屏幕外绘制的图像。
 volatileimagecreatevolatileimage(int width,int height,imagecapabilities caps)
          创建一幅具有给定能力的、可变的、可在屏幕外绘制的图像。
 voiddeliverevent(event e)
          已过时。 从 jdk version 1.1 开始,由 dispatchevent(awtevent e) 取代。
 voiddisable()
          已过时。 从 jdk version 1.1 开始,由 setenabled(boolean) 取代。
protected  voiddisableevents(long eventstodisable)
          禁用由传递给此组件的指定事件掩码参数所定义的事件。
 voiddispatchevent(awtevent e)
          为组件或其子组件之一指派事件。
 voiddolayout()
          提示<tips>布局管理<guǎn lǐ>器布局此组件。
 voidenable()
          已过时。 从 jdk version 1.1 开始,由 setenabled(boolean) 取代。
 voidenable(boolean b)
          已过时。 从 jdk version 1.1 开始,由 setenabled(boolean) 取代。
protected  voidenableevents(long eventstoenable)
          启用由传递给此组件的指定事件掩码参数所定义的事件。
 voidenableinputmethods(boolean enable)
          启用或禁用此组件的输入方法支持<support>。
protected  voidfirepropertychange(string propertyname,boolean oldvalue,boolean newvalue)
          支持报告布尔属性的绑定属性改变。
 voidfirepropertychange(string propertyname,byte oldvalue,byte newvalue)
          报告绑定属性的改变。
 voidfirepropertychange(string propertyname,char oldvalue,char newvalue)
          报告绑定属性的改变。
 voidfirepropertychange(string propertyname,double oldvalue,double newvalue)
          报告绑定属性的改变。
 voidfirepropertychange(string propertyname,float oldvalue,float newvalue)
          报告绑定属性的改变。
protected  voidfirepropertychange(string propertyname,int oldvalue,int newvalue)
          支持报告整数属性的绑定属性改变。
 voidfirepropertychange(string propertyname,long oldvalue,long newvalue)
          报告绑定属性的改变。
protected  voidfirepropertychange(string propertyname,object oldvalue,object newvalue)
          支持报告 object 属性的绑定属性改变。
 voidfirepropertychange(string propertyname,short oldvalue,short newvalue)
          报告绑定属性的改变。
 accessiblecontextgetaccessiblecontext()
          获取与此 component 相关的 accessiblecontext
 floatgetalignmentx()
          返回 x 轴的对齐方式。
 floatgetalignmenty()
          返回 y 轴的对齐方式。
 colorgetbackground()
          获取组件的背景色。
 intgetbaseline(int width,int height)
          返回基线。
 component.baselineresizebehaviorgetbaselineresizebehavior()
          返回一个指示组件的基线如何<how>随大小发生更改的枚举。
 rectanglegetbounds()
          以 rectangle 对象的形式获取组件的边界。
 rectanglegetbounds(rectangle rv)
          将组件的边界存储到“返回值”rv 中并返回 rv
 colormodelgetcolormodel()
          获取用于在输出设备上显示组件的 colormodel 实例。
 componentgetcomponentat(int x,int y)
          确定此组件或其直接子组件之一是否包含(xy)位置<wèi zhi>,并且如果是,则返回包含该位置<wèi zhi>的组件。
 componentgetcomponentat(point p)
          返回包含指定点的组件或子组件。
 componentlistener[]getcomponentlisteners()
          返回在此组件上所有已注册的组件侦听器的数组。
 componentorientationgetcomponentorientation()
          检索将用于排序此组件内的元素或文本的语言敏感<gǎn>的方向。
 cursorgetcursor()
          获取组件中的光标集合。
 droptargetgetdroptarget()
          获取与此 component 相关的 droptarget
 containergetfocuscyclerootancestor()
          返回作为此 component 焦点遍历循环的焦点循环根的 container。
 focuslistener[]getfocuslisteners()
          返回在此组件上所有已注册的焦点侦听器的数组。
 set<awtkeystroke>getfocustraversalkeys(int id)
          返回此 component 的给定遍历操作的焦点遍历键 set。
 booleangetfocustraversalkeysenabled()
          返回是否已为此 component 启用了焦点遍历键。
 fontgetfont()
          获取组件的字体<zì tǐ>。
 fontmetricsgetfontmetrics(font font)
          获取指定字体<zì tǐ>的字体规格。
 colorgetforeground()
          获取组件的前景色。
 graphicsgetgraphics()
          为组件创建一个图形上下文。
 graphicsconfigurationgetgraphicsconfiguration()
          获取与此 component 相关的 graphicsconfiguration
 intgetheight()
          返回组件的当前高度< dù>。
 hierarchyboundslistener[]gethierarchyboundslisteners()
          返回在此组件上所有已注册的层次结构边界侦听器的数组。
 hierarchylistener[]gethierarchylisteners()
          返回在此组件上所有已注册的层次结构侦听器的数组。
 booleangetignorerepaint()
           
 inputcontextgetinputcontext()
          获取此组件使用的输入上下文,用于处理在此组件中输入文本时与输入方法的通信。
 inputmethodlistener[]getinputmethodlisteners()
          返回在此组件上所有已注册的输入方法侦听器的数组。
 inputmethodrequestsgetinputmethodrequests()
          获取输入方法请求处理程序,该处理程序支持此组件输入方法发出的请求。
 keylistener[]getkeylisteners()
          返回在此组件上所有已注册的按键侦听器的数组。
<t extends eventlistener>
t[]
getlisteners(class<t> listenertype)
          返回一个当前在此 component 上作为 foolistener 注册的所有对象的数组。
 localegetlocale()
          获取组件的语言环境。
 pointgetlocation()
          获取组件的位置,形式是指定组件左上角的一个点。
 pointgetlocation(point rv)
          将组件的 x,y 原点存储到“返回值” rv 中并返回 rv
 pointgetlocationonscreen()
          获取组件的位置,形式是一个指定屏幕坐标空间中组件左上角的一个点。
 dimensiongetmaximumsize()
          获取组件的最大<largest>大小。
 dimensiongetminimumsize()
          获取组件的最小<zuì xiǎo>大小。
 mouselistener[]getmouselisteners()
          返回在此组件上所有已注册的鼠标侦听器的数组。
 mousemotionlistener[]getmousemotionlisteners()
          返回在此组件上所有已注册的鼠标移动侦听器的数组。
 pointgetmouseposition()
          如果此 component 正好位于鼠标指针下,则返回鼠标指针在该 component 的坐标空间中的位置;否则返回 null
 mousewheellistener[]getmousewheellisteners()
          返回在此组件上所有已注册的鼠标滚轮侦听器的数组。
 stringgetname()
          获取组件的名称。
 containergetparent()
          获取此组件的父级。
 java.awt.peer.componentpeergetpeer()
          已过时。 从 jdk version 1.1 开始,程序不应直接操作同位体;由 boolean isdisplayable() 取代。
 dimensiongetpreferredsize()
          获取组件的首选大小。
 propertychangelistener[]getpropertychangelisteners()
          返回在此组件上所有已注册的属性更改侦听器的数组。
 propertychangelistener[]getpropertychangelisteners(string propertyname)
          返回与指定属性相关联的所有侦听器的数组。
 dimensiongetsize()
          以 dimension 对象的形式返回组件的大小。
 dimensiongetsize(dimension rv)
          将组件的宽度< dù>/高度存储到“返回值”rv 中并返回 rv
 toolkitgettoolkit()
          获取此组件的工具包。
 objectgettreelock()
          获取此组件用于 awt 组件树和布局操作的锁定对象(拥有线程同步监视器的对象)。
 intgetwidth()
          返回组件的当前宽度。
 intgetx()
          返回组件原点的当前 x 坐标。
 intgety()
          返回组件原点的当前 y 坐标。
 booleangotfocus(event evt,object what)
          已过时。 从 jdk version 1.1 开始,由 processfocusevent(focusevent) 取代。
 booleanhandleevent(event evt)
          已过时。 从 jdk version 1.1 开始,由 processevent(awtevent) 取代。
 booleanhasfocus()
          如果此 component 是焦点所有者,则返回 true
 voidhide()
          已过时。 从 jdk version 1.1 开始,由 setvisible(boolean) 取代。
 booleanimageupdate(image img,int infoflags,int x,int y,int w,int h)
          图像已改变时重绘组件。
 booleaninside(int x,int y)
          已过时。 从 jdk version 1.1 开始,由 contains(int, int) 取代。
 voidinvalidate()
          使此组件无效。
 booleanisbackgroundset()
          返回是否已为此组件显示地设置了背景色。
 booleaniscursorset()
          返回是否已为此组件显示地设置了光标。
 booleanisdisplayable()
          确定此组件是否可以显示。
 booleanisdoublebuffered()
          如果将此组件绘制到一个随后复制到屏幕上的屏幕外图像(“缓冲区”),则返回 true。
 booleanisenabled()
          确定此组件是否已启用。
 booleanisfocusable()
          返回此 component 是否可以获得焦点。
 booleanisfocuscycleroot(container container)
          返回指定的 container 是否为此 component 焦点遍历循环的焦点循环根。
 booleanisfocusowner()
          如果此 component 是焦点所有者,则返回 true
 booleanisfocustraversable()
          已过时。 从 1.4 开始,由 isfocusable() 取代。
 booleanisfontset()
          返回是否已为此组件显示地设置了字体。
 booleanisforegroundset()
          返回是否已为此组件显式地设置了前景色。
 booleanislightweight()
          轻量级组件没有本机工具包同位体。
 booleanismaximumsizeset()
          如果已将最大<largest>大小设置为非 null 值,则返回 true,否则返回 false。
 booleanisminimumsizeset()
          返回是否已用非 null 值调用了 setminimumsize
 booleanisopaque()
          如果组件是完全<wán quán>不透明的,则返回 true,默认返回 false。
 booleanispreferredsizeset()
          如果已将首选大小设置为非 null 值,则返回 true,否则返回 false。
 booleanisshowing()
          确定此组件是否在屏幕上显示。
 booleanisvalid()
          确定组件是否有效。
 booleanisvisible()
          确定此组件在其父容器可见时是否应该<yīng gāi>可见。
 booleankeydown(event evt,int key)
          已过时。 从 jdk version 1.1 开始,由 processkeyevent(keyevent) 取代。
 booleankeyup(event evt,int key)
          已过时。 从 jdk version 1.1 开始,由 processkeyevent(keyevent) 取代。
 voidlayout()
          已过时。 从 jdk version 1.1 开始,由 dolayout() 取代。
 voidlist()
          将组件列表打印到标准系统输出流 system.out
 voidlist(printstream out)
          将组件列表打印到指定的输出流。
 voidlist(printstream out,int indent)
          将列表从指定的缩排开始打印到指定的打印流。
 voidlist(printwriter out)
          将列表打印到指定的打印编写器。
 voidlist(printwriter out,int indent)
          将列表从指定的缩排开始打印到指定的打印编写器。
 componentlocate(int x,int y)
          已过时。 从 jdk version 1.1 开始,由 getcomponentat(int, int) 取代。
 pointlocation()
          已过时。 从 jdk version 1.1 开始,由 getlocation() 取代。
 booleanlostfocus(event evt,object what)
          已过时。 从 jdk version 1.1 开始,由 processfocusevent(focusevent) 取代。
 dimensionminimumsize()
          已过时。 从 jdk version 1.1 开始,由 getminimumsize() 取代。
 booleanmousedown(event evt,int x,int y)
          已过时。 从 jdk version 1.1 开始,由 processmouseevent(mouseevent) 取代。
 booleanmousedrag(event evt,int x,int y)
          已过时。 从 jdk version 1.1 开始,由 processmousemotionevent(mouseevent) 取代。
 booleanmouseenter(event evt,int x,int y)
          已过时。 从 jdk version 1.1 开始,由 processmouseevent(mouseevent) 取代。
 booleanmouseexit(event evt,int x,int y)
          已过时。 从 jdk version 1.1 开始,由 processmouseevent(mouseevent) 取代。
 booleanmousemove(event evt,int x,int y)
          已过时。 从 jdk version 1.1 开始,由 processmousemotionevent(mouseevent) 取代。
 booleanmouseup(event evt,int x,int y)
          已过时。 从 jdk version 1.1 开始,由 processmouseevent(mouseevent) 取代。
 voidmove(int x,int y)
          已过时。 从 jdk version 1.1 开始,由 setlocation(int, int) 取代。
 voidnextfocus()
          已过时。 从 jdk version 1.1 开始,由 transferfocus() 取代。
 voidpaint(graphics g)
          绘制此组件。
 voidpaintall(graphics g)
          绘制此组件及其所有子组件。
protected  stringparamstring()
          返回此组件状态的字符串表示形式。
 booleanpostevent(event e)
          已过时。 从 jdk version 1.1 开始,由 dispatchevent(awtevent) 取代。
 dimensionpreferredsize()
          已过时。 从 jdk version 1.1 开始,由 getpreferredsize() 取代。
 booleanprepareimage(image image,imageobserver observer)
          准备<zhǔn bèi>一幅在此组件上呈现的图像。
 booleanprepareimage(image image,int width,int height,imageobserver observer)
          以指定的宽度和高度准备<zhǔn bèi>一幅在此组件上呈现的图像。
 voidprint(graphics g)
          打印此组件。
 voidprintall(graphics g)
          打印此组件及其所有子组件。
protected  voidprocesscomponentevent(componentevent e)
          处理组件上发生的组件事件,方法是将其指派到任意已注册的 componentlistener 对象。
protected  voidprocessevent(awtevent e)
          处理组件上发生的事件。
protected  voidprocessfocusevent(focusevent e)
          处理组件上发生的焦点事件,方法是将其指派到任意已注册的 focuslistener 对象。
protected  voidprocesshierarchyboundsevent(hierarchyevent e)
          处理组件上发生的层次结构边界事件,方法是将其指派到任意已注册的 hierarchyboundslistener 对象。
protected  voidprocesshierarchyevent(hierarchyevent e)
          处理组件上发生的层次结构事件,方法是将其指派到任意已注册的 hierarchylistener 对象。
protected  voidprocessinputmethodevent(inputmethodevent e)
          处理组件上发生的输入方法事件,方法是将其指派到任意已注册的 inputmethodlistener 对象。
protected  voidprocesskeyevent(keyevent e)
          处理组件上发生的按键事件,方法是将其指派到任意已注册的 keylistener 对象。
protected  voidprocessmouseevent(mouseevent e)
          处理组件上发生的鼠标事件,方法是将其指派到任意已注册的 mouselistener 对象。js随机数
protected  voidprocessmousemotionevent(mouseevent e)
          处理组件上发生的鼠标移动事件,方法是将其指派到任意已注册的 mousemotionlistener 事件。
protected  voidprocessmousewheelevent(mousewheelevent e)
          处理组件上发生的鼠标滚轮事件,方法是将其指派到任意已注册的 mousewheellistener 对象。
 voidremove(menucomponent popup)
          从组件移除指定的弹出菜单。
 voidremovecomponentlistener(componentlistener l)
          移除指定的组件侦听器,以便它不再接收发自此组件的组件事件。
 voidremovefocuslistener(focuslistener l)
          移除指定的焦点侦听器,以便它不再接收发自此组件的焦点事件。
 voidremovehierarchyboundslistener(hierarchyboundslistener l)
          移除指定的层次结构边界侦听器,以便它不再接收发自此组件的层次结构边界事件。
 voidremovehierarchylistener(hierarchylistener l)
          移除指定的层次结构侦听器,以便它不再接收发自此组件的层次结构变化事件。
 voidremoveinputmethodlistener(inputmethodlistener l)
          移除指定的输入方法侦听器,以便它不再接收发自此组件的输入方法事件。
 voidremovekeylistener(keylistener l)
          移除指定的按键侦听器,以便它不再接收发自此组件的按键事件。
 voidremovemouselistener(mouselistener l)
          移除指定的鼠标侦听器,以便它不再接收发自此组件的鼠标事件。
 voidremovemousemotionlistener(mousemotionlistener l)
          移除指定的鼠标移动侦听器,以便它不再接收发自此组件的鼠标移动事件。
 voidremovemousewheellistener(mousewheellistener l)
          移除指定的鼠标滚轮侦听器,以便它不再接收发自此组件的鼠标滚轮事件。
 voidremovenotify()
          通过销毁此 component 的本机屏幕资源使其成为<chéng wéi>不可显示的。
 voidremovepropertychangelistener(propertychangelistener listener)
          从侦听器列表移除一个 propertychangelistener。
 voidremovepropertychangelistener(string propertyname,propertychangelistener listener)
          从指定属性的侦听器列表中移除一个 propertychangelistener
 voidrepaint()
          重绘此组件。
 voidrepaint(int x,int y,int width,int height)
          重绘组件的指定矩形区域<qū yù>。
 voidrepaint(long tm)
          重绘组件。
 voidrepaint(long tm,int x,int y,int width,int height)
          在 tm 毫秒内重绘组件的指定矩形区域<qū yù>。
 voidrequestfocus()
          请求此 component 获取输入焦点,并且此 component 的顶层祖先成为获得焦点的 window。
protected  booleanrequestfocus(boolean temporary)
          请求此 component 获取输入焦点,并且此 component 的顶层祖先成为获得焦点的 window
 booleanrequestfocusinwindow()
          如果此 component 的顶层祖先已经<have been>是获得焦点的 window,则请求此 component 获取输入焦点。
protected  booleanrequestfocusinwindow(boolean temporary)
          如果此 component 的顶层祖先已经<have been>是获得焦点的 window,则请求此 component 获取输入焦点。
 voidreshape(int x,int y,int width,int height)
          已过时。 从 jdk version 1.1 开始,由 setbounds(int, int, int, int) 取代。
 voidresize(dimension d)
          已过时。 从 jdk version 1.1 开始,由 setsize(dimension) 取代。
 voidresize(int width,int height)
          已过时。 从 jdk version 1.1 开始,由 setsize(int, int) 取代。
 voidsetbackground(color c)
          设置组件的背景色。
 voidsetbounds(int x,int y,int width,int height)
          移动组件并调整其大小。
 voidsetbounds(rectangle r)
          移动组件并调整其大小,使其符合新的有界矩形 r
 voidsetcomponentorientation(componentorientation o)
          设置语言敏感的方向,用于排序此组件内的元素或文本。
 voidsetcursor(cursor cursor)
          为指定的光标设置光标图像。
 voidsetdroptarget(droptarget dt)
          将组件与 droptarget 相关联。
 voidsetenabled(boolean b)
          根据参数 b 的值启用或禁用此组件。
 voidsetfocusable(boolean focusable)
          将此 component 的焦点状态设置为指定值。
 voidsetfocustraversalkeys(int id,set<? extends awtkeystroke> keystrokes)
          为此 component 的给定遍历操作设置焦点遍历键。
 voidsetfocustraversalkeysenabled(boolean focustraversalkeysenabled)
          设置是否为此 component 启用焦点遍历键。
 voidsetfont(font f)
          设置组件的字体。
 voidsetforeground(color c)
          设置组件的前景色。
 voidsetignorerepaint(boolean ignorerepaint)
          设置是否应该忽略从操作系统接受<jiē shòu>的绘制消息。
 voidsetlocale(locale l)
          设置组件的语言环境。
 voidsetlocation(int x,int y)
          将组件移到新位置。
 voidsetlocation(point p)
          将组件移到新位置。
 voidsetmaximumsize(dimension maximumsize)
          将组件的最大大小设置为常量值。
 voidsetminimumsize(dimension minimumsize)
          将组件的最小<zuì xiǎo>大小设置为常量值。
 voidsetname(string name)
          将组件的名称设置为指定的字符串。
 voidsetpreferredsize(dimension preferredsize)
          将组件的首选大小设置为常量值。
 voidsetsize(dimension d)
          调整组件的大小,使其宽度为 d.width,高度为 d.height
 voidsetsize(int width,int height)
          调整组件的大小,使其宽度为 width,高度为 height
 voidsetvisible(boolean b)
          根据参数 b 的值显示或隐藏此组件。
 voidshow()
          已过时。 从 jdk version 1.1 开始,由 setvisible(boolean) 取代。
 voidshow(boolean b)
          已过时。 从 jdk version 1.1 开始,由 setvisible(boolean) 取代。
 dimensionsize()
          已过时。 从 jdk version 1.1 开始,由 getsize() 取代。
 stringtostring()
          返回此组件及其值的字符串表示形式。
 voidtransferfocus()
          将焦点转移到下一个组件,就好像此 component 曾是焦点所有者。
 voidtransferfocusbackward()
          将焦点转移到前一个组件,就好像此 component 曾是焦点所有者。
 voidtransferfocusupcycle()
          将焦点向上转移一个焦点遍历循环。
 voidupdate(graphics g)
          更新组件。
 voidvalidate()
          确保组件具有有效的布局。
 
从类 java.lang.object 继承的方法
clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait
 

字段详细信息

top_alignment

public static final float top_alignment
getalignmenty() 的易于使用的常量。指定组件顶部对齐方式。

另请参见:
getalignmenty(),常量字段值

center_alignment

public static final float center_alignment
getalignmentygetalignmentx 的易于使用的常量。指定组件居中对齐方式。

另请参见:
getalignmentx(),getalignmenty(),常量字段值

bottom_alignment

public static final float bottom_alignment
getalignmenty 的易于使用的常量。指定组件底部对齐方式。

另请参见:
getalignmenty(),常量字段值

left_alignment

public static final float left_alignment
getalignmentx 的易于使用的常量。指定组件左对齐方式。

另请参见:
getalignmentx(),常量字段值

right_alignment

public static final float right_alignment
getalignmentx 的易于使用的常量。指定组件右对齐方式。

另请参见:
getalignmentx(),常量字段值
构造方法详细信息

component

protected component()
构造一个新组件。可以直接扩展 component 类,以便创建不利用本机不透明窗口的轻量级组件。轻量级组件必须由组件树中较高处的本机容器所承载(例如由 frame 对象承载)。

方法详细信息

getname

public string getname()
获取组件的名称。

返回:
组件的名称
从以下版本开始:
jdk1.1
另请参见:
setname(java.lang.string)

setname

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

参数:
name - 要成为组件名称的字符串。
从以下版本开始:
jdk1.1
另请参见:
getname()

getparent

public container getparent()
获取此组件的父级。

返回:
此组件的父级容器
从以下版本开始:
jdk1.0

getpeer

@deprecatedpublic java.awt.peer.componentpeer getpeer()
已过时。 从 jdk version 1.1 开始,程序不应直接操作同位体;由 boolean isdisplayable() 取代。


setdroptarget

public void setdroptarget(droptarget dt)
将组件与 droptarget 相关联。仅在已启用 component 时才接收放置。

参数:
dt - droptarget
另请参见:
isenabled()

getdroptarget

public droptarget getdroptarget()
获取与此 component 相关的 droptarget


getgraphicsconfiguration

public graphicsconfiguration getgraphicsconfiguration()
获取与此 component 相关的 graphicsconfiguration。如果尚未给 component 分配指定的 graphicsconfiguration,则返回该 component 对象顶层容器的 graphicsconfiguration。如果已经创建了 component 但尚未添加到 container 中,则此方法返回 null

返回:
component 使用的 graphicsconfiguration,或者返回 null
从以下版本开始:
1.3

gettreelock

public final object gettreelock()
获取此组件用于 awt 组件树和布局操作的锁定对象(拥有线程同步监视器的对象)。

返回:
此组件的锁定对象

gettoolkit

public toolkit gettoolkit()
获取此组件的工具包。注意,包含组件的框架控制该组件使用哪个工具包。因此<therefore>,如果组件从一个框架移到另一个框架中,那么它所使用的工具包可能<would>改变。

返回:
此组件的工具包
从以下版本开始:
jdk1.0

isvalid

public boolean isvalid()
确定组件是否有效。当组件在其父级容器内正确确定了大小和位置,并且其所有子组件也是有效的,则该组件是有效的。为了确定同位体的大小要求,组件首次显示在屏幕上时是无效的。 完全<wán quán>实现父级容器时,其所有组件将是有效的。

返回:
如果组件有效,则返回 true;否则返回 false
从以下版本开始:
jdk1.0
另请参见:
validate(),invalidate()

isdisplayable

public boolean isdisplayable()
确定此组件是否可以显示。当组件连接到一个本机屏幕资源时是可以显示的。

将组件添加到一个可显示的包含层次结构时,或者其包含层次结构变成可显示时,该组件才成为可显示的组件。当包含层次结构的祖先窗口被打包或变为可见时,它才成为可显示的。

从可显示的包含层次结构中移除某个组件,或者该组件的包含层次结构变成不可显示时,该组件就成为不可显示的组件。当包含层次结构的祖先窗口被移除时,它才变成不可显示的。

返回:
如果组件是可显示的,则返回 true;否则返回 false
从以下版本开始:
1.2
另请参见:
container.add(component),window.pack(),window.show(),container.remove(component),window.dispose()

isvisible

public boolean isvisible()
确定此组件在其父容器可见时是否应该可见。组件初始是可见的,诸如 frame 对象等顶层组件除外。

返回:
如果组件是可见的,则返回 true;否则返回 false
从以下版本开始:
jdk1.0
另请参见:
setvisible(boolean)

getmouseposition

public point getmouseposition()    throws headlessexception
如果此 component 正好位于鼠标指针下,则返回鼠标指针在该 component 的坐标空间中的位置;否则返回 null。如果屏幕上未显示 component,那么即使鼠标指针位于将显示 component 的区域之上,此方法也只是返回 null。如果 component 被其他<qí tā> component 或本机窗口所部分或完全遮掩,则仅在鼠标指针位于 component 未被遮掩的部分之上时,此方法才返回非 null 值。

对于 container,如果鼠标位于 container 本身之上或位于其后代之上时,则此方法返回非 null 值。如果需要将子容器排除在外,请使用 container.getmouseposition(boolean)

有时鼠标的准确坐标并不重要<zhòng yào>,唯一<wéi yī>重要的是指定的 component 是否位于鼠标指针下。如果此方法的返回值为 null,则鼠标指针不位于 component 的上边。

返回:
鼠标相对与此 component 的坐标,或者返回 null。
抛出:
headlessexception - 如果 graphicsenvironment.isheadless() 返回 true
从以下版本开始:
1.5
另请参见:
isshowing(),container.getmouseposition(boolean)

isshowing

public boolean isshowing()
确定此组件是否在屏幕上显示。这意味着组件必须是可见的,并且必须位于一个可见并且正在显示的容器中。

注:有时无法<to be>检测用户是否可以实际看见 component。这可能<would>发生在以下情况时:

返回:
如果正在显示组件,则返回 true;否则返回 false
从以下版本开始:
jdk1.0
另请参见:
setvisible(boolean)

isenabled

public boolean isenabled()
确定此组件是否已启用。已启用的组件可以响应用户输入并生成事件。默认情况下,组件最初是启用的。调用组件的 setenabled 方法可以启用或禁用组件。

返回:
如果组件已启用,则返回 true;否则返回 false
从以下版本开始:
jdk1.0
另请参见:
setenabled(boolean)

setenabled

public void setenabled(boolean b)
根据参数 b 的值启用或禁用此组件。已启用的组件可以响应用户输入并生成事件。默认情况下,组件最初是启用的。

注:禁用轻量级组件不会阻止其接收 mouseevents。

注:禁用重量<weight>级容器可以阻止此容器中的所有组件接收任何输入事件。但是<dàn shì>禁用重量<weight>级容器只影响此容器。

参数:
b - 如果为 true,则启用此组件;否则禁用此组件
从以下版本开始:
jdk1.1
另请参见:
isenabled(),islightweight()

enable

@deprecatedpublic void enable()
已过时。 从 jdk version 1.1 开始,由 setenabled(boolean) 取代。


enable

@deprecatedpublic void enable(boolean b)
已过时。 从 jdk version 1.1 开始,由 setenabled(boolean) 取代。


disable

@deprecatedpublic void disable()
已过时。 从 jdk version 1.1 开始,由 setenabled(boolean) 取代。


isdoublebuffered

public boolean isdoublebuffered()
如果将此组件绘制到一个随后复制到屏幕上的屏幕外图像(“缓冲区”),则返回 true。支持双缓冲的组件子类应该重写此方法,以便在启用双缓冲时返回 true。

返回:
默认返回 false

enableinputmethods

public void enableinputmethods(boolean enable)
启用或禁用此组件的输入方法支持。如果启用输入方法支持并且组件也处理按键事件,则将传入的事件提供给当前的输入方法,并且如果输入方法没有使用它们,则仅由组件处理或指派给其侦听器。默认情况下启用输入方法支持。

参数:
enable - true 表示启用,false 表示禁用
从以下版本开始:
1.2
另请参见:
processkeyevent(java.awt.event.keyevent)

setvisible

public void setvisible(boolean b)
根据参数 b 的值显示或隐藏此组件。

参数:
b - 如果为 true,则显示此组件;否则隐藏此组件
从以下版本开始:
jdk1.1
另请参见:
isvisible()

show

@deprecatedpublic void show()
已过时。 从 jdk version 1.1 开始,由 setvisible(boolean) 取代。


show

@deprecatedpublic void show(boolean b)
已过时。 从 jdk version 1.1 开始,由 setvisible(boolean) 取代。


hide

@deprecatedpublic void hide()
已过时。 从 jdk version 1.1 开始,由 setvisible(boolean) 取代。


getforeground

public color getforeground()
获取组件的前景色。

返回:
组件的前景色;如果此组件没有前景色,则返回其父级的前景色
从以下版本开始:
jdk1.0
另请参见:
setforeground(java.awt.color)

setforeground

public void setforeground(color c)
设置组件的前景色。

参数:
c - 要成为此组件前景色的颜色;如果此参数为 null,则此组件继承其父级的前景色
从以下版本开始:
jdk1.0
另请参见:
getforeground()

isforegroundset

public boolean isforegroundset()
返回是否已为此组件显式地设置了前景色。如果此方法返回 false,则此组件继承了其祖先的前景色。

返回:
如果已为此组件显示地设置了前景色,则返回 true;否则返回 false
从以下版本开始:
1.4

getbackground

public color getbackground()
获取组件的背景色。

返回:
组件的背景色;如果此组件没有背景色,则返回其父级的背景色
从以下版本开始:
jdk1.0
另请参见:
setbackground(java.awt.color)

setbackground

public void setbackground(color c)
设置组件的背景色。

背景色对每个组件的影响各不相同,并且部分受背景色影响的组件在不同的操作系统之间可能有所不同。

参数:
c - 要成为此组件背景色的颜色;如果此参数为 null,则此组件继承其父级的背景色
从以下版本开始:
jdk1.0
另请参见:
getbackground()

isbackgroundset

public boolean isbackgroundset()
返回是否已为此组件显示地设置了背景色。如果此方法返回 false,则此组件继承了其祖先的背景色。

返回:
如果已为此组件显示地设置了背景色,则返回 true;否则返回 false
从以下版本开始:
1.4

getfont

public font getfont()
获取组件的字体。

指定者:
接口 menucontainer 中的 getfont
返回:
组件的字体;如果此组件未设置字体,则返回其父级的字体
从以下版本开始:
jdk1.0
另请参见:
setfont(java.awt.font)

setfont

public void setfont(font f)
设置组件的字体。

参数:
f - 要成为此组件字体的字体;如果此参数为 null,则此组件继承其父级的字体
从以下版本开始:
jdk1.0
另请参见:
getfont()

isfontset

public boolean isfontset()
返回是否已为此组件显示地设置了字体。如果此方法返回 false,则此组件继承了其祖先的字体。

返回:
如果已为此组件显示地设置了字体,则返回 true;否则返回 false
从以下版本开始:
1.4

getlocale

public locale getlocale()
获取组件的语言环境。

返回:
组件的语言环境;如果此组件没有语言环境,则返回其父级的语言环境
抛出:
illegalcomponentstateexception - 如果 component 没有其自己<zì jǐ>的语言环境,并且尚未添加到包含层次结构中(如果添加到包含层次结构中就可以从其包含父级确定语言环境)
从以下版本开始:
jdk1.1
另请参见:
setlocale(java.util.locale)

setlocale

public void setlocale(locale l)
设置组件的语言环境。这是一个绑定 (bound) 属性。

参数:
l - 要成为此组件语言环境的语言环境
从以下版本开始:
jdk1.1
另请参见:
getlocale()

getcolormodel

public colormodel getcolormodel()
获取用于在输出设备上显示组件的 colormodel 实例。

返回:
组件使用的颜色模型
从以下版本开始:
jdk1.0
另请参见:
colormodel,componentpeer.getcolormodel(),toolkit.getcolormodel()

getlocation

public point getlocation()
获取组件的位置,形式是指定组件左上角的一个点。该位置是相对于父级坐标空间的。

由于<yóu yú>本机事件处理的异步特性,所以此方法可能返回过时的值(例如,在快速连续调用 setlocation() 后)。为此,推荐获得组件位置的方法是在 java.awt.event.componentlistener.componentmoved() 内,在操作系统结束<jié shù>组件移动后调用它。

返回:
一个 point 实例,表示在组件父级坐标空间中组件边界的左上角
从以下版本开始:
jdk1.1
另请参见:
setlocation(int, int),getlocationonscreen()

getlocationonscreen

public point getlocationonscreen()
获取组件的位置,形式是一个指定屏幕坐标空间中组件左上角的一个点。

返回:
一个 point 实例,表示在屏幕坐标空间中组件边界的左上角
抛出:
illegalcomponentstateexception - 如果屏幕上未显示该组件
另请参见:
setlocation(int, int),getlocation()

location

@deprecatedpublic point location()
已过时。 从 jdk version 1.1 开始,由 getlocation() 取代。


setlocation

public void setlocation(int x,    int y)
将组件移到新位置。通过此组件父级坐标空间中的 xy 参数来指定新位置的左上角。

参数:
x - 父级坐标空间中新位置左上角的 x 坐标
y - 父级坐标空间中新位置左上角的 y 坐标
从以下版本开始:
jdk1.1
另请参见:
getlocation(),setbounds(int, int, int, int)

move

@deprecatedpublic void move(int x,      int y)
已过时。 从 jdk version 1.1 开始,由 setlocation(int, int) 取代。


setlocation

public void setlocation(point p)
将组件移到新位置。通过点 p 来指定新位置的左上角。在父级坐标空间中给出点 p

参数:
p - 定义新位置左上角的点,在此组件的父级坐标空间中给出
从以下版本开始:
jdk1.1
另请参见:
getlocation(),setbounds(int, int, int, int)

getsize

public dimension getsize()
dimension 对象的形式返回组件的大小。dimension 对象的 height 字段包含此组件的高度,而 dimension 对象的 width 字段则包含此组件的宽度。

返回:
表示组件大小的 dimension 对象
从以下版本开始:
jdk1.1
另请参见:
setsize(int, int)

size

@deprecatedpublic dimension size()
已过时。 从 jdk version 1.1 开始,由 getsize() 取代。


setsize

public void setsize(int width,    int height)
调整组件的大小,使其宽度为 width,高度为 height

参数:
width - 组件的新宽度,单位是像素
height - 组件的新高度,单位是像素
从以下版本开始:
jdk1.1
另请参见:
getsize(),setbounds(int, int, int, int)

resize

@deprecatedpublic void resize(int width,     int height)
已过时。 从 jdk version 1.1 开始,由 setsize(int, int) 取代。


setsize

public void setsize(dimension d)
调整组件的大小,使其宽度为 d.width,高度为 d.height

参数:
d - 指定组件新大小的尺寸
从以下版本开始:
jdk1.1
另请参见:
setsize(int, int),setbounds(int, int, int, int)

resize

@deprecatedpublic void resize(dimension d)
已过时。 从 jdk version 1.1 开始,由 setsize(dimension) 取代。


getbounds

public rectangle getbounds()
rectangle 对象的形式获取组件的边界。边界指定此组件的宽度、高度和相对于其父级的位置。

返回:
表示组件边界的矩形
另请参见:
setbounds(int, int, int, int),getlocation(),getsize()

bounds

@deprecatedpublic rectangle bounds()
已过时。 从 jdk version 1.1 开始,由 getbounds() 取代。


setbounds

public void setbounds(int x,     int y,     int width,     int height)
移动组件并调整其大小。由 xy 指定左上角的新位置,由 widthheight 指定新的大小。

参数:
x - 组件的新 x 坐标
y - 组件的新 y 坐标
width - 组件的新 width
height - 组件的新 height
从以下版本开始:
jdk1.1
另请参见:
getbounds(),setlocation(int, int),setlocation(point),setsize(int, int),setsize(dimension)

reshape

@deprecatedpublic void reshape(int x,      int y,      int width,      int height)
已过时。 从 jdk version 1.1 开始,由 setbounds(int, int, int, int) 取代。


setbounds

public void setbounds(rectangle r)
移动组件并调整其大小,使其符合新的有界矩形 r。由 r.xr.y 指定组件的新位置,由 r.widthr.height 指定组件的新大小

参数:
r - 此组件的新的有界矩形
从以下版本开始:
jdk1.1
另请参见:
getbounds(),setlocation(int, int),setlocation(point),setsize(int, int),setsize(dimension)

getx

public int getx()
返回组件原点的当前 x 坐标。此方法优于 component.getbounds().xcomponent.getlocation().x 方法,因为它不会导致任何的堆分配。

返回:
组件原点的当前 x 坐标
从以下版本开始:
1.2

gety

public int gety()
返回组件原点的当前 y 坐标。此方法优于 component.getbounds().ycomponent.getlocation().y 方法,因为它不会导致任何的堆分配。

返回:
组件原点的当前 y 坐标
从以下版本开始:
1.2

getwidth

public int getwidth()
返回组件的当前宽度。此方法优于 component.getbounds().widthcomponent.getlocation().width 方法,因为它不会导致任何的堆分配。

返回:
组件的当前宽度
从以下版本开始:
1.2

getheight

public int getheight()
返回组件的当前高度。此方法优于 component.getbounds().heightcomponent.getsize().height 方法,因为它不会导致任何的堆分配。

返回:
组件的当前高度
从以下版本开始:
1.2

getbounds

public rectangle getbounds(rectangle rv)
将组件的边界存储到“返回值”rv 中并返回 rv。如果 rv 为 null,则分配一个新的 rectangle。如果调用者想要避免在堆上分配一个新的 rectangle 对象,则此版本的 getbounds 是很有用的。

参数:
rv - 返回值,被修改为组件的边界
返回:
rv

getsize

public dimension getsize(dimension rv)
将组件的宽度/高度存储到“返回值”rv 中并返回 rv。如果 rv 为 null,则分配一个新的 dimension 对象。如果调用者想要避免在堆上分配一个新的 dimension 对象,则此版本的 getsize 是很有用的。

参数:
rv - 返回值,被修改为组件的大小
返回:
rv

getlocation

public point getlocation(point rv)
将组件的 x,y 原点存储到“返回值” rv 中并返回 rv。如果 rv 为 null,则分配一个新的 point。如果调用者想要避免在堆上分配一个新的 point 对象,则此版本的 getlocation 是很有用的。

参数:
rv - 返回值,被修改为组件的位置
返回:
rv

isopaque

public boolean isopaque()
如果组件是完全不透明的,则返回 true,默认返回 false。

不透明组件将每个像素绘制在其矩形区域内。透明的组件则仅绘制其某些像素,允许<yǔn xǔ>其下面的像素“透视出来”。因此<therefore>,没有完全绘制其像素的组件则提供了一定程度的透明度。只有轻量级组件可以是透明的。

保证总是完全绘制其内容的子类应该重写此方法并返回 true。所有“重量级”awt 组件都是不透明的。

返回:
如果组件是完全不透明的,则返回 true
从以下版本开始:
1.2
另请参见:
islightweight()

islightweight

public boolean islightweight()
轻量级组件没有本机工具包同位体。除了在此包中定义的、像 buttonscrollbar 那些组件以外,componentcontainer 的子类都是轻量级组件。所有 swing 组件是轻量级组件。

如果组件是不可显示的,那么由于<yóu yú>无法<to be>确定不可显示的组件是轻量级还是重量级的,所以此方法总是返回 false

返回:
如果组件有一个轻量级同位体,则返回 true;如果有一个本机同位体或没有同位体,则返回 false
从以下版本开始:
1.2
另请参见:
isdisplayable()

setpreferredsize

public void setpreferredsize(dimension
我在这里的时间不长,但和我妻子结婚的44年中,却常常提起在这里发生的一切
,台北市长柯文哲也上网拍卖自己<zì jǐ>曾穿过的66号签名球衣,将给少棒队当加菜金
毛嘉庆也说,这是对话被拿出来炒作,还刻意将时间错置,未来愿意在任何政论节目上与王时齐针对此事对质
警方调查发现,53岁的张姓砂石车驾驶,12日从台中载货到土库,?时富爻淌碧巴挤奖悖145线公路土库公墓前路段直接违规转,挡住了大片道路
这场仪式由国务卿凯瑞(John Kerry)主持,虽然他预计不会与领导人劳尔?卡斯楚(Raul Castro)见面,但却是70年来首度有国务卿访问<fǎng wèn>古巴
 preferredsize)
将组件的首选大小设置为常量值。对 getpreferredsize 的后续调用总是返回此值。将首选大小设置为 null 可还原默认的行为。

参数:
preferredsize - 新的首选大小,或者为 null
从以下版本开始:
1.5
另请参见:
getpreferredsize(),ispreferredsizeset()

ispreferredsizeset

public boolean ispreferredsizeset()
如果已将首选大小设置为非 null 值,则返回 true,否则返回 false。

返回:
如果已经用非 null 值调用了 setpreferredsize,则返回 true。
从以下版本开始:
1.5

getpreferredsize

public dimension getpreferredsize()
获取组件的首选大小。

返回:
一个表示组件首选大小的 dimension 对象
另请参见:
getminimumsize(),layoutmanager

preferredsize

@deprecatedpublic dimension preferredsize()
已过时。 从 jdk version 1.1 开始,由 getpreferredsize() 取代。


setminimumsize

public void setminimumsize(dimension minimumsize)
将组件的最小大小设置为常量值。对 getminimumsize 的后续调用总是返回此值。将最小大小设置为 null 可还原默认的行为。

参数:
minimumsize - 组件新的最小大小
从以下版本开始:
1.5
另请参见:
getminimumsize(),isminimumsizeset()

isminimumsizeset

public boolean isminimumsizeset()
返回是否已用非 null 值调用了 setminimumsize

返回:
如果已经用非 null 值调用了 setminimumsize,则返回 true。
从以下版本开始:
1.5

getminimumsize

public dimension getminimumsize()
获取组件的最小大小。

返回:
一个表示组件最小大小的 dimension 对象
另请参见:
getpreferredsize(),layoutmanager

minimumsize

@deprecatedpublic dimension minimumsize()
已过时。 从 jdk version 1.1 开始,由 getminimumsize() 取代。


setmaximumsize

public void setmaximumsize(dimension maximumsize)
将组件的最大大小设置为常量值。对 getmaximumsize 的后续调用总是返回此值。将最大大小设置为 null 可还原默认的行为。

参数:
maximumsize - 一个包含所需最大允许<yǔn xǔ>大小的 dimension
从以下版本开始:
1.5
另请参见:
getmaximumsize(),ismaximumsizeset()

ismaximumsizeset

public boolean ismaximumsizeset()
如果已将最大大小设置为非 null 值,则返回 true,否则返回 false。

返回:
如果 maximumsize 是非 null 值,则返回 true,否则返回 false
从以下版本开始:
1.5

getmaximumsize

public dimension getmaximumsize()
获取组件的最大大小。

返回:
一个表示组件最大大小的 dimension 对象
另请参见:
getminimumsize(),getpreferredsize(),layoutmanager

getalignmentx

public float getalignmentx()
返回 x 轴的对齐方式。指定组件相对于其他<qí tā>组件的对齐方式。值应该是 0 到 1 之间的数,其中 0 代表与原点对齐,1 代表距离原点最远处对齐,0.5 代表居中等。


getalignmenty

public float getalignmenty()
返回 y 轴的对齐方式。指定组件相对于其他组件的对齐方式。值应该是 0 到 1 之间的数,其中 0 代表与原点对齐,1 代表距离原点最远处对齐,0.5 代表居中等。


getbaseline

public int getbaseline(int width,    int height)
返回基线。基线是从组件的顶部测量的。此方法主要<zhǔ yào>用于 layoutmanager,以便沿组件的基线对齐组件。返回值小于 0 表示此组件没有合理的基线,layoutmanager 不应该根据该组件的基线来对齐此组件。

默认实现返回 -1。支持基线的子类应该适当重写。如果返回值 >=0,则该组件有一个对于 >=最小大小的任何大小有效的基线,并且可以使用 getbaselineresizebehavior 确定基线如何随大小发生更改。

参数:
width - 适合基线的宽度
height - 适合基线的高度
返回:
基线,如果基线 < 0,则表示没有合理的基线
抛出:
illegalargumentexception - 如果 width 或 height < 0
从以下版本开始:
1.6
另请参见:
getbaselineresizebehavior(),fontmetrics

getbaselineresizebehavior

public component.baselineresizebehavior getbaselineresizebehavior()
返回一个指示组件的基线如何随大小发生更改的枚举。此方法主要<zhǔ yào>适用于布局管理<guǎn lǐ>器和 gui 生成器。

默认实现返回 baselineresizebehavior.other。拥有基线的子类应该适当重写。子类永远不应该返回 null;如果无法计算基线,则返回 baselineresizebehavior.other。调用者应该首先查询使用 getbaseline 的基线,如果返回值 >=0,则使用此方法。如果此方法返回一个不同于 baselineresizebehavior.other 的值,即使 getbaseline 返回一个小于 0 的值,也是可接受<jiē shòu>的。

返回:
一个指示基线如何随组件大小的更改发生变化的枚举
从以下版本开始:
1.6
另请参见:
getbaseline(int, int)

dolayout

public void dolayout()
提示<tips>布局管理器布局此组件。通常在验证组件(更明确地说是容器)时调用。

另请参见:
validate(),layoutmanager

layout

@deprecatedpublic void layout()
已过时。 从 jdk version 1.1 开始,由 dolayout() 取代。


validate

public void validate()
确保组件具有有效的布局。此类主要适用于在 container 实例上进行操作。

从以下版本开始:
jdk1.0
另请参见:
invalidate(),dolayout(),layoutmanager,container.validate()

invalidate

public void invalidate()
使此组件无效。此组件及其上所有父组件都标记为需要进行布局。此方法经常被调用,所以需要其快速执行。

从以下版本开始:
jdk1.0
另请参见:
validate(),dolayout(),layoutmanager

getgraphics

public graphics getgraphics()
为组件创建一个图形上下文。如果组件当前是不可显示的,则此方法返回 null

返回:
组件的图形上下文,如果其没有,则返回 null
从以下版本开始:
jdk1.0
另请参见:
paint(java.awt.graphics)

getfontmetrics

public fontmetrics getfontmetrics(font font)
获取指定字体的字体规格。警告:因为 font 规格受 fontrendercontext 影响,并且此方法不返回任何字体规格,所以可以只返回适用于默认呈现上下文的规格,该规格可能与呈现在 component 上时使用的规格不匹配(如果使用 graphics2d 功能)。相反,可以在呈现时通过调用 graphics.getfontmetrics()font 类上的文本测量 api 获得规格。

参数:
font - 要获得其字体规格的字体
返回:
font 的字体规格
从以下版本开始:
jdk1.0
另请参见:
getfont(),getpeer(),componentpeer.getfontmetrics(font),toolkit.getfontmetrics(font)

setcursor

public void setcursor(cursor cursor)
为指定的光标设置光标图像。当此组件的 contains 方法为当前的光标位置返回 ture,并且此组件是可见的、可显示的并且已启用的,则显示此光标图像。设置 container 的光标会导致在该容器的所有子组件内显示该光标,那些具有非 null 的光标除外。

如果 java 平台实现和/或本机系统不支持更改鼠标光标形状,则该方法可能不会产生任何视觉效果。

参数:
cursor - cursor 类定义的常量之一;如果此参数为 null,则此组件继承其父级的光标
从以下版本开始:
jdk1.1
另请参见:
isenabled(),isshowing(),getcursor(),contains(int, int),toolkit.createcustomcursor(java.awt.image, java.awt.point, java.lang.string),cursor

getcursor

public cursor getcursor()
获取组件中的光标集合。如果组件没有光标集合,则返回其父级的光标。如果整个层次结构中都没有设置光标,则返回 cursor.default_cursor

从以下版本开始:
jdk1.1
另请参见:
setcursor(java.awt.cursor)

iscursorset

public boolean iscursorset()
返回是否已为此组件显示地设置了光标。如果此方法返回 false,则此组件继承了其祖先的光标。

返回:
如果已为此组件显示地设置了光标,则返回 true;否则返回 false
从以下版本开始:
1.4

paint

public void paint(graphics g)
绘制此组件。

应该绘制组件的内容时调用此方法;例如首次显示组件或者组件已损坏并需要修复时。graphics 参数中的剪贴区矩形设置为需要绘制的区域。重写此方法的 component 子类不需要调用 super.paint(g)

出于性能的考虑,首次显示宽度或高度为 0 的 component 时认为它不需要进行绘制,并且也不需要修复。

:有关 awt 和 swing 所用绘制机制的更多信息,包括<included>如何编写最高效的绘制代码的信息,请参阅 painting in awt and swing

参数:
g - 用于绘制的图像上下文
从以下版本开始:
jdk1.0
另请参见:
update(java.awt.graphics)

update

public void update(graphics g)
更新组件。

如果此组件不是轻量级组件,则为了响应对 repaint 的调用,awt 调用 update 方法。可以假定未清除背景。

componentupdate 方法调用此组件的 paint 方法来重绘此组件。为响应对 repaint 的调用而需要其他工作<work>的子类通常重写此方法。重写此方法的 component 子类应该调用 super.update(g),或者直接从其 update 方法中调用 paint(g)

图形上下文的原点,即它的(00)坐标点是此组件的左上角。图形上下文的剪贴区域是此组件的边界矩形。

:有关 awt 和 swing 所用绘制机制的更多信息,包括如何编写最高效的绘制代码的信息,请参阅 painting in awt and swing

参数:
g - 用于更新的指定上下文
从以下版本开始:
jdk1.0
另请参见:
paint(java.awt.graphics),repaint()

paintall

public void paintall(graphics g)
绘制此组件及其所有子组件。

图形上下文的原点,即它的(00)坐标点是此组件的左上角。图形上下文的剪贴区域是此组件的边界矩形。

参数:
g - 用于绘制的图形上下文
从以下版本开始:
jdk1.0
另请参见:
paint(java.awt.graphics)

repaint

public void repaint()
重绘此组件。

如果此组件是轻量级组件,则此方法会尽快调用此组件的 paint 方法。否则此方法会尽快调用此组件的 update 方法。

:有关 awt 和 swing 所用绘制机制的更多信息,包括如何编写最高效的绘制代码的信息,请参阅 painting in awt and swing

从以下版本开始:
jdk1.0
另请参见:
update(graphics)

repaint

public void repaint(long tm)
重绘组件。如果此组件是轻量级组件,则会导致在 tm 毫秒内调用 paint

:有关 awt 和 swing 所用绘制机制的更多信息,包括如何编写最高效的绘制代码的信息,请参阅 painting in awt and swing

参数:
tm - 更新前等待的最长时间(以毫秒为单位)
从以下版本开始:
jdk1.0
另请参见:
paint(java.awt.graphics),update(graphics)

repaint

public void repaint(int x,    int y,    int width,    int height)
重绘组件的指定矩形区域。

如果此组件是轻量级组件,则此方法会尽快调用此组件的 paint 方法。否则此方法会尽快调用此组件的 update 方法。

:有关 awt 和 swing 所用绘制机制的更多信息,包括如何编写最高效的绘制代码的信息,请参阅 painting in awt and swing

参数:
x - x 坐标
y - y 坐标
width - 宽度
height - 高度
从以下版本开始:
jdk1.0
另请参见:
update(graphics)

repaint

public void repaint(long tm,    int x,    int y,    int width,    int height)
tm 毫秒内重绘组件的指定矩形区域。

如果此组件是轻量级组件,则此方法调用此组件的 paint 方法。否则此方法调用此组件的 update 方法。

:有关 awt 和 swing 所用绘制机制的更多信息,包括如何编写最高效的绘制代码的信息,请参阅 painting in awt and swing

参数:
tm - 更新前等待的最长时间(以毫秒为单位)
x - x 坐标
y - y 坐标
width - 宽度
height - 高度
从以下版本开始:
jdk1.0
另请参见:
update(graphics)

print

public void print(graphics g)
打印此组件。对于打印前必须进行特殊处理或打印内容不同于绘制内容的组件,应用程序应该重写此方法。

此方法的默认实现调用 paint 方法。

图形上下文的原点,即它的(00)坐标点是此组件的左上角。图形上下文的剪贴区域是此组件的边界矩形。

参数:
g - 用于绘制的图形上下文
从以下版本开始:
jdk1.0
另请参见:
paint(graphics)

printall

public void printall(graphics g)
打印此组件及其所有子组件。

图形上下文的原点,即它的(00)坐标点是此组件的左上角。图形上下文的剪贴区域是此组件的边界矩形。

参数:
g - 用于打印的图形上下文
从以下版本开始:
jdk1.0
另请参见:
print(graphics)

imageupdate

public boolean imageupdate(image img,      int infoflags,      int x,      int y,      int w,      int h)
图像已改变时重绘组件。当有关图像的更多信息可用时调用 imageobserverimageupdate 方法,该图像是以前使用诸如 graphicsdrawimage 方法等此类异步例程请求的。有关此方法及其参数的更多信息,请参阅 imageupdate 的定义。

随着<Along with>有更多的可用图像位,componentimageupdate 方法在组件上逐渐绘制图像。

如果系统属性 awt.image.incrementaldraw 丢失或其值为 true,则逐渐绘制图像。如果该系统属性为其他值,则在完全加载图像后才绘制它。

另外,如果是逐渐绘制图像,则将系统属性 awt.image.redrawrate 的值解释为一个整数,得到一个最快的重绘速率,单位是毫秒。如果该系统属性丢失或无法解释为一个整数,则重绘速率是每 100ms 一次。

xywidthheight 参数的解释取决于 infoflags 参数值。

指定者:
接口 imageobserver 中的 imageupdate
参数:
img - 正观察的图像
infoflags - 有关更多信息,请参阅 imageupdate
x - x 坐标
y - y 坐标
w - 宽度
h - 高度
返回:
如果 infoflags 表明已完全加载了图像,则返回 false;否则返回 true
从以下版本开始:
jdk1.0
另请参见:
imageobserver,graphics.drawimage(image, int, int, color, java.awt.image.imageobserver),graphics.drawimage(image, int, int, java.awt.image.imageobserver),graphics.drawimage(image, int, int, int, int, color, java.awt.image.imageobserver),graphics.drawimage(image, int, int, int, int, java.awt.image.imageobserver),imageobserver.imageupdate(java.awt.image, int, int, int, int, int)

createimage

public image createimage(imageproducer producer)
根据指定的图像生成器创建一幅图像。

参数:
producer - 图像生成器
返回:
生成的图像
从以下版本开始:
jdk1.0

createimage

public image createimage(int width,     int height)
创建一幅用于双缓冲的、可在屏幕外绘制的图像。

参数:
width - 指定的宽度
height - 指定的高度
返回:
一幅屏幕外可绘制的图像,可用于双缓冲。如果组件是不可显示的,则返回值可能为 null。如果 graphicsenvironment.isheadless() 返回 true,则始终发生这种情况。
从以下版本开始:
jdk1.0
另请参见:
isdisplayable(),graphicsenvironment.isheadless()

createvolatileimage

public volatileimage createvolatileimage(int width,       int height)
创建一幅用于双缓冲的、可变的、可在屏幕外绘制的图像。

参数:
width - 指定的宽度。
height - 指定的高度。
返回:
一幅屏幕外可绘制的图像,可用于双缓冲。如果组件是不可显示的,则返回值可能为 null。如果 graphicsenvironment.isheadless() 返回 true,则始终发生这种情况。
从以下版本开始:
1.4
另请参见:
volatileimage,isdisplayable(),graphicsenvironment.isheadless()

createvolatileimage

public volatileimage createvolatileimage(int width,       int height,       imagecapabilities caps)       throws awtexception
创建一幅具有给定能力的、可变的、可在屏幕外绘制的图像。由于操作系统的问题<wèn tí>,此图像的内容可在任意时间丢失,所以必须通过 volatileimage 接口管理该图像。

参数:
width - 指定的宽度。
height - 指定的高度。
caps - 图像的能力
返回:
一个 volatileimage 对象,可用于管理图面内容丢失和能力。
抛出:
awtexception - 如果无法创建具有指定能力的图像
从以下版本开始:
1.4
另请参见:
volatileimage

prepareimage

public boolean prepareimage(image image,      imageobserver observer)
准备一幅在此组件上呈现的图像。图像数据由另一个线程异步下载并生成适当的图像屏幕表示。

参数:
image - 准备进行屏幕表示的 image
observer - 图像准备就绪时所要通知<supercup>的 imageobserver 对象
返回:
如果图像已经完全准备好,则返回 true;否则返回 false
从以下版本开始:
jdk1.0

prepareimage

public boolean prepareimage(image image,      int width,      int height,      imageobserver observer)
以指定的宽度和高度准备一幅在此组件上呈现的图像。

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

参数:
image - 准备进行屏幕表示的 image 实例
width - 所需屏幕表示的宽度
height - 所需屏幕表示的高度
observer - 图像准备就绪时所要通知<supercup>的 imageobserver 对象
返回:
如果图像已经完全准备好,则返回 true;否则返回 false
从以下版本开始:
jdk1.0
另请参见:
imageobserver

checkimage

public int checkimage(image image,     imageobserver observer)
返回指定图像屏幕表示的构造状态。

此方法不会使图像开始加载。应用程序必须使用 prepareimage 方法强制加载图像。

可在 imageobserver 接口的讨论<discussion>中找到有关此方法返回的标志的信息。

参数:
image - 正检查其状态的 image 对象
observer - 图像准备就绪时所要通知的 imageobserver 对象
返回:
imageobserver 的标志按位进行 or 运算后的结果,指示图像的哪些信息是当前可用的
从以下版本开始:
jdk1.0
另请参见:
prepareimage(image, int, int, java.awt.image.imageobserver),toolkit.checkimage(image, int, int, java.awt.image.imageobserver),imageobserver

checkimage

public int checkimage(image image,     int width,     int height,     imageobserver observer)
返回指定图像屏幕表示的构造状态。

此方法不会使图像开始加载。应用程序必须使用 prepareimage 方法强制加载图像。

componentcheckimage 方法调用其同位体的 checkimage 方法来计算标志。如果此组件还没有同位体,则调用组件工具包的 checkimage 方法。

可在 imageobserver 接口的讨论<discussion>中找到有关此方法返回的标志的信息。

参数:
image - 正检查其状态的 image
width - 要检查其状态的缩放图像的宽度
height - 要检查其状态的缩放图像的高度
observer - 图像准备就绪时所要通知的 imageobserver 对象
返回:
imageobserver 的标志按位进行 or 运算后的结果,指示图像的哪些信息是当前可用的
从以下版本开始:
jdk1.0
另请参见:
prepareimage(image, int, int, java.awt.image.imageobserver),toolkit.checkimage(image, int, int, java.awt.image.imageobserver),imageobserver

setignorerepaint

public void setignorerepaint(boolean ignorerepaint)
设置是否应该忽略从操作系统接受的绘制消息。这不会影响 awt 在软件中生成的绘制事件,除非它们是对操作系统级别绘制消息的直接响应。

这是很有用的,例如正在全屏模式中运行并且需要更佳的性能,或者使用页面翻转作为缓冲策略时。

从以下版本开始:
1.4
另请参见:
getignorerepaint(),canvas.createbufferstrategy(int),window.createbufferstrategy(int),bufferstrategy,graphicsdevice.setfullscreenwindow(java.awt.window)

getignorerepaint

public boolean getignorerepaint()
返回:
是否应该忽略接收操作系统发出的绘制消息。
从以下版本开始:
1.4
另请参见:
setignorerepaint(boolean)

contains

public boolean contains(int x,    int y)
检查组件是否“包含”指定的点,其中 xy 是相对于此组件的坐标系定义的。

参数:
x - 该点的 x 坐标
y - 该点的 y 坐标
从以下版本开始:
jdk1.1
另请参见:
getcomponentat(int, int)

inside

@deprecatedpublic boolean inside(int x,       int y)
已过时。 从 jdk version 1.1 开始,由 contains(int, int) 取代。


contains

public boolean contains(point p)
检查组件是否“包含”指定的点,其中该点的 xy 坐标是相对于此组件的坐标系定义的。

参数:
p - 点
从以下版本开始:
jdk1.1
另请参见:
getcomponentat(point)

getcomponentat

public component getcomponentat(int x,      int y)
确定此组件或其直接子组件之一是否包含(xy)位置,并且如果是,则返回包含该位置的组件。此方法仅查找一层子组件。如果点(xy)处于某个子组件内部,而该子组件本身也有子组件,则此方法不向下查找子组件树。

如果(xy)坐标位置处于组件边界框的内部,则 componentlocate 方法只是简单地返回组件本身;否则返回 null

参数:
x - x 坐标
y - y 坐标
返回:
包含(xy)位置的组件或子组件;如果该位置位于此组件外部,则返回 null
从以下版本开始:
jdk1.0
另请参见:
contains(int, int)

locate

@deprecatedpublic component locate(int x,      int y)
已过时。 从 jdk version 1.1 开始,由 getcomponentat(int, int) 取代。


getcomponentat

public component getcomponentat(point p)
返回包含指定点的组件或子组件。

参数:
p - 点
从以下版本开始:
jdk1.1
另请参见:
contains(int, int)

deliverevent

@deprecatedpublic void deliverevent(event e)
已过时。 从 jdk version 1.1 开始,由 dispatchevent(awtevent e) 取代。


dispatchevent

public final void dispatchevent(awtevent e)
为组件或其子组件之一指派事件。对于已为 component 启用的 1.1 类型的事件,在返回前要调用 processevent

参数:
e - 事件

postevent

@deprecatedpublic boolean postevent(event e)
已过时。 从 jdk version 1.1 开始,由 dispatchevent(awtevent) 取代。

指定者:
接口 menucontainer 中的 postevent

addcomponentlistener

public void addcomponentlistener(componentlistener l)
添加指定的组件侦听器,以接收发自此组件的组件事件。如果侦听器 lnull,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 组件侦听器
从以下版本开始:
jdk1.1
另请参见:
componentevent,componentlistener,removecomponentlistener(java.awt.event.componentlistener),getcomponentlisteners()

removecomponentlistener

public void removecomponentlistener(componentlistener l)
移除指定的组件侦听器,以便它不再接收发自此组件的组件事件。如果参数所指定的侦听器先前尚未添加到此组件,则此方法不起作用,也不抛出异常。如果侦听器 lnull,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 组件侦听器
从以下版本开始:
jdk1.1
另请参见:
componentevent,componentlistener,addcomponentlistener(java.awt.event.componentlistener),getcomponentlisteners()

getcomponentlisteners

public componentlistener[] getcomponentlisteners()
返回在此组件上所有已注册的组件侦听器的数组。

返回:
组件的所有 componentlistener,如果当前没有注册的组件侦听器,则返回一个空数组
从以下版本开始:
1.4
另请参见:
addcomponentlistener(java.awt.event.componentlistener),removecomponentlistener(java.awt.event.componentlistener)

addfocuslistener

public void addfocuslistener(focuslistener l)
添加指定的焦点侦听器,以便当此组件获得输入焦点时能够接收发自此组件的焦点事件。如果侦听器 lnull,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 焦点侦听器
从以下版本开始:
jdk1.1
另请参见:
focusevent,focuslistener,removefocuslistener(java.awt.event.focuslistener),getfocuslisteners()

removefocuslistener

public void removefocuslistener(focuslistener l)
移除指定的焦点侦听器,以便它不再接收发自此组件的焦点事件。如果参数所指定的侦听器尚未添加到此组件,则此方法不起作用,也不抛出异常。如果侦听器 lnull,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 焦点侦听器
从以下版本开始:
jdk1.1
另请参见:
focusevent,focuslistener,addfocuslistener(java.awt.event.focuslistener),getfocuslisteners()

getfocuslisteners

public focuslistener[] getfocuslisteners()
返回在此组件上所有已注册的焦点侦听器的数组。

返回:
组件的所有 focuslistener,如果当前没有注册的焦点侦听器,则返回一个空数组
从以下版本开始:
1.4
另请参见:
addfocuslistener(java.awt.event.focuslistener),removefocuslistener(java.awt.event.focuslistener)

addhierarchylistener

public void addhierarchylistener(hierarchylistener l)
添加指定的层次结构侦听器,以便当此容器所属的层次结构发生变化时接收发自此组件的层次结构变化事件。如果侦听器 lnull,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 层次结构侦听器
从以下版本开始:
1.3
另请参见:
hierarchyevent,hierarchylistener,removehierarchylistener(java.awt.event.hierarchylistener),gethierarchylisteners()

removehierarchylistener

public void removehierarchylistener(hierarchylistener l)
移除指定的层次结构侦听器,以便它不再接收发自此组件的层次结构变化事件。如果参数所指定的侦听器先前尚未添加到此组件,则此方法不起作用,也不抛出异常。如果侦听器 lnull,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 层次结构侦听器
从以下版本开始:
1.3
另请参见:
hierarchyevent,hierarchylistener,addhierarchylistener(java.awt.event.hierarchylistener),gethierarchylisteners()

gethierarchylisteners

public hierarchylistener[] gethierarchylisteners()
返回在此组件上所有已注册的层次结构侦听器的数组。

返回:
组件的所有 hierarchylistener,如果当前没有注册的层次结构侦听器,则返回一个空数组
从以下版本开始:
1.4
另请参见:
addhierarchylistener(java.awt.event.hierarchylistener),removehierarchylistener(java.awt.event.hierarchylistener)

addhierarchyboundslistener

public void addhierarchyboundslistener(hierarchyboundslistener l)
添加指定的层次结构边界侦听器,以便当此容器所属的层次结构发生变化时接收发自此组件的层次结构边界事件。如果侦听器 lnull,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 层次结构边界侦听器
从以下版本开始:
1.3
另请参见:
hierarchyevent,hierarchyboundslistener,removehierarchyboundslistener(java.awt.event.hierarchyboundslistener),gethierarchyboundslisteners()

removehierarchyboundslistener

public void removehierarchyboundslistener(hierarchyboundslistener l)
移除指定的层次结构边界侦听器,以便它不再接收发自此组件的层次结构边界事件。如果参数所指定的侦听器先前尚未添加到此组件,则此方法不起作用,也不抛出异常。如果侦听器 lnull,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 层次结构边界侦听器
从以下版本开始:
1.3
另请参见:
hierarchyevent,hierarchyboundslistener,addhierarchyboundslistener(java.awt.event.hierarchyboundslistener),gethierarchyboundslisteners()

gethierarchyboundslisteners

public hierarchyboundslistener[] gethierarchyboundslisteners()
返回在此组件上所有已注册的层次结构边界侦听器的数组。

返回:
组件的所有 hierarchyboundslistener,如果当前没有注册的层次结构边界侦听器,则返回一个空数组
从以下版本开始:
1.4
另请参见:
addhierarchyboundslistener(java.awt.event.hierarchyboundslistener),removehierarchyboundslistener(java.awt.event.hierarchyboundslistener)

addkeylistener

public void addkeylistener(keylistener l)
添加指定的按键侦听器,以接收发自此组件的按键事件。如果 l 为 null,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 按键侦听器。
从以下版本开始:
jdk1.1
另请参见:
keyevent,keylistener,removekeylistener(java.awt.event.keylistener),getkeylisteners()

removekeylistener

public void removekeylistener(keylistener l)
移除指定的按键侦听器,以便它不再接收发自此组件的按键事件。如果参数所指定的侦听器先前尚未添加到此组件,则此方法不起作用,也不抛出异常。如果侦听器 lnull,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 按键侦听器
从以下版本开始:
jdk1.1
另请参见:
keyevent,keylistener,addkeylistener(java.awt.event.keylistener),getkeylisteners()

getkeylisteners

public keylistener[] getkeylisteners()
返回在此组件上所有已注册的按键侦听器的数组。

返回:
组件的所有 keylistener,如果当前没有注册的按键侦听器,则返回一个空数组
从以下版本开始:
1.4
另请参见:
addkeylistener(java.awt.event.keylistener),removekeylistener(java.awt.event.keylistener)

addmouselistener

public void addmouselistener(mouselistener l)
添加指定的鼠标侦听器,以接收发自此组件的鼠标事件。如果侦听器 lnull,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 鼠标侦听器
从以下版本开始:
jdk1.1
另请参见:
mouseevent,mouselistener,removemouselistener(java.awt.event.mouselistener),getmouselisteners()

removemouselistener

public void removemouselistener(mouselistener l)
移除指定的鼠标侦听器,以便它不再接收发自此组件的鼠标事件。如果参数所指定的侦听器先前尚未添加到此组件,则此方法不起作用,也不抛出异常。如果侦听器 lnull,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 鼠标侦听器
从以下版本开始:
jdk1.1
另请参见:
mouseevent,mouselistener,addmouselistener(java.awt.event.mouselistener),getmouselisteners()

getmouselisteners

public mouselistener[] getmouselisteners()
返回在此组件上所有已注册的鼠标侦听器的数组。

返回:
组件的所有 mouselistener,如果当前没有注册的鼠标侦听器,则返回一个空数组
从以下版本开始:
1.4
另请参见:
addmouselistener(java.awt.event.mouselistener),removemouselistener(java.awt.event.mouselistener)

addmousemotionlistener

public void addmousemotionlistener(mousemotionlistener l)
添加指定的鼠标移动侦听器,以接收发自此组件的鼠标移动事件。如果侦听器 lnull,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 鼠标移动侦听器
从以下版本开始:
jdk1.1
另请参见:
mouseevent,mousemotionlistener,removemousemotionlistener(java.awt.event.mousemotionlistener),getmousemotionlisteners()

removemousemotionlistener

public void removemousemotionlistener(mousemotionlistener l)
移除指定的鼠标移动侦听器,以便它不再接收发自此组件的鼠标移动事件。如果参数所指定的侦听器先前尚未添加到此组件,则此方法不起作用,也不抛出异常。如果侦听器 lnull,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 鼠标移动侦听器
从以下版本开始:
jdk1.1
另请参见:
mouseevent,mousemotionlistener,addmousemotionlistener(java.awt.event.mousemotionlistener),getmousemotionlisteners()

getmousemotionlisteners

public mousemotionlistener[] getmousemotionlisteners()
返回在此组件上所有已注册的鼠标移动侦听器的数组。

返回:
组件的所有 mousemotionlistener,如果当前没有注册的鼠标移动侦听器,则返回一个空数组
从以下版本开始:
1.4
另请参见:
addmousemotionlistener(java.awt.event.mousemotionlistener),removemousemotionlistener(java.awt.event.mousemotionlistener)

addmousewheellistener

public void addmousewheellistener(mousewheellistener l)
添加指定的鼠标滚轮侦听器,以接收发自此组件的鼠标滚轮事件。容器还接收发自子组件的鼠标滚轮事件。

有关如何指派鼠标滚轮事件的信息,请参阅 mousewheelevent 的类描述。

如果 l 为 null,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 鼠标滚轮侦听器
从以下版本开始:
1.4
另请参见:
mousewheelevent,mousewheellistener,removemousewheellistener(java.awt.event.mousewheellistener),getmousewheellisteners()

removemousewheellistener

public void removemousewheellistener(mousewheellistener l)
移除指定的鼠标滚轮侦听器,以便它不再接收发自此组件的鼠标滚轮事件。如果参数所指定的侦听器先前尚未添加到此组件,则此方法不起作用,也不抛出异常。如果 l 为 null,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 鼠标滚轮侦听器。
从以下版本开始:
1.4
另请参见:
mousewheelevent,mousewheellistener,addmousewheellistener(java.awt.event.mousewheellistener),getmousewheellisteners()

getmousewheellisteners

public mousewheellistener[] getmousewheellisteners()
返回在此组件上所有已注册的鼠标滚轮侦听器的数组。

返回:
组件的所有 mousewheellistener,如果当前没有注册的鼠标滚轮侦听器,则返回一个空数组
从以下版本开始:
1.4
另请参见:
addmousewheellistener(java.awt.event.mousewheellistener),removemousewheellistener(java.awt.event.mousewheellistener)

addinputmethodlistener

public void addinputmethodlistener(inputmethodlistener l)
添加指定的输入方法侦听器,以接收发自此组件的输入方法事件。如果组件还重写了 getinputmethodrequests 并返回一个 inputmethodrequests 实例,则该组件只接收发自输入方法的输入方法事件。如果侦听器 lnull,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 输入方法侦听器
从以下版本开始:
1.2
另请参见:
inputmethodevent,inputmethodlistener,removeinputmethodlistener(java.awt.event.inputmethodlistener),getinputmethodlisteners(),getinputmethodrequests()

removeinputmethodlistener

public void removeinputmethodlistener(inputmethodlistener l)
移除指定的输入方法侦听器,以便它不再接收发自此组件的输入方法事件。如果参数所指定的侦听器先前尚未添加到此组件,则此方法不起作用,也不抛出异常。如果侦听器 lnull,则不会抛出异常并且不执行动作。

有关 awt 的线程模型的细节信息,请参阅 awt 线程问题

参数:
l - 输入方法侦听器
从以下版本开始:
1.2
另请参见:
inputmethodevent,inputmethodlistener,addinputmethodlistener(java.awt.event.inputmethodlistener),getinputmethodlisteners()

getinputmethodlisteners

public inputmethodlistener[] getinputmethodlisteners()
返回在此组件上所有已注册的输入方法侦听器的数组。

返回:
组件的所有 inputmethodlistener,如果当前没有注册的输入方法侦听器,则返回一个空数组
从以下版本开始:
1.4
另请参见:
addinputmethodlistener(java.awt.event.inputmethodlistener),removeinputmethodlistener(java.awt.event.inputmethodlistener)

getlisteners

public <t extends eventlistener> t[] getlisteners(class<t> listenertype)
返回一个当前在此 component 上作为 foolistener 注册的所有对象的数组。foolistener 是使用 addfoolistener 方法注册的。

可以使用 class 字面值(如 foolistener.class)来指定 listenertype 参数。例如,可以使用以下代码来查询 component c 的鼠标侦听器:

mouselistener[] mls=(mouselistener[])(c.getlisteners(mouselistener.class));
如果不存在这样<then>的侦听器,则此方法返回一个空数组。

参数:
listenertype - 所请求的侦听器类型;此参数应该指定一个从 java.util.eventlistener 继承的接口
返回:
返回一个在此组件上作为 foolistener 注册的所有对象的数组,如果尚未添加这样<then>的侦听器,则返回一个空数组
抛出:
classcastexceptionjs随机数 - 如果 listenertype 未指定一个实现 java.util.eventlistener 的类或接口
从以下版本开始:
1.3
另请参见:
getcomponentlisteners(),getfocuslisteners(),gethierarchylisteners(),gethierarchyboundslisteners(),getkeylisteners(),getmouselisteners(),getmousemotionlisteners(),getmousewheellisteners(),getinputmethodlisteners(),#getpropertychangelistener

getinputmethodrequests

public inputmethodrequests getinputmethodrequests()
获取输入方法请求处理程序,该处理程序支持此组件输入方法发出的请求。支持当场文本输入的组件必须重写此方法,以便返回一个 inputmethodrequests 实例。同时,还必须处理输入方法事件。

返回:
组件的输入方法请求处理程序,默认为 null
从以下版本开始:
1.2
另请参见:
addinputmethodlistener(java.awt.event.inputmethodlistener)

getinputcontext

public inputcontext getinputcontext()
获取此组件使用的输入上下文,用于处理在此组件中输入文本时与输入方法的通信。默认情况下,返回父组件使用的输入上下文。组件可能重写此方法,以便返回一个私有的输入上下文。

返回:
组件使用的输入上下文,如果可以确定没有上下文,则返回 null
从以下版本开始:
1.2

enableevents

protected final void enableevents(long eventstoenable)
启用由传递给此组件的指定事件掩码参数所定义的事件。

将某个事件类型的侦听器添加到该组件时,自动启用该事件类型。

此方法只能由 component 的子类调用,该子类需要将指定的事件类型传递给 processevent,而不管是否已注册了侦听器。

参数:
eventstoenable - 定义事件类型的事件掩码
从以下版本开始:
jdk1.1
另请参见:
processevent(java.awt.awtevent),disableevents(long),awtevent

disableevents

protected final void disableevents(long eventstodisable)
禁用由传递给此组件的指定事件掩码参数所定义的事件。

参数:
eventstodisable - 定义事件类型的事件掩码
从以下版本开始:
jdk1.1
另请参见:
enableevents(long)

coalesceevents

protected awtevent coalesceevents(awtevent existingevent,       awtevent newevent)
将正发送的事件与现有事件组合在一起<开房去><with>。如果队列中的事件与要发送的事件有相同的 id(两个事件都将此组件作为其源组件)时,则由 eventqueue.postevent 调用此方法。此方法返回一个已组合的事件并用该事件取代现有事件(然后丢弃新事件),或者返回 null,表示没有进行组合(将第二个事件添加到队列的末尾)。如果未返回 null,则可以修改并返回任一事件参数,同时丢弃另一个参数。

coalesceevents 实现可组合两种事件类型:鼠标移动(和拖动)事件,以及绘制(和更新)事件。对于鼠标移动事件,总是返回最后一个事件,导致丢弃中间的移动。对于绘制事件,将新事件组合到同位体中的复杂 repaintarea。总是返回新的 awtevent

参数:
existingevent - 已在 eventqueue 中的事件
newevent - 正发送到 eventqueue 中的事件
返回:
一个已组合的事件,或者返回 null 表明没有进行组合

processevent

protected void processevent(awtevent e)
处理组件上发生的事件。默认情况下,此方法调用给定事件类的适当 process<event type>event 方法。

注意,如果事件参数为 null,则未指定行为并且可能导致异常。

参数:
e - 事件
从以下版本开始:
jdk1.1
另请参见:
processcomponentevent(java.awt.event.componentevent),processfocusevent(java.awt.event.focusevent),processkeyevent(java.awt.event.keyevent),processmouseevent(java.awt.event.mouseevent),processmousemotionevent(java.awt.event.mouseevent),processinputmethodevent(java.awt.event.inputmethodevent),processhierarchyevent(java.awt.event.hierarchyevent),processmousewheelevent(java.awt.event.mousewheelevent)

processcomponentevent

protected void processcomponentevent(componentevent e)
处理组件上发生的组件事件,方法是将其指派到任意已注册的 componentlistener 对象。

如果组件上没有启用组件事件,则不调用此方法。发生下列之一时启用组件事件:

注意,如果事件参数为 null,则未指定行为并且可能导致异常。

参数:
e - 组件事件
从以下版本开始:
jdk1.1
另请参见:
componentevent,componentlistener,addcomponentlistener(java.awt.event.componentlistener),enableevents(long)

processfocusevent

protected void processfocusevent(focusevent e)
处理组件上发生的焦点事件,方法是将其指派到任意已注册的 focuslistener 对象。

如果组件上没有启用焦点事件,则不调用此方法。发生下列之一时启用焦点事件:

如果为某个 component 启用了焦点事件,则当前的 keyboardfocusmanager 确定是否应该将焦点事件指派到已注册的 focuslistener 对象。如果未指派事件,则 keyboardfocusmanager 调用 componentdispatchevent 方法,此方法又调用 componentprocessfocusevent 方法。

如果为 component 启用了焦点事件,则用 focusevent 作为参数来调用 componentdispatchevent 方法将导致调用 componentprocessfocusevent 方法,而不管当前的 keyboardfocusmanager 如何。

注意,如果事件参数为 null,则未指定行为并且可能导致异常。

参数:
e - 焦点事件
从以下版本开始:
jdk1.1
另请参见:
focusevent,focuslistener,keyboardfocusmanager,addfocuslistener(java.awt.event.focuslistener),enableevents(long),dispatchevent(java.awt.awtevent)

processkeyevent

protected void processkeyevent(keyevent e)
处理组件上发生的按键事件,方法是将其指派到任意已注册的 keylistener 对象。

如果组件上没有启用按键事件,则不调用此方法。发生下列之一时启用按键事件:

如果为某个 component 启用了按键事件,则当前的 keyboardfocusmanager 确定是否应该将按键事件指派到已注册的 keylistener 对象。defaultkeyboardfocusmanager 不会为非焦点所有者或未显示的 component 指派按键事件。

从 j2se 1.4 开始,已将 keyevent 重定向到焦点所有者。有关更多信息,请参阅 focus specification

只要组件正在显示、已定焦、已启用并且其上的按键事件已启用,那么使用 keyevent 作为参数来调用 componentdispatchevent 方法将导致调用 componentprocesskeyevent 方法,而不管当前的 keyboardfocusmanager 如何。

注意,如果事件参数为 null,则未指定行为并且可能导致异常。

参数:
e - 按键事件
从以下版本开始:
jdk1.1
另请参见:
keyevent,keylistener,keyboardfocusmanager,defaultkeyboardfocusmanager,processevent(java.awt.awtevent),dispatchevent(java.awt.awtevent),addkeylistener(java.awt.event.keylistener),enableevents(long),isshowing()

processmouseevent

protected void processmouseevent(mouseevent e)
处理组件上发生的鼠标事件,方法是将其指派到任意已注册的 mouselistener 对象。

如果组件上没有启用鼠标事件,则不调用此方法。发生下列之一时启用鼠标事件:

注意,如果事件参数为 null,则未指定行为并且可能导致异常。

参数:
e - 鼠标事件
从以下版本开始:
jdk1.1
另请参见:
mouseevent,mouselistener,addmouselistener(java.awt.event.mouselistener),enableevents(long)

processmousemotionevent

protected void processmousemotionevent(mouseevent e)
处理组件上发生的鼠标移动事件,方法是将其指派到任意已注册的 mousemotionlistener 事件。

如果组件上没有启用鼠标移动事件,则不调用此方法。发生下列之一时启用鼠标移动事件:

注意,如果事件参数为 null,则未指定行为并且可能导致异常。

参数:
e - 鼠标移动事件
从以下版本开始:
jdk1.1
另请参见:
mouseevent,mousemotionlistener,addmousemotionlistener(java.awt.event.mousemotionlistener),enableevents(long)

processmousewheelevent

protected void processmousewheelevent(mousewheelevent e)
处理组件上发生的鼠标滚轮事件,方法是将其指派到任意已注册的 mousewheellistener 对象。

如果组件上没有启用鼠标滚轮事件,则不调用此方法。发生下列之一时启用鼠标滚轮事件:

有关如何指派鼠标滚轮事件的信息,请参阅 mousewheelevent 的类描述。

注意,如果事件参数为 null,则未指定行为并且可能导致异常。

参数:
e - 鼠标滚轮事件
从以下版本开始:
1.4
另请参见:
mousewheelevent,mousewheellistener,addmousewheellistener(java.awt.event.mousewheellistener),enableevents(long)

processinputmethodevent

protected void processinputmethodevent(inputmethodevent e)
处理组件上发生的输入方法事件,方法是将其指派到任意已注册的 inputmethodlistener 对象。

如果组件上没有启用输入方法事件,则不调用此方法。发生下列之一时启用输入方法事件:

注意,如果事件参数为 null,则未指定行为并且可能导致异常。

参数:
e - 输入方法事件
从以下版本开始:
1.2
另请参见:
inputmethodevent,inputmethodlistener,addinputmethodlistener(java.awt.event.inputmethodlistener),enableevents(long)

processhierarchyevent

protected void processhierarchyevent(hierarchyevent e)
处理组件上发生的层次结构事件,方法是将其指派到任意已注册的 hierarchylistener 对象。

如果组件上没有启用层次结构事件,则不调用此方法。发生下列之一时启用层次结构事件:

注意,如果事件参数为 null,则未指定行为并且可能导致异常。

参数:
e - 层次结构事件
从以下版本开始:
1.3
另请参见:
hierarchyevent,hierarchylistener,addhierarchylistener(java.awt.event.hierarchylistener),enableevents(long)

processhierarchyboundsevent

protected void processhierarchyboundsevent(hierarchyevent e)
处理组件上发生的层次结构边界事件,方法是将其指派到任意已注册的 hierarchyboundslistener 对象。

如果组件上没有启用层次结构边界事件,则不调用此方法。发生下列之一时启用层次结构边界事件:

注意,如果事件参数为 null,则未指定行为并且可能导致异常。

参数:
e - 层次结构事件
从以下版本开始:
1.3
另请参见:
hierarchyevent,hierarchyboundslistener,addhierarchyboundslistener(java.awt.event.hierarchyboundslistener),enableevents(long)

handleevent

@deprecatedpublic boolean handleevent(event evt)
已过时。 从 jdk version 1.1 开始,由 processevent(awtevent) 取代。


mousedown

@deprecatedpublic boolean mousedown(event evt,      int x,      int y)
已过时。 从 jdk version 1.1 开始,由 processmouseevent(mouseevent) 取代。


mousedrag

@deprecatedpublic boolean mousedrag(event evt,      int x,      int y)
已过时。 从 jdk version 1.1 开始,由 processmousemotionevent(mouseevent) 取代。


mouseup

@deprecatedpublic boolean mouseup(event evt,       int x,       int y)
已过时。 从 jdk version 1.1 开始,由 processmouseevent(mouseevent) 取代。


mousemove

@deprecatedpublic boolean mousemove(event evt,      int x,      int y)
已过时。 从 jdk version 1.1 开始,由 processmousemotionevent(mouseevent) 取代。


mouseenter

@deprecatedpublic boolean mouseenter(event evt,       int x,       int y)
已过时。 从 jdk version 1.1 开始,由 processmouseevent(mouseevent) 取代。


mouseexit

@deprecatedpublic boolean mouseexit(event evt,      int x,      int y)
已过时。 从 jdk version 1.1 开始,由 processmouseevent(mouseevent) 取代。


keydown

@deprecatedpublic boolean keydown(event evt,       int key)
已过时。 从 jdk version 1.1 开始,由 processkeyevent(keyevent) 取代。


keyup

@deprecatedpublic boolean keyup(event evt,      int key)
已过时。 从 jdk version 1.1 开始,由 processkeyevent(keyevent) 取代。


action

@deprecatedpublic boolean action(event evt,       object what)
已过时。 从 jdk version 1.1 开始,应该将此组件作为组件(激发动作事件)上的 actionlistener 来注册。


addnotify

public void addnotify()
通过将此 component 连接到一个本机屏幕资源使其成为可显示的。此方法由工具包内部调用,不应直接由程序调用。

从以下版本开始:
jdk1.0
另请参见:
isdisplayable(),removenotify()

removenotify

public void removenotify()
通过销毁此 component 的本机屏幕资源使其成为不可显示的。

此方法由工具包内部调用,不应直接由程序调用。重写此方法的代码应该在重写方法的首行调用 super.removenotify

从以下版本开始:
jdk1.0
另请参见:
isdisplayable(),addnotify()

gotfocus

@deprecatedpublic boolean gotfocus(event evt,      object what)
已过时。 从 jdk version 1.1 开始,由 processfocusevent(focusevent) 取代。


lostfocus

@deprecatedpublic boolean lostfocus(event evt,      object what)
已过时。 从 jdk version 1.1 开始,由 processfocusevent(focusevent) 取代。


isfocustraversable

@deprecatedpublic boolean isfocustraversable()
已过时。 从 1.4 开始,由 isfocusable() 取代。

返回此 component 是否可以成为焦点所有者。

返回:
如果此 component 是可以获得焦点的,则返回 true;否则返回 false
从以下版本开始:
jdk1.1
另请参见:
setfocusable(boolean)

isfocusable

public boolean isfocusable()
返回此 component 是否可以获得焦点。

返回:
如果此 component 可以获得焦点,则返回 true;否则返回 false
从以下版本开始:
1.4
另请参见:
setfocusable(boolean)

setfocusable

public void setfocusable(boolean focusable)
将此 component 的焦点状态设置为指定值。此值覆盖 component 的默认焦点状态。

参数:
focusable - 表明此 component 是否可以获得焦点
从以下版本开始:
1.4
另请参见:
isfocusable()

setfocustraversalkeys

public void setfocustraversalkeys(int id,       set<? extends awtkeystroke> keystrokes)
为此 component 的给定遍历操作设置焦点遍历键。

component 的焦点遍历键的默认值与实现有关。sun 建议为特定本机平台的所有实现使用相同的默认值。下面列出了 windows 和 unix 的建议值。在 sun awt 实现中使用了这些建议值。
标识符含义默认值
keyboardfocusmanager.forward_traversal_keys正常的前向键盘遍历key_pressed 上的 tab,key_pressed 上的 ctrl-tab
keyboardfocusmanager.backward_traversal_keys正常的反向键盘遍历key_pressed 上的 shift-tab,key_pressed 上的 ctrl-shift-tab
keyboardfocusmanager.up_cycle_traversal_keys到上一个焦点遍历循环
使用空的 set 来禁用遍历键;建议使用 collections.empty_set。

客户<kè hù>机代码使用 awtkeystroke api 可以指定根据哪种特定的 keyevents(key_pressed 或 key_released)将会发生焦点遍历操作。然而<rán ér>,无论指定了哪种 keyevent,都将使用与焦点遍历键相关的所有 keyevents(包括相关联的 key_typed 事件),并且不会指派到任意 component。将 key_typed 事件指定为焦点遍历操作的映射,或者将相同的事件映射到多个默认焦点遍历操作会生成运行时错误。

如果为 set 指定了 null 值,则此 component 会继承其父级的 set。如果此 component 的所有祖先都为 set 指定了 null,则使用当前 keyboardfocusmanager 的默认 set。

参数:
id - keyboardfocusmanager.forward_traversal_keys、keyboardfocusmanager.backward_traversal_keys 或 keyboardfocusmanager.up_cycle_traversal_keys 之一。
keystrokes - 指定操作的 awtkeystroke 的 set。
抛出:
illegalargumentexception - 如果 id 不是 keyboardfocusmanager.forward_traversal_keys、keyboardfocusmanager.backward_traversal_keys 或 keyboardfocusmanager.up_cycle_traversal_keys 之一、或者 keystroke 包含 null、或者 keystroke 中的 object 不是 awtkeystroke、或者任意 keystroke 表示一个 key_typed 事件,或者任意 keystroke 已经映射到此 component 的另一个焦点遍历操作
从以下版本开始:
1.4
另请参见:
getfocustraversalkeys(int),keyboardfocusmanager.forward_traversal_keys,keyboardfocusmanager.backward_traversal_keys,keyboardfocusmanager.up_cycle_traversal_keys

getfocustraversalkeys

public set<awtkeystroke> getfocustraversalkeys(int id)
返回此 component 的给定遍历操作的焦点遍历键 set。(有关每个键的完整描述,请参阅 setfocustraversalkeys)。

如果没有为此 component 显式定义遍历键 set,则返回此 component 的父级 set。如果没有为此 component 的所有父级显式定义 set,则返回当前 keyboardfocusmanager 的默认 set。

参数:
id - keyboardfocusmanager.forward_traversal_keys、keyboardfocusmanager.backward_traversal_keys 或 keyboardfocusmanager.up_cycle_traversal_keys 之一。
返回:
指定操作的 awtkeystrokes 的 set。set 是不可修改的,但可为空。此方法永远不会返回 null。
抛出:
illegalargumentexception - 如果 id 不是 keyboardfocusmanager.forward_traversal_keys、keyboardfocusmanager.backward_traversal_keys 或 keyboardfocusmanager.up_cycle_traversal_keys 之一
从以下版本开始:
1.4
另请参见:
setfocustraversalkeys(int, java.util.set),keyboardfocusmanager.forward_traversal_keys,keyboardfocusmanager.backward_traversal_keys,keyboardfocusmanager.up_cycle_traversal_keys

arefocustraversalkeysset

public boolean arefocustraversalkeysset(int id)
返回是否为此 component 显式定义了给定焦点遍历操作的焦点遍历键 set。如果此方法返回 false,则此 component 继承了其祖先或当前 keyboardfocusmanager 的 set。

参数:
id - keyboardfocusmanager.forward_traversal_keys、keyboardfocusmanager.backward_traversal_keys 或 keyboardfocusmanager.up_cycle_traversal_keys 之一
返回:
如果已为此 component 显式定义了给定焦点遍历操作的焦点遍历键 set,则返回 true;否则返回 false
抛出:
illegalargumentexception - 如果 id 不是 keyboardfocusmanager.forward_traversal_keys、keyboardfocusmanager.backward_traversal_keys 或 keyboardfocusmanager.up_cycle_traversal_keys 之一
从以下版本开始:
1.4

setfocustraversalkeysenabled

public void setfocustraversalkeysenabled(boolean focustraversalkeysenabled)
设置是否为此 component 启用焦点遍历键。其焦点遍历键已禁用的 component 接收焦点遍历键的按键事件。其焦点遍历键已启用的 component 不会看到这些事件;相反,会自动将这些事件转换为遍历操作。

参数:
focustraversalkeysenabled - 是否为此 component 启用焦点遍历键
从以下版本开始:
1.4
另请参见:
getfocustraversalkeysenabled(),setfocustraversalkeys(int, java.util.set),getfocustraversalkeys(int)

getfocustraversalkeysenabled

public boolean getfocustraversalkeysenabled()
返回是否已为此 component 启用了焦点遍历键。其焦点遍历键已禁用的 component 接收焦点遍历键的按键事件。其焦点遍历键已启用的 component 不会看到这些事件;相反,会自动将这些事件转换为遍历操作。

返回:
是否已为此 component 启用焦点遍历键
从以下版本开始:
1.4
另请参见:
setfocustraversalkeysenabled(boolean),setfocustraversalkeys(int, java.util.set),getfocustraversalkeys(int)

requestfocus

public void requestfocus()
请求此 component 获取输入焦点,并且此 component 的顶层祖先成为获得焦点的 window。此 component 对于所要许可的请求而言必须是不可显示的、可聚焦的和可见的并且其所有祖先(除了顶层 window 以外)必须是可见的。此方法会尽力完成该请求;但是<dàn shì>在某些情况下可能无法完成。在此 component 接收 focus_gained 事件前,开发<developing>人员永远不能假定此 component 是焦点所有者。如果由于此 component 的顶层 window 没有成为获得焦点的窗口而拒绝了此请求,则记住<remember>此请求,并在后来用户使窗口成为获得焦点的窗口时许可此请求。

此方法不能用于为根本不是 component 的内容设置焦点所有者,应该使用 keyboardfocusmanager.clearglobalfocusowner()

因为此方法的焦点行为与平台有关,所以强烈建议开发人员在可能时使用 requestfocusinwindow

注:并不是所有的焦点传输都将导致防止调用此方法。同样地,组件可以在没有调用此方法或 component 的其他任何方法的情况下接收焦点。

从以下版本开始:
jdk1.0
另请参见:
requestfocusinwindow(),focusevent,addfocuslistener(java.awt.event.focuslistener),isfocusable(),isdisplayable(),keyboardfocusmanager.clearglobalfocusowner()

requestfocus

protected boolean requestfocus(boolean temporary)
请求此 component 获取输入焦点,并且此 component 的顶层祖先成为获得焦点的 window。此 component 对于所要许可的请求而言必须是不可显示的、可聚焦的和可见的并且其所有祖先(除了顶层 window 以外)必须是可见的。此方法会尽力完成该请求;但是在某些情况下可能无法完成。在此 component 接收 focus_gained 事件前,开发人员必须永远不能假定此 component 是焦点所有者。如果由于此 component 的顶层窗口没有成为获得焦点的窗口而拒绝了此请求,则记住<remember>此请求,并在后来用户使窗口成为获得焦点的窗口时许可此请求。

此方法返回布尔值。如果返回 false,则请求注定要失败。如果返回 true,并且在本机窗口系统允许请求前不禁止该请求或不发生特别的事件(如处理该组件的同位体),则请求成功<chéng gōng>。此外,虽然返回 true 表示请求可能成功<chéng gōng>了,但是在此组件接收 focus_gained 事件前,开发人员必须永远不能假定此 component 是焦点所有者。

此方法不能用于为根本不是 component 的内容设置焦点所有者,应该使用 keyboardfocusmanager.clearglobalfocusowner

因为此方法的焦点行为与平台有关,所以强烈建议开发人员在可能时使用 requestfocusinwindow

此方法会尽力完成该请求,确保作为此请求结果所产生的 focusevent 具有指定的临时值。但是,因为在所有本机窗口系统上指定一个任意的临时状态是不可能实现的,所以只有轻量级 component 可以保证此方法的行为正确。此方法并非用于一般用途,而是作为轻量级组件库(如 swing)的钩子 (hook) 而存在的。

注:并不是所有的焦点传输都将导致防止调用此方法。同样地,组件可以在没有调用此方法或 component 的其他任何方法的情况下接收焦点。

参数:
temporary - 如果焦点改变是临时的(如在窗口丢失焦点时),则为 true;有关临时焦点改变的更多信息,请参阅 focus specification
返回:
如果焦点改变请求注定要失败,则返回 false;如果可能成功,则返回 true
从以下版本开始:
1.4
另请参见:
focusevent,addfocuslistener(java.awt.event.focuslistener),isfocusable(),isdisplayable(),keyboardfocusmanager.clearglobalfocusowner()

requestfocusinwindow

public boolean requestfocusinwindow()
如果此 component 的顶层祖先已经是获得焦点的 window,则请求此 component 获取输入焦点。此 component 对于所要许可的请求而言必须是不可显示的、可聚焦的和可见的并且其所有祖先(除了顶层 window 以外)必须是可见的。此方法会尽力完成该请求;但是在某些情况下可能无法完成。在此 component 接收 focus_gained 事件前,开发人员永远不能假定此 component 是焦点所有者。

此方法返回布尔值。如果返回 false,则请求注定要失败。如果返回 true,并且在本机窗口系统允许请求前不禁止该请求或不发生特别的事件(如处理该组件的同位体),则请求成功。此外,虽然返回 true 表示请求可能成功了,但是在此组件接收 focus_gained 事件前,开发人员必须永远不能假定此 component 是焦点所有者。

此方法不能用于为根本不是 component 的内容设置焦点所有者,应该使用 keyboardfocusmanager.clearglobalfocusowner()

可在各种平台之间一致地实现此方法的焦点行为,所以强烈建议开发人员在可能时使用此方法,而不是 requestfocus。依赖 requestfocus 的代码可能在不同平台上表现<performance>出不同的焦点行为。

注:并不是所有的焦点传输都将导致防止调用此方法。同样地,组件可以在没有调用此方法或 component 的其他任何方法的情况下接收焦点。

返回:
如果焦点改变请求注定要失败,则返回 false;如果可能成功,则返回 true
从以下版本开始:
1.4
另请参见:
requestfocus(),focusevent,addfocuslistener(java.awt.event.focuslistener),isfocusable(),isdisplayable(),keyboardfocusmanager.clearglobalfocusowner()

requestfocusinwindow

protected boolean requestfocusinwindow(boolean temporary)
如果此 component 的顶层祖先已经是获得焦点的 window,则请求此 component 获取输入焦点。此 component 对于所要许可的请求而言必须是不可显示的、可聚焦的和可见的并且其所有祖先(除了顶层 window 以外)必须是可见的。此方法会尽力完成该请求;但是在某些情况下可能无法完成。在此 component 接收 focus_gained 事件前,开发人员必须永远不能假定此 component 是焦点所有者。

此方法返回布尔值。如果返回 false,则请求注定要失败。如果返回 true,并且在本机窗口系统允许请求前不禁止该请求或不发生特别的事件(如处理该组件的同位体),则请求成功。此外,虽然返回 true 表示请求可能成功了,但是在此组件接收 focus_gained 事件前,开发人员必须永远不能假定此 component 是焦点所有者。

此方法不能用于为根本不是 component 的内容设置焦点所有者。应该使用 keyboardfocusmanager.clearglobalfocusowner

可在各种平台之间一致地实现此方法的焦点行为,所以强烈建议开发人员在可能时使用此方法,而不是 requestfocus。依赖 requestfocus 的代码可能在不同平台上表现<performance>出不同的焦点行为。

此方法会尽力完成该请求,确保作为此请求结果所产生的 focusevent 具有指定的临时值。但是,因为在所有本机窗口系统上指定一个任意的临时状态是不可能实现的,所以只有轻量级组件可以保证此方法的行为正确。此方法并非用于一般用途,而是作为轻量级组件库(如 swing)的钩子 (hook) 而存在的。

注:并不是所有的焦点传输都将导致防止调用此方法。同样地,组件可以在没有调用此方法或 component 的其他任何方法的情况下接收焦点。

参数:
temporary - 如果焦点改变是临时的(如在窗口丢失焦点时),则为 true;有关临时焦点改变的更多信息,请参阅 focus specification
返回:
如果焦点改变请求注定要失败,则返回 false;如果可能成功,则返回 true
从以下版本开始:
1.4
另请参见:
requestfocus(),focusevent,addfocuslistener(java.awt.event.focuslistener),isfocusable(),isdisplayable(),keyboardfocusmanager.clearglobalfocusowner()

transferfocus

public void transferfocus()
将焦点转移到下一个组件,就好像此 component 曾是焦点所有者。

从以下版本开始:
jdk1.1
另请参见:
requestfocus()

getfocuscyclerootancestor

public container getfocuscyclerootancestor()
返回作为此 component 焦点遍历循环的焦点循环根的 container。每个焦点遍历循环只有一个焦点遍历循环根,每个不是 container 的 component 只属于一个焦点遍历循环。是焦点循环根的 container 属于两个循环:一个起始于 container 本身的循环,以及一个起始于 container 的最近焦点循环根祖先的循环。对于这些 container,此方法返回 container 的最近焦点循环根祖先。

返回:
此 component 的最近焦点循环根祖先
从以下版本开始:
1.4
另请参见:
container.isfocuscycleroot()

isfocuscycleroot

public boolean isfocuscycleroot(container container)
返回指定的 container 是否为此 component 焦点遍历循环的焦点循环根。每个焦点遍历循环只有一个焦点遍历循环根,每个不是 container 的 component 只属于一个焦点遍历循环。

参数:
container - 要测试的 container
返回:
如果指定的 container 是此 component 的焦点循环根,则返回 true;否则返回 false
从以下版本开始:
1.4
另请参见:
container.isfocuscycleroot()

nextfocus

@deprecatedpublic void nextfocus()
已过时。 从 jdk version 1.1 开始,由 transferfocus() 取代。


transferfocusbackward

public void transferfocusbackward()
将焦点转移到前一个组件,就好像此 component 曾是焦点所有者。

从以下版本开始:
1.4
另请参见:
requestfocus()

transferfocusupcycle

public void transferfocusupcycle()
将焦点向上转移一个焦点遍历循环。通常将焦点所有者设置为此 component 的焦点循环根,将当前的焦点循环根设置为新焦点所有者的焦点循环根。但是如果此 component 的焦点循环根是一个 window,则将焦点所有者设置为焦点循环根的默认 component,以便获得焦点,并且不改变当前的焦点循环根。

从以下版本开始:
1.4
另请参见:
requestfocus(),container.isfocuscycleroot(),container.setfocuscycleroot(boolean)

hasfocus

public boolean hasfocus()
如果此 component 是焦点所有者,则返回 true。此方法已过时,并且已经由 isfocusowner() 取代。

返回:
如果此 component 是焦点所有者,则返回 true;否则返回 false
从以下版本开始:
1.2

isfocusowner

public boolean isfocusowner()
如果此 component 是焦点所有者,则返回 true

返回:
如果此 component 是焦点所有者,则返回 true;否则返回 false
从以下版本开始:
1.4

add

public void add(popupmenu popup)
向组件添加指定的弹出菜单。

参数:
popup - 要添加给组件的弹出菜单。
抛出:
nullpointerexception - 如果 popupnull
从以下版本开始:
jdk1.1
另请参见:
remove(menucomponent)

remove

public void remove(menucomponent popup)
从组件移除指定的弹出菜单。

指定者:
接口 menucontainer 中的 remove
参数:
popup - 要移除的弹出菜单
从以下版本开始:
jdk1.1
另请参见:
add(popupmenu)

paramstring

protected string paramstring()
返回此组件状态的字符串表示形式。此方法仅在进行调试的时候<When>使用,对于这两个实现,返回的字符串的内容和格式可能有所不同。返回的字符串可能为空,但不可能为 null

返回:
组件状态的字符串表示形式
从以下版本开始:
jdk1.0

tostring

public string tostring()
返回此组件及其值的字符串表示形式。

覆盖:
object 中的 tostring
返回:
组件的字符串表示形式。
从以下版本开始:
jdk1.0

list

public void list()
将组件列表打印到标准系统输出流 system.out

从以下版本开始:
jdk1.0
另请参见:
system.out

list

public void list(printstream out)
将组件列表打印到指定的输出流。

参数:
out - 打印流
从以下版本开始:
jdk1.0

list

public void list(printstream out,   int indent)
将列表从指定的缩排开始打印到指定的打印流。

参数:
out - 打印流
indent - 缩排的空格数
从以下版本开始:
jdk1.0
另请参见:
printstream.println(java.lang.object)

list

public void list(printwriter out)
将列表打印到指定的打印编写器。

参数:
out - 打印到的打印编写器
从以下版本开始:
jdk1.1

list

public void list(printwriter out,   int indent)
将列表从指定的缩排开始打印到指定的打印编写器。

参数:
out - 打印到的打印编写器
indent - 缩排的空格数
从以下版本开始:
jdk1.1
另请参见:
printstream.println(java.lang.object)

addpropertychangelistener

public void addpropertychangelistener(propertychangelistener listener)
向侦听器列表添加一个 propertychangelistener。侦听器是为此类的所有绑定属性注册的,这些属性包括:注意,如果此 component 继承了一个绑定属性,则不会激发事件来响应继承属性的改变。

如果 listenernull,则不会抛出异常并且不执行动作。

参数:
listener - 要添加的属性更改侦听器
另请参见:
removepropertychangelistener(java.beans.propertychangelistener),#getpropertychangelistener,addpropertychangelistener(java.lang.string, java.beans.propertychangelistener)

removepropertychangelistener

public void removepropertychangelistener(propertychangelistener listener)
从侦听器列表移除一个 propertychangelistener。应该使用此方法移除为此类的所有绑定属性所注册的 propertychangelistener。

如果 listener 为 null,则不会抛出异常并且不执行动作。

参数:
listener - 要移除的 propertychangelistener
另请参见:
addpropertychangelistener(java.beans.propertychangelistener),#getpropertychangelistener,removepropertychangelistener(java.lang.string,java.beans.propertychangelistener)

getpropertychangelisteners

public propertychangelistener[] getpropertychangelisteners()
返回在此组件上所有已注册的属性更改侦听器的数组。

返回:
组件的所有 propertychangelistener,如果当前没有注册的属性更改侦听器,则返回一个空数组
从以下版本开始:
1.4
另请参见:
addpropertychangelistener(java.beans.propertychangelistener),removepropertychangelistener(java.beans.propertychangelistener),#getpropertychangelistener(java.lang.string),java.beans.propertychangesupport#getpropertychangelistener

addpropertychangelistener

public void addpropertychangelistener(string propertyname,       propertychangelistener listener)
向指定属性的侦听器列表添加一个 propertychangelistener。指定的属性可能是用户定义的,或者是下列之一:注意,如果此 component 继承了一个绑定属性,则不会激发事件来响应继承属性的改变。

如果 propertynamelistenernull,则不会抛出异常并且不执行动作。

参数:
propertyname - 上面所列的属性名之一
listener - 要添加的 propertychangelistener
另请参见:
removepropertychangelistener(java.lang.string, java.beans.propertychangelistener),#getpropertychangelistener(java.lang.string),addpropertychangelistener(java.lang.string, java.beans.propertychangelistener)

removepropertychangelistener

public void removepropertychangelistener(string propertyname,       propertychangelistener listener)
从指定属性的侦听器列表中移除一个 propertychangelistener。应该使用此方法移除为指定绑定属性所注册的 propertychangelistener

如果 propertynamelistenernull,则不会抛出异常并且不执行动作。

参数:
propertyname - 有效的属性名
listener - 要移除的 propertychangelistener
另请参见:
addpropertychangelistener(java.lang.string, java.beans.propertychangelistener),#getpropertychangelistener(java.lang.string),removepropertychangelistener(java.beans.propertychangelistener)

getpropertychangelisteners

public propertychangelistener[] getpropertychangelisteners(string propertyname)
返回与指定属性相关联的所有侦听器的数组。

返回:
与指定属性相关联的所有 propertychangelistener;如果尚未添加这样的侦听器,或者 propertynamenull,则返回空数组
从以下版本开始:
1.4
另请参见:
addpropertychangelistener(java.lang.string, java.beans.propertychangelistener),removepropertychangelistener(java.lang.string, java.beans.propertychangelistener),#getpropertychangelistener

firepropertychange

protected void firepropertychange(string propertyname,       object oldvalue,       object newvalue)
支持报告 object 属性的绑定属性改变。当改变了绑定属性并且向所有已注册的 propertychangelistener 发送相应的 propertychangeevent 时可以调用此方法。

参数:
propertyname - 其值已改变的属性
oldvalue - 该属性以前的值
newvalue - 该属性的新值

firepropertychange

protected void firepropertychange(string propertyname,       boolean oldvalue,       boolean newvalue)
支持报告布尔属性的绑定属性改变。当改变了绑定属性并且向所有已注册的 propertychangelistener 发送相应的 propertychangeevent 时可以调用此方法。

参数:
propertyname - 其值已改变的属性
oldvalue - 该属性以前的值
newvalue - 该属性的新值
从以下版本开始:
1.4

firepropertychange

protected void firepropertychange(string propertyname,       int oldvalue,       int newvalue)
支持报告整数属性的绑定属性改变。当改变了绑定属性并且向所有已注册的 propertychangelistener 发送相应的 propertychangeevent 时可以调用此方法。

参数:
propertyname - 其值已改变的属性
oldvalue - 该属性以前的值
newvalue - 该属性的新值
从以下版本开始:
1.4

firepropertychange

public void firepropertychange(string propertyname,      byte oldvalue,      byte newvalue)
报告绑定属性的改变。

参数:
propertyname - 已改变的属性的编程名称
oldvalue - 该属性的旧值(byte 类型)
newvalue - 该属性的新值(byte 类型)
从以下版本开始:
1.5
另请参见:
firepropertychange(java.lang.string, java.lang.object, java.lang.object)

firepropertychange

public void firepropertychange(string propertyname,      char oldvalue,      char newvalue)
报告绑定属性的改变。

参数:
propertyname - 已改变的属性的编程名称
oldvalue - 该属性的旧值(char 类型)
newvalue - 该属性的新值(char 类型)
从以下版本开始:
1.5
另请参见:
firepropertychange(java.lang.string, java.lang.object, java.lang.object)

firepropertychange

public void firepropertychange(string propertyname,      short oldvalue,      short newvalue)
报告绑定属性的改变。

参数:
propertyname - 已改变的属性的编程名称
oldvalue - 该属性的旧值(short 类型)
newvalue - 该属性的新值(short 类型)
从以下版本开始:
1.5
另请参见:
firepropertychange(java.lang.string, java.lang.object, java.lang.object)

firepropertychange

public void firepropertychange(string propertyname,      long oldvalue,      long newvalue)
报告绑定属性的改变。

参数:
propertyname - 已改变的属性的编程名称
oldvalue - 该属性的旧值(long 类型)
newvalue - 该属性的新值(long 类型)
从以下版本开始:
1.5
另请参见:
firepropertychange(java.lang.string, java.lang.object, java.lang.object)

firepropertychange

public void firepropertychange(string propertyname,      float oldvalue,      float newvalue)
报告绑定属性的改变。

参数:
propertyname - 已改变的属性的编程名称
oldvalue - 该属性的旧值(float 类型)
newvalue - 该属性的新值(float 类型)
从以下版本开始:
1.5
另请参见:
firepropertychange(java.lang.string, java.lang.object, java.lang.object)

firepropertychange

public void firepropertychange(string propertyname,      double oldvalue,      double newvalue)
报告绑定属性的改变。

参数:
propertyname - 已改变的属性的编程名称
oldvalue - 该属性的旧值(double 类型)
newvalue - 该属性的新值(double 类型)
从以下版本开始:
1.5
另请参见:
firepropertychange(java.lang.string, java.lang.object, java.lang.object)

setcomponentorientation

public void setcomponentorientation(componentorientation o)
设置语言敏感的方向,用于排序此组件内的元素或文本。语言敏感的 layoutmanagercomponent 子类使用此属性来确定如何布局并绘制组件。

在构造时,组件的方向设置为 componentorientation.unknown,表示尚未显式地指定它。unknown 方向的行为与 componentorientation.left_to_right 相同。

要设置单个组件的方向,请使用此方法。要设置整个组件层次结构的方向,请使用 applycomponentorientation

另请参见:
componentorientation

getcomponentorientation

public componentorientation getcomponentorientation()
检索将用于排序此组件内的元素或文本的语言敏感的方向。需要考虑方向的 layoutmanagercomponent 子类在执行布局或绘制前应该调用此方法来获取组件的方向。

另请参见:
componentorientation

applycomponentorientation

public void applycomponentorientation(componentorientation orientation)
设置此组件及其包含的所有组件的 componentorientation 属性。

参数:
orientation - 此组件及其包含的所有组件的新组件方向。
抛出:
nullpointerexception - 如果 orientation 为 null。
从以下版本开始:
1.4
另请参见:
setcomponentorientation(java.awt.componentorientation),getcomponentorientation()

getaccessiblecontext

public accessiblecontext getaccessiblecontext()
获取与此 component 相关的 accessiblecontext。此基类所实现的方法返回 null。扩展 component 的类应该实现此方法,以便返回与该子类相关的 accessiblecontext

返回:
componentaccessiblecontext
从以下版本开始:
1.3

javatm platform
standard ed. 6

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

版权所有 2007 sun microsystems, inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策