javatm platform
standard ed. 6

java.awt
类 textfield

java.lang.object 继承者 java.awt.component 继承者 java.awt.textcomponent   继承者 java.awt.textfield
所有<suǒ yǒu>已实现的接口:
imageobserver, menucontainer, serializable, accessible

public class textfield
extends textcomponent

textfield 对象是允许<allow>编辑单行文本的文本组件。

例如,下图描绘了带有四个宽度<attitudes>各异的文本字段的窗体。其中两个文本字段显示预定义文本 "hello"

前面的文本描述了此图。

以下是产生四个文本字段的代码:


textfield tf1, tf2, tf3, tf4;// a blank text fieldtf1=new textfield();// blank field of 20 columnstf2=new textfield("", 20);// predefined text displayedtf3=new textfield("hello!");// predefined text in 30 columnstf4=new textfield("hello", 30);

每次用户在文本字段中键入一个键时,就有一个或更多键事件被发送到该文本字段。keyevent 是以下三种类型之一:keypressed、keyreleased 或 keytyped。键事件的属性指示事件是哪一种类型,以及关于事件的其他<other>信息,比如对键事件应用哪种修饰符和事件发生<occasionally occurred>的时间。

键事件被传递给每一个 keylistenerkeyadapter 对象,这些对象使用组件的 addkeylistener 方法注册,以接收这类事件。(keyadapter 对象实现 keylistener 接口。)

textfield 还可能<would>触发 actionevent。如果对文本字段启用操作事件,则可以< kě yǐ>通过按下 return 键触发它们。

textfield 类的 processevent 方法检查操作事件,并将它们传递给 processactionevent。后一种方法将该事件重定向到为接收此文本字段生成的操作事件而注册的所有 actionlistener 对象。

从以下版本开始<kāi shǐ>:
jdk1.0
另请参见:
keyevent,keyadapter,keylistener,actionevent,component.addkeylistener(java.awt.event.keylistener),processevent(java.awt.awtevent),processactionevent(java.awt.event.actionevent),addactionlistener(java.awt.event.actionlistener),序列化表格

嵌套类摘要
protected  classtextfield.accessibleawttextfield
          此类实现 textfield 类的可访问<fǎng wèn>性支持<zhī chí>。
 
从类 java.awt.textcomponent 继承的嵌套类/接口
textcomponent.accessibleawttextcomponent
 
从类 java.awt.component 继承的嵌套类/接口
component.accessibleawtcomponent, component.baselineresizebehavior, component.bltbufferstrategy, component.flipbufferstrategy
 
字段摘要
 
从类 java.awt.textcomponent 继承的字段
textlistener
 
从类 java.awt.component 继承的字段
bottom_alignment, center_alignment, left_alignment, right_alignment, top_alignment
 
从接口 java.awt.image.imageobserver 继承的字段
abort, allbits, error, framebits, height, properties, somebits, width
 
构造方法摘要
textfield()
          构造新文本字段。
textfield(int columns)
          构造具有指定列数的新空文本字段。
textfield(string text)
          构造使用指定文本初始化的新文本字段。
textfield(string text,int columns)
          构造使用要显示的指定文本初始化的新文本字段,宽度<attitudes>足够容纳指定列数。
 
方法摘要
 voidaddactionlistener(actionlistener l)
          添加指定的操作侦听器,以从此文本字段接收操作事件。
 voidaddnotify()
          创建 textfield 的同位体。
 booleanechocharisset()
          指示此文本字段是否有一个回显字符集。
 accessiblecontextgetaccessiblecontext()
          获取与此 textfield 关联的 accessiblecontext。
 actionlistener[]getactionlisteners()
          返回此文本字段上已注册的所有操作侦听器的数组。
 intgetcolumns()
          获取此文本字段中的列数。
 chargetechochar()
          获取用于回显的字符。
<t extends eventlistener>
t[]
getlisteners(class<t> listenertype)
          返回当前已在此 textfield 上注册为 foolistener 的所有对象的数组。
 dimensiongetminimumsize()
          获取此文本字段的最小<smallest>尺寸。
 dimensiongetminimumsize(int columns)
          获取具有指定列数的文本字段的最小<smallest>尺寸。
 dimensionjs随机数getpreferredsize()
          获取此文本字段的首选大小。
 dimensiongetpreferredsize(int columns)
          获取具有指定列数的文本字段的首选大小。
 dimensionminimumsize()
          已过时。 从 jdk version 1.1 开始<kāi shǐ>,由 getminimumsize() 取代。
 dimensionminimumsize(int columns)
          已过时。 从 jdk version 1.1 开始,由 getminimumsize(int) 取代。
protected  stringparamstring()
          返回表示此 textfield 状态的字符串。
 dimensionpreferredsize()
          已过时。 从 jdk version 1.1 开始,由 getpreferredsize() 取代。
 dimensionpreferredsize(int columns)
          已过时。 从 jdk version 1.1 开始,由 getpreferredsize(int) 取代。
protected  voidprocessactionevent(actionevent e)
          处理发生<occasionally occurred>在此文本字段上的操作事件:将这些事件指派给所有已注册的 actionlistener 对象。
protected  voidprocessevent(awtevent e)
          处理此文本字段上的事件。
 voidremoveactionlistener(actionlistener l)
          移除指定的操作侦听器,不再从此文本字段接收操作事件。
 voidsetcolumns(int columns)
          设置此文本字段中的列数。
 voidsetechochar(char c)
          设置此文本字段的回显字符。
 voidsetechocharacter(char c)
          已过时。 从 jdk version 1.1 开始,由 setechochar(char) 取代。
 voidsettext(string t)
          将此文本组件显示的文本设置为指定文本。
 
从类 java.awt.textcomponent 继承的方法
addtextlistener, enableinputmethods, getbackground, getcaretposition, getinputmethodrequests, getselectedtext, getselectionend, getselectionstart, gettext, gettextlisteners, iseditable, processtextevent, removenotify, removetextlistener, select, selectall, setbackground, setcaretposition, seteditable, setselectionend, setselectionstart
 
从类 java.awt.component 继承的方法
action, add, addcomponentlistener, addfocuslistener, addhierarchyboundslistener, addhierarchylistener, addinputmethodlistener, addkeylistener, addmouselistener, addmousemotionlistener, addmousewheellistener, addpropertychangelistener, addpropertychangelistener, applycomponentorientation, arefocustraversalkeysset, bounds, checkimage, checkimage, coalesceevents, contains, contains, createimage, createimage, createvolatileimage, createvolatileimage, deliverevent, disable, disableevents, dispatchevent, dolayout, enable, enable, enableevents, firepropertychange, firepropertychange, firepropertychange, firepropertychange, firepropertychange, firepropertychange, firepropertychange, firepropertychange, firepropertychange, getalignmentx, getalignmenty, getbaseline, getbaselineresizebehavior, getbounds, getbounds, getcolormodel, getcomponentat, getcomponentat, getcomponentlisteners, getcomponentorientation, getcursor, getdroptarget, getfocuscyclerootancestor, getfocuslisteners, getfocustraversalkeys, getfocustraversalkeysenabled, getfont, getfontmetrics, getforeground, getgraphics, getgraphicsconfiguration, getheight, gethierarchyboundslisteners, gethierarchylisteners, getignorerepaint, getinputcontext, getinputmethodlisteners, getkeylisteners, getlocale, getlocation, getlocation, getlocationonscreen, getmaximumsize, getmouselisteners, getmousemotionlisteners, getmouseposition, getmousewheellisteners, getname, getparent, getpeer, getpropertychangelisteners, getpropertychangelisteners, getsize, getsize, gettoolkit, gettreelock, getwidth, getx, gety, gotfocus, handleevent, hasfocus, hide, imageupdate, inside, invalidate, isbackgroundset, iscursorset, isdisplayable, isdoublebuffered, isenabled, isfocusable, isfocuscycleroot, isfocusowner, isfocustraversable, isfontset, isforegroundset, islightweight, ismaximumsizeset, isminimumsizeset, isopaque, ispreferredsizeset, isshowing, isvalid, isvisible, keydown, keyup, layout, list, list, list, list, list, locate, location, lostfocus, mousedown, mousedrag, mouseenter, mouseexit, mousemove, mouseup, move, nextfocus, paint, paintall, postevent, prepareimage, prepareimage, print, printall, processcomponentevent, processfocusevent, processhierarchyboundsevent, processhierarchyevent, processinputmethodevent, processkeyevent, processmouseevent, processmousemotionevent, processmousewheelevent, remove, removecomponentlistener, removefocuslistener, removehierarchyboundslistener, removehierarchylistener, removeinputmethodlistener, removekeylistener, removemouselistener, removemousemotionlistener, removemousewheellistener, removepropertychangelistener, removepropertychangelistener, repaint, repaint, repaint, repaint, requestfocus, requestfocus, requestfocusinwindow, requestfocusinwindow, reshape, resize
大户条款虽将延后3年上路,但10亿元门槛仍然不变,此消息一出,台股今(17)日随即一路下滑,外资更卖超超过200亿元,导致大盘收跌百点,站回9000关无望
星展银行(台湾<tái wān>)财富管理<guǎn lǐ>投资顾问部副总裁林雅慧表示,近期联?驶岫辔还僭毕群蟊硖?赋觯?2015年联?驶峥赏?展开升息,且根据过去历史<History>资料显示,联?驶嵩?1994年2月、1999年6月、2004年6月的最近3次升息中,美元<měi yuán>指数在升息前6个月平均<píng jūn>上扬超过4%,意味着在联?驶嵘形凑?式转向紧缩货币之际,美元<měi yuán>表现<performance>依旧值得期待
可以< kě yǐ>做朋友/可以约你/可以要电话吗?(5个白目男生问,我还想问你们可以去跳楼吗咧!)
这台Impossible电动自行车,车身使用碳纤维打造,因此< yīn cǐ>整台车相当轻盈,重量<zhòng liàng>不超过5公斤,即使折叠放到后背包里,也不会太重;Impossible最大<largest>特色就是用圆圈当作主体框架,取代传统自行车的水平横梁,轮子被折叠收纳在圆圈框架里,该框架则能保持车体的稳固
据《都市报》报导,外型蓝绿色、带有黄色线条的云霄飞车,因为大小关?S,一次只能搭载一位乘客
, resize, setbounds, setbounds, setcomponentorientation, setcursor, setdroptarget, setenabled, setfocusable, setfocustraversalkeys, setfocustraversalkeysenabled, setfont, setforeground, setignorerepaint, setlocale, setlocation, setlocation, setmaximumsize, setminimumsize, setname, setpreferredsize, setsize, setsize, setvisible, show, show, size, tostring, transferfocus, transferfocusbackward, transferfocusupcycle, update, validate
 
从类 java.lang.object 继承的方法
clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait
 

构造方法详细校約ense>畔

textfield

public textfield()   throws headlessexception
构造新文本字段。

抛出:
headlessexception - 如果 graphicsenvironment.isheadless() 返回 true。
另请参见:
graphicsenvironment.isheadless()

textfield

public textfield(string text)   throws headlessexception
构造使用指定文本初始化的新文本字段。

参数:
text - 要显示的文本。如果 textnull,则显示空字符串 ""
抛出:
headlessexception - 如果 graphicsenvironment.isheadless() 返回 true。
另请参见:
graphicsenvironment.isheadless()

textfield

public textfield(int columns)   throws headlessexception
构造具有指定列数的新空文本字段。列是近似平均<píng jūn>字符宽度,它与平台有关。

参数:
columns - 列数。如果 columns 小于 0,则将 columns 设置为 0
抛出:
headlessexception - 如果 graphicsenvironment.isheadless() 返回 true。
另请参见:
graphicsenvironment.isheadless()

textfield

public textfield(string text,   int columns)   throws headlessexception
构造使用要显示的指定文本初始化的新文本字段,宽度足够容纳指定列数。列是近似平均字符宽度,它与平台有关。

参数:
text - 要显示的文本。如果 textnull,则显示空字符串 ""
columns - 列数。如果 columns 小于 0,则将 columns 设置为 0
抛出:
headlessexception - 如果 graphicsenvironment.isheadless() 返回 true。
另请参见:
graphicsenvironment.isheadless()
方法详细信息

addnotify

public void addnotify()
创建 textfield 的同位体。此同位体允许<allow>修改 textfield 的外观,并且不更改其功能。

覆盖:
textcomponent 中的 addnotify
另请参见:
textcomponent.removenotify()

getechochar

public char getechochar()
获取用于回显的字符。

回显字符对于不应将用户输入回显到屏幕上的文本字段有用,例如输入密码的文本字段。如果 echochar=0,则将用户输入不作更改地回显到屏幕。

java 平台实现只能支持<zhī chí>有限的、非空回显字符集。此函数返回 setechochar() 最初请求的回显字符。textfield 实现实际使用的回显字符可能<would>不同。

返回:
此文本字段的回显字符。
另请参见:
echocharisset(),setechochar(char)

setechochar

public void setechochar(char c)
设置此文本字段的回显字符。

回显字符对于不应将用户输入回显到屏幕上的文本字段很有用,例如输入密码的文本字段。设置 echochar=0 允许将用户输入再次回显到屏幕。

java 平台实现只能支持有限的、非空回显字符集。试图设置不受支持的回显字符将导致使用默认回显字符。对 getechochar() 的后续调用将返回最初请求的回显字符。返回的回显字符有可能与 textfield 实现实际使用的相同,也有可能不同。

参数:
c - 此文本字段的回显字符。
从以下版本开始:
jdk1.1
另请参见:
echocharisset(),getechochar()

setechocharacter

@deprecatedpublic void setechocharacter(char c)
已过时。 从 jdk version 1.1 开始,由 setechochar(char) 取代。


settext

public void settext(string t)
将此文本组件显示的文本设置为指定文本。

覆盖:
textcomponent 中的 settext
参数:
t - 新文本。
另请参见:
textcomponent.gettext()

echocharisset

public boolean echocharisset()
指示此文本字段是否有一个回显字符集。

回显字符对于不应将用户输入回显到屏幕上的文本字段有用,例如输入密码的文本字段。

返回:
如果此文本字段有一个回显字符集,则返回 true;否则返回 false
另请参见:
setechochar(char),getechochar()

getcolumns

public int getcolumns()
获取此文本字段中的列数。列是近似平均字符宽度,它与平台有关。

返回:
列数。
从以下版本开始:
jdk1.1
另请参见:
setcolumns(int)

setcolumns

public void setcolumns(int columns)
设置此文本字段中的列数。列是近似平均字符宽度,它与平台有关。

参数:
columns - 列数。
抛出:
illegalargumentexception - 如果为 columns 提供的值小于 0
从以下版本开始:
jdk1.1
另请参见:
getcolumns()

getpreferredsize

public dimension getpreferredsize(int columns)
获取具有指定列数的文本字段的首选大小。

参数:
columns - 此文本字段中的列数。
返回:
显示此文本字段的首选尺寸。
从以下版本开始:
jdk1.1

preferredsize

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


getpreferredsize

public dimension getpreferredsize()
获取此文本字段的首选大小。

覆盖:
component 中的 getpreferredsize
返回:
显示此文本字段的首选尺寸。
从以下版本开始:
jdk1.1
另请参见:
component.getminimumsize(),layoutmanager

preferredsize

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

覆盖:
component 中的 preferredsize

getminimumsizejs随机数

public dimension getminimumsize(int columns)
获取具有指定列数的文本字段的最小尺寸。

参数:
columns - 此文本字段中的列数。
从以下版本开始:
jdk1.1

minimumsize

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


getminimumsize

public dimension getminimumsize()
获取此文本字段的最小尺寸。

覆盖:
component 中的 getminimumsize
返回:
显示此文本字段的最小尺寸。
从以下版本开始:
jdk1.1
另请参见:
component.getpreferredsize(),layoutmanager

minimumsize

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

覆盖:
component 中的 minimumsize

addactionlistener网站地图 手机端

public void addactionlistener(actionlistener l)
添加指定的操作侦听器,以从此文本字段接收操作事件。如果 l 为 null,则不抛出任何异常,也不执行任何操作。

有关 awt 线程模式的详细信息,请参考 awt threading issues

参数:
l - 操作侦听器。
从以下版本开始:
jdk1.1
另请参见:
removeactionlistener(java.awt.event.actionlistener),getactionlisteners(),actionlistener

removeactionlistener

public void removeactionlistener(actionlistener l)
移除指定的操作侦听器,不再从此文本字段接收操作事件。如果 l 为 null,则不抛出任何异常,也不执行任何操作。

有关 awt 线程模式的详细信息,请参考 awt threading issues

参数:
l - 操作侦听器。
从以下版本开始:
jdk1.1
另请参见:
addactionlistener(java.awt.event.actionlistener),getactionlisteners(),actionlistener

getactionlisteners

public actionlistener[] getactionlisteners()
返回此文本字段上已注册的所有操作侦听器的数组。

返回:
此文本字段的所有 actionlistener;如果当前没有注册任何操作侦听器,则返回一个空数组。
从以下版本开始:
1.4
另请参见:
addactionlistener(java.awt.event.actionlistener),removeactionlistener(java.awt.event.actionlistener),java.awt.event

getlisteners

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

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

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

覆盖:
textcomponent 中的 getlisteners
参数:
listenertype - 所请求的侦听器类型;此参数应该<yīng gāi>指定一个从 java.util.eventlistener 继承的接口
返回:
在此文本字段上作为 foolistener 注册的所有对象的数组;如果尚未添加这样<then>的侦听器,则返回一个空数组
抛出:
classcastexception - 如果 listenertype 未指定一个实现 java.util.eventlistener 的类或接口
从以下版本开始:
1.3
另请参见:
getactionlisteners()

processevent

protected void processevent(awtevent e)
处理此文本字段上的事件。如果事件是 actionevent 的一个实例,则此方法将调用 processactionevent 方法。否则,它将调用超类的 processevent 方法。

注意<zhù yì>,如果事件参数为 null,则行为是不明确的,并可能导致异常。

覆盖:
textcomponent 中的 processevent
参数:
e - 事件
从以下版本开始:
jdk1.1
另请参见:
actionevent,processactionevent(java.awt.event.actionevent)

processactionevent

protected void processactionevent(actionevent e)
处理发生在此文本字段上的操作事件:将这些事件指派给所有已注册的 actionlistener 对象。

只有此组件启用了操作事件时,才调用此方法。发生以下事件之一时将启用操作事件:

注意<zhù yì>,如果事件参数为 null,则行为是不明确的,并可能导致异常。

参数:
e - 操作事件
从以下版本开始:
jdk1.1
另请参见:
actionlistener,addactionlistener(java.awt.event.actionlistener),component.enableevents(long)

paramstring

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

覆盖:
textcomponent 中的 paramstring
返回:
此文本字段的参数字符串

getaccessiblecontext

public accessiblecontext getaccessiblecontext()
获取与此 textfield 关联的 accessiblecontext。对于文本字段,accessiblecontext 采用 accessibleawttextfield 的形式。如有必要,可创建一个新的 accessibleawttextfield 实例。

指定者:
接口 accessible 中的 getaccessiblecontext
覆盖:
textcomponent 中的 getaccessiblecontext
返回:
一个 accessibleawttextfield,它充当此 textfield 的 accessiblecontext。
从以下版本开始:
1.3

javatm platform
standard ed. 6

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

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