java.awt
클래스 TextField

java.lang.Object 
  java.awt.Component 
      java.awt.TextComponent 
          java.awt.TextField

모든 구현된 인터페이스:

ImageObserver, MenuContainer, Serializable, Accessible

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개 이상의 키 이벤트가 텍스트 필드에 보내집니다. 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), 직렬화 된 형식

중첩(Nested) 클래스 개요

protected class

TextField.AccessibleAWTTextField 이 클래스는 TextField 클래스용의 사용자 보조 기능의 지원를 구현하고 있습니다.

클래스 java.awt. TextComponent 로부터 상속된 중첩(Nested) 클래스/인터페이스

TextComponent.AccessibleAWTTextComponent

클래스 java.awt. Component 로부터 상속된 중첩(Nested) 클래스/인터페이스

Component.AccessibleAWTComponent, 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 () 메아리용으로 사용되는 문자를 리턴합니다.
<T extends EventListener > T[]	getListeners (Class <T> 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, 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, 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, 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

생성자 상세

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

@Deprecated 
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

@Deprecated 
public Dimension  preferredSize(int columns)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getPreferredSize(int)를 사용합니다.

getPreferredSize

public Dimension  getPreferredSize()

이 텍스트 필드의 추천 사이즈를 리턴합니다.

오버라이드(override):

클래스 Component 내의 getPreferredSize

반환값:

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

도입된 버전 :

JDK1. 1

관련 항목:

Component.getMinimumSize(), LayoutManager

preferredSize

@Deprecated 
public Dimension  preferredSize()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getPreferredSize()를 사용합니다.

오버라이드(override):

클래스 Component 내의 preferredSize

getMinimumSize

public Dimension  getMinimumSize(int columns)

지정된 렬수에서의, 이 텍스트 필드의 최소 사이즈를 리턴합니다.

파라미터:

columns - 이 텍스트 필드의 렬수

도입된 버전 :

JDK1. 1

minimumSize

@Deprecated 
public Dimension  minimumSize(int columns)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getPreferredSize(int)를 사용합니다.

getMinimumSize

public Dimension  getMinimumSize()

이 텍스트 필드의 최소 사이즈를 리턴합니다.

오버라이드(override):

클래스 Component 내의 getMinimumSize

반환값:

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

도입된 버전 :

JDK1. 1

관련 항목:

Component.getPreferredSize(), LayoutManager

minimumSize

@Deprecated 
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 <T extends EventListener > T[] getListeners(Class <T> 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