java.awt
클래스 TextField

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

모든 구현 인터페이스:

Accessible , ImageObserver , MenuContainer , Serializable

public class TextField

extends TextComponent

TextField 오브젝트는 1 행의 텍스트의 편집을 실시할 수 있게 하는 텍스트 컴퍼넌트입니다.

예를 들어, 다음의 그림은 폭이 다른 4 개의 텍스트 필드를 가지는 프레임을 나타내고 있습니다. 이러한 텍스트 필드 가운데 2 개에는 "Hello" 라고 하는 정의 끝난 텍스트가 표시됩니다.

이것들 4 개의 텍스트 필드를 생성하는 코드를 다음에 나타냅니다.

 TextField tf1, tf2, tf3, tf4;
 // a blank text field
 tf1 = new TextField();
 // blank field of 20 columns
 tf2 = new TextField("", 20);
 // predefined text displayed
 tf3 = new TextField("Hello! ");
 // predefined text in 30 columns
 tf4 = new TextField("Hello", 30);
 

유저가 텍스트 필드로 키를 누를 때마다, 1 kr 이상의 키 이벤트가 텍스트 필드에 보내집니다. KeyEvent 는 keyPressed, keyReleased, keyTyped 라고 하는 3 개의 타입의 어떤 것인가가 됩니다. 키 이벤트의 프로퍼티는 그 이벤트가 이러한 타입 가운데 어느 것으로 되는지 및 키 이벤트에 적용되는 수식자나 이벤트 발생의 시간등의 이벤트에 관한 추가 정보를 나타냅니다.

키 이벤트는 컴퍼넌트의 addKeyListener 메소드를 사용해, 그 이벤트를 받도록(듯이) 등록되어 모든 KeyListener 오브젝트 또는 KeyAdapter 오브젝트에게 건네집니다. KeyAdapter 오브젝트는 KeyListener 인터페이스를 구현하고 있습니다.

ActionEvent 를 방아쇠 하는 일도 가능합니다. 텍스트 필드로 액션 이벤트가 가능한 경우,Return 키를 누르면(자) 이벤트가 방아쇠 됩니다.

TextField 클래스의 processEvent 메소드가 액션 이벤트를 조사해, 그 이벤트를 processActionEvent 에 건네줍니다. processActionEvent 메소드는 이 텍스트 필드가 생성하는 액션 이벤트를 받도록(듯이) 등록되어 모든 ActionListener 오브젝트에 이벤트를 전송 합니다.

도입된 버젼:

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 class

TextField.AccessibleAWTTextField 이 클래스는 TextField 클래스용의 유저 보조 기능의 서포트를 구현하고 있습니다.

클래스 java.awt. TextComponent 을 상속받은 중첩된 클래스

클래스 java.awt. Component 을 상속받은 중첩된 클래스

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)
지정된 텍스트가 표시되도록(듯이) 초기화되어 지정된 렬수를 표시할 수 있는 폭의 새로운 텍스트 필드를 구축합니다.

메소드의 개요

void	addActionListener (ActionListener l) 이 텍스트 필드의 액션 이벤트를 받기 위해서(때문에), 지정된 액션 청취자를 추가합니다.
void	addNotify () TextField 의 피어를 작성합니다.
boolean	echoCharIsSet () 이 텍스트 필드로 에코용의 캐릭터가 설정되어 있는지 어떤지를 나타냅니다.
AccessibleContext	getAccessibleContext () 이 TextField 에 관련한 AccessibleContext 를 돌려줍니다.
ActionListener []	getActionListeners () 이 텍스트 필드에 등록된 모든 액션 청취자의 배열을 돌려줍니다.
int	getColumns () 이 텍스트 필드의 렬수를 돌려줍니다.
char	getEchoChar () 에코용으로 사용되는 캐릭터를 돌려줍니다.
EventListener []	getListeners (Class listenerType) 이 TextField 에 FooListener 로서 현재 등록되어 모든 오브젝트의 배열을 돌려줍니다.
Dimension	getMinimumSize () 이 텍스트 필드의 최소 사이즈를 돌려줍니다.
Dimension	getMinimumSize (int columns) 지정된 렬수에서의, 이 텍스트 필드의 최소 사이즈를 돌려줍니다.
Dimension	getPreferredSize () 이 텍스트 필드의 추천 사이즈를 돌려줍니다.
Dimension	getPreferredSize (int columns) 지정된 렬수에서의, 이 텍스트 필드의 추천 사이즈를 돌려줍니다.
Dimension	minimumSize () 추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getMinimumSize() 를 사용
Dimension	minimumSize (int columns) 추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getPreferredSize(int) 를 사용
protected String	paramString () 이 TextField 상태를 나타내는 캐릭터 라인을 돌려줍니다.
Dimension	preferredSize () 추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getPreferredSize() 를 사용
Dimension	preferredSize (int columns) 추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getPreferredSize(int) 를 사용
protected void	processActionEvent (ActionEvent e) 이 텍스트 필드로 발생하는 액션 이벤트를, 등록된 ActionListener 오브젝트에 디스팟치 하는 것으로써, 이 이벤트를 처리합니다.
protected void	processEvent (AWTEvent e) 이 텍스트 필드의 이벤트를 처리합니다.
void	removeActionListener (ActionListener l) 이후 이 텍스트 필드로부터 액션 이벤트를 받지 않게, 지정된 액션 청취자를 삭제합니다.
void	setColumns (int columns) 이 텍스트 필드의 렬수를 설정합니다.
void	setEchoChar (char c) 이 텍스트 필드의 에코 캐릭터를 설정합니다.
void	setEchoCharacter (char c) 추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 setEchoChar(char) 를 사용
void	setText (String t) 이 텍스트 컴퍼넌트로 표시되는 텍스트를, 지정된 텍스트로 설정합니다.

클래스 java.awt. TextComponent 에서 상속받은 메소드

addTextListener , enableInputMethods , getBackground , getCaretPosition , 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 , getAlignmentX , getAlignmentY , getBounds , getBounds , getColorModel , getComponentAt , getComponentAt , getComponentListeners , getComponentOrientation , getCursor , getDropTarget , getFocusCycleRootAncestor , getFocusListeners , getFocusTraversalKeys , getFocusTraversalKeysEnabled , getFont , getFontMetrics , getForeground , getGraphics , getGraphicsConfiguration , getHeight , getHierarchyBoundsListeners , getHierarchyListeners , getIgnoreRepaint , getInputContext , getInputMethodListeners , getInputMethodRequests , getKeyListeners , getLocale , getLocation , getLocation , getLocationOnScreen , getMaximumSize , getMouseListeners , getMouseMotionListeners , 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 , isOpaque , 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 , resize , setBounds , setBounds , setComponentOrientation , setCursor , setDropTarget , setEnabled , setFocusable , setFocusTraversalKeys , setFocusTraversalKeysEnabled , setFont , setForeground , setIgnoreRepaint , setLocale , setLocation , setLocation , setName , 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

생성자의 상세

TextField

public TextField()
          throws HeadlessException 

새로운 텍스트 필드를 구축합니다.

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

관련 항목:

GraphicsEnvironment.isHeadless()

TextField

public TextField(String  text)
          throws HeadlessException 

지정된 텍스트로 초기화된 새로운 텍스트 필드를 구축합니다.

파라미터:

text - 표시하는 텍스트. text 가 null 의 경우는 하늘의 캐릭터 라인 "" 이 표시된다

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

관련 항목:

GraphicsEnvironment.isHeadless()

TextField

public TextField(int columns)
          throws HeadlessException 

지정된 렬수로 새로운 하늘의 텍스트 필드를 구축합니다. 렬폭은 플랫폼에 의해 달라 대략 평균 캐릭터폭이 됩니다.

파라미터:

columns - 렬수. columns 가 0 보다 작은 경우,columns 는 0 으로 설정된다

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

관련 항목:

GraphicsEnvironment.isHeadless()

TextField

public TextField(String  text,
                 int columns)
          throws HeadlessException 

지정된 텍스트가 표시되도록(듯이) 초기화되어 지정된 렬수를 표시할 수 있는 폭의 새로운 텍스트 필드를 구축합니다. 렬폭은 플랫폼에 의해 달라 대략 평균 캐릭터폭이 됩니다.

파라미터:

text - 표시하는 텍스트. text 가 null 의 경우는 하늘의 캐릭터 라인 "" 이 표시되는

columns - 렬수. columns 가 0 보다 작은 경우,columns 는 0 으로 설정된다

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

관련 항목:

GraphicsEnvironment.isHeadless()

메소드의 상세

addNotify

public void addNotify()

TextField 의 피어를 작성합니다. 피어를 사용하는 것으로, 기능을 변경하지 않고 TextField 의 외관을 변경할 수가 있습니다.

오버라이드(override):

클래스 TextComponent 내의 addNotify

관련 항목:

TextComponent.removeNotify()

getEchoChar

public char getEchoChar()

에코용으로 사용되는 캐릭터를 돌려줍니다.

에코 캐릭터는 패스워드 입력용 텍스트 필드 등, 유저 입력이 화면에 표시되어서는 안 되는 텍스트 필드로 사용됩니다. echoChar = 0 의 경우, 유저가 입력한 채로 화면에 표시됩니다.

반환값:

이 텍스트 필드의 에코 캐릭터

관련 항목:

echoCharIsSet() , setEchoChar(char)

setEchoChar

public void setEchoChar(char c)

이 텍스트 필드의 에코 캐릭터를 설정합니다.

에코 캐릭터는 패스워드 입력용 텍스트 필드 등, 유저 입력이 화면에 표시되어서는 안 되는 텍스트 필드로 사용됩니다. echoChar = 0 으로 설정하면(자), 유저 입력을 다시 화면에 표시할 수 있습니다.

파라미터:

c - 이 텍스트 필드의 에코 캐릭터

도입된 버젼:

JDK1. 1

관련 항목:

echoCharIsSet() , getEchoChar()

setEchoCharacter

public void setEchoCharacter(char c)

추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 setEchoChar(char) 를 사용

setText

public void setText(String  t)

이 텍스트 컴퍼넌트로 표시되는 텍스트를, 지정된 텍스트로 설정합니다.

오버라이드(override):

클래스 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

public Dimension  preferredSize(int columns)

추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getPreferredSize(int) 를 사용

getPreferredSize

public Dimension  getPreferredSize()

이 텍스트 필드의 추천 사이즈를 돌려줍니다.

오버라이드(override):

클래스 Component 내의 getPreferredSize

반환값:

이 텍스트 필드를 표시하기 위한 추천 사이즈

도입된 버젼:

JDK1. 1

관련 항목:

Component.getMinimumSize() , LayoutManager

preferredSize

public Dimension  preferredSize()

추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getPreferredSize() 를 사용

오버라이드(override):

클래스 Component 내의 preferredSize

getMinimumSize

public Dimension  getMinimumSize(int columns)

지정된 렬수에서의, 이 텍스트 필드의 최소 사이즈를 돌려줍니다.

파라미터:

columns - 이 텍스트 필드의 렬수

도입된 버젼:

JDK1. 1

minimumSize

public Dimension  minimumSize(int columns)

추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getPreferredSize(int) 를 사용

getMinimumSize

public Dimension  getMinimumSize()

이 텍스트 필드의 최소 사이즈를 돌려줍니다.

오버라이드(override):

클래스 Component 내의 getMinimumSize

반환값:

이 텍스트 필드를 표시하기 위한 최소 사이즈

도입된 버젼:

JDK1. 1

관련 항목:

Component.getPreferredSize() , LayoutManager

minimumSize

public Dimension  minimumSize()

추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getMinimumSize() 를 사용

오버라이드(override):

클래스 Component 내의 minimumSize

addActionListener

public void addActionListener(ActionListener  l)

이 텍스트 필드의 액션 이벤트를 받기 위해서(때문에), 지정된 액션 청취자를 추가합니다. l 가 null 의 경우, 예외는 슬로우 되지 않고 처리도 실행되지 않습니다.

파라미터:

l - 액션 청취자

도입된 버젼:

JDK1. 1

관련 항목:

removeActionListener(java.awt.event.ActionListener) , getActionListeners() , ActionListener

removeActionListener

public void removeActionListener(ActionListener  l)

이후 이 텍스트 필드로부터 액션 이벤트를 받지 않게, 지정된 액션 청취자를 삭제합니다. l 가 null 의 경우, 예외는 슬로우 되지 않고 처리도 실행되지 않습니다.

파라미터:

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 EventListener [] getListeners(Class  listenerType)

이 TextField 에 FooListener 로서 현재 등록되어 모든 오브젝트의 배열을 돌려줍니다. FooListener 는 addFooListener 메소드를 사용해 등록됩니다.

FooListener.class 등의 클래스 리터럴을 가지는 listenerType 인수를 지정할 수 있습니다. 예를 들어, 다음의 코드를 사용해, 그 액션 청취자의 TextField t 를 조회할 수 있습니다.

ActionListener[] als = (ActionListener[])(t.getListeners(ActionListener.class));

이러한 청취자가 존재하지 않는 경우, 이 메소드는 하늘의 배열을 돌려줍니다.

오버라이드(override):

클래스 TextComponent 내의 getListeners

파라미터:

listenerType - 요구된 청취자의 형태. 이 파라미터는 java.util.EventListener 로부터 파생하는 인터페이스를 지정한다

반환값:

이 텍스트 필드의 FooListener 로서 등록된 모든 오브젝트의 배열, 또는 이러한 청취자가 추가되지 않았던 경우는 하늘의 배열

예외:

ClassCastException - listenerType 가,java.util.EventListener 를 구현하는 클래스 또는 인터페이스를 지정하지 않는 경우

도입된 버젼:

1.3

관련 항목:

getActionListeners()

processEvent

protected void processEvent(AWTEvent  e)

이 텍스트 필드의 이벤트를 처리합니다. 이벤트가 ActionEvent 의 인스턴스인 경우는 processActionEvent 메소드를 호출합니다. 그렇지 않은 경우는 슈퍼 클래스의 processEvent 를 호출합니다.

이벤트 파라미터가 null 의 경우, 동작이 지정되지 않고 예외가 발생하는 것에 주의해 주세요.

오버라이드(override):

클래스 TextComponent 내의 processEvent

파라미터:

e - 이벤트

도입된 버젼:

JDK1. 1

관련 항목:

ActionEvent , processActionEvent(java.awt.event.ActionEvent)

processActionEvent

protected void processActionEvent(ActionEvent  e)

이 텍스트 필드로 발생하는 액션 이벤트를, 등록된 ActionListener 오브젝트에 디스팟치 하는 것으로써, 이 이벤트를 처리합니다.

이 컴퍼넌트에 대해서 액션 이벤트가 사용 가능하지 않은 한, 이 메소드는 불려 가지 않습니다. 액션 이벤트는 다음의 어느 쪽인가의 경우에 사용 가능하게 됩니다.

• ActionListener 오브젝트가 addActionListener 에 의해 등록되어 있다
• enableEvents 에 의해 액션 이벤트가 사용 가능하게 되어 있다

이벤트 파라미터가 null 의 경우, 동작이 지정되지 않고 예외가 발생하는 것에 주의해 주세요.

파라미터:

e - 액션 이벤트

도입된 버젼:

JDK1. 1

관련 항목:

ActionListener , addActionListener(java.awt.event.ActionListener) , Component.enableEvents(long)

paramString

protected String  paramString()

이 TextField 상태를 나타내는 캐릭터 라인을 돌려줍니다. 이 메소드는 디버그 전용이며, 돌려주어지는 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 돌려주어지는 캐릭터 라인은 비었을 경우가 있습니다만,null 로는 되지 않습니다.

오버라이드(override):

클래스 TextComponent 내의 paramString

반환값:

이 텍스트 필드의 파라미터 캐릭터 라인

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 TextField 에 관련한 AccessibleContext 를 돌려줍니다. 텍스트 필드의 경우, AccessibleContext 는 AccessibleAWTTextField 의 형식을 취합니다. 신규의 AccessibleAWTTextField 인스턴스가 필요에 따라서 작성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 TextComponent 내의 getAccessibleContext

반환값:

이 TextField 의 AccessibleContext 로서 기능하는 AccessibleAWTTextField