java.awt
클래스 TextComponent

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

모든 구현 인터페이스:

Accessible , ImageObserver , MenuContainer , Serializable

직계의 기존의 서브 클래스:

TextArea , TextField

public class TextComponent

extends Component

implements Accessible

TextComponent 클래스는 텍스트의 편집을 가능하게 하는 모든 컴퍼넌트의 슈퍼 클래스입니다.

텍스트 컴퍼넌트는 텍스트의 캐릭터 라인을 구체적으로 표현합니다. TextComponent 클래스는 이 텍스트가 편집 가능한지 어떤지를 판정하는 메소드 세트를 정의합니다. 컴퍼넌트가 편집 가능한 경우는 텍스트 삽입 caret를 서포트하는 다른 메소드 세트도 정의합니다.

또, 이 클래스는 텍스트의 현재의 선택 범위를 보관 유지하기 위해서 사용되는 메소드도 정의합니다. 컴퍼넌트의 텍스트의 부분 텍스트인 텍스트의 선택 범위는 편집 조작의 대상이 됩니다. 텍스트의 선택 범위는 선택 텍스트라고도 불립니다.

도입된 버젼:

JDK1. 0

관련 항목:

직렬화 된 형식

중첩된 클래스의 개요

protected class

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

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

Component.BltBufferStrategy , Component.FlipBufferStrategy

필드의 개요

protected TextListener

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

메소드의 개요

void	addNotify () 네이티브 스크린 리소스에 접속해, 이 Component 를 표시 가능하게 합니다.
void	addTextListener (TextListener l) 이 텍스트 컴퍼넌트로부터 텍스트 이벤트를 받기 위해서(때문에), 지정된 텍스트 이벤트 청취자를 추가합니다.
void	enableInputMethods (boolean enable) 이 컴퍼넌트의 인풋 메소드 서포트를 사용 가능 또는 사용 불가능하게 합니다.
AccessibleContext	getAccessibleContext () 이 TextComponent 에 관련한 AccessibleContext 를 돌려줍니다.
Color	getBackground () 이 텍스트 컴퍼넌트의 백그라운드 칼라를 돌려줍니다.
int	getCaretPosition () 이 텍스트 컴퍼넌트의 텍스트 삽입 caret의 위치를 돌려줍니다.
EventListener []	getListeners (Class listenerType) 이 TextComponent 에 FooListener 로서 현재 등록되어 모든 오브젝트의 배열을 돌려줍니다.
String	getSelectedText () 이 텍스트 컴퍼넌트에 의해 표시되는 텍스트로부터 선택 텍스트를 돌려줍니다.
int	getSelectionEnd () 이 텍스트 컴퍼넌트의 선택 텍스트의 종점을 돌려줍니다.
int	getSelectionStart () 이 텍스트 컴퍼넌트의 선택 텍스트의 시점을 돌려줍니다.
String	getText () 이 텍스트 컴퍼넌트에 의해 표시되는 텍스트를 돌려줍니다.
TextListener []	getTextListeners () 이 텍스트 컴퍼넌트에 등록된 모든 텍스트 청취자의 배열을 돌려줍니다.
boolean	isEditable () 이 텍스트 컴퍼넌트가 편집 가능한지 어떤지를 나타냅니다.
protected String	paramString () 이 TextComponent 상태를 나타내는 캐릭터 라인을 돌려줍니다.
protected void	processEvent (AWTEvent e) 이 텍스트 컴퍼넌트의 이벤트를 처리합니다.
protected void	processTextEvent (TextEvent e) 이 텍스트 컴퍼넌트로 발생하는 액션 이벤트를, 등록된 TextListener 오브젝트에 디스팟치 하는 것으로써, 액션 이벤트를 처리합니다.
void	removeNotify () TextComponent 의 피어를 삭제합니다.
void	removeTextListener (TextListener l) 이후 이 텍스트 컴퍼넌트로부터 텍스트 이벤트를 받지 않게, 지정된 텍스트 이벤트 청취자를 삭제합니다.
void	select (int selectionStart, int selectionEnd) 지정된 시점과 종점의 사이에 있는 텍스트를 선택합니다.
void	selectAll () 이 텍스트 컴퍼넌트내의 모든 텍스트를 선택합니다.
void	setBackground (Color c) 이 텍스트 컴퍼넌트의 백그라운드 칼라를 설정합니다.
void	setCaretPosition (int position) 이 텍스트 컴퍼넌트에 텍스트 삽입 caret의 위치를 설정합니다.
void	setEditable (boolean b) 이 텍스트 컴퍼넌트가 편집 가능한가 어떤가를 지정하는 플래그를 설정합니다.
void	setSelectionEnd (int selectionEnd) 이 텍스트 컴퍼넌트의 선택 범위의 종점을, 지정된 위치로 설정합니다.
void	setSelectionStart (int selectionStart) 이 텍스트 컴퍼넌트의 선택 범위의 시점을, 지정된 위치로 설정합니다.
void	setText (String t) 이 텍스트 컴퍼넌트로 표시되는 텍스트를, 지정된 텍스트로 설정합니다.

클래스 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 , getMinimumSize , getMouseListeners , getMouseMotionListeners , getMouseWheelListeners , getName , getParent , getPeer , getPreferredSize , 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 , minimumSize , mouseDown , mouseDrag , mouseEnter , mouseExit , mouseMove , mouseUp , move , nextFocus , paint , paintAll , postEvent , preferredSize , 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

필드의 상세

textListener

protected transient TextListener  textListener

메소드의 상세

enableInputMethods

public void enableInputMethods(boolean enable)

클래스 Component 의 기술:

이 컴퍼넌트의 인풋 메소드 서포트를 사용 가능 또는 사용 불가능하게 합니다. 인풋 메소드 서포트가 사용 가능해, 컴퍼넌트가 키 이벤트도 처리하는 경우, 입력 이벤트는 현재의 인풋 메소드에 제공되어 그 컴퍼넌트 에 의해서만 처리되는지 인풋 메소드가 사용하지 않으면, 그 청취자에게 보내집니다. 디폴트에서는 인풋 메소드 서포트는 사용 가능합니다.

오버라이드(override):

클래스 Component 내의 enableInputMethods

파라미터:

enable - 사용 가능하게 하려면 true, 사용 불가능하게 하려면 false

관련 항목:

Component.processKeyEvent(java.awt.event.KeyEvent)

addNotify

public void addNotify()

네이티브 스크린 리소스에 접속해, 이 Component 를 표시 가능하게 합니다. 이 메소드는 툴 킷에 의해 내부에서 불려 갑니다. 프로그램으로부터 직접 호출할 수 없습니다.

오버라이드(override):

클래스 Component 내의 addNotify

관련 항목:

removeNotify()

removeNotify

public void removeNotify()

TextComponent 의 피어를 삭제합니다. 피어는 TextComponent 의 기능을 바꾸지 않고 로 외관을 변경할 수가 있습니다.

오버라이드(override):

클래스 Component 내의 removeNotify

관련 항목:

Component.isDisplayable() , Component.addNotify()

setText

public void setText(String  t)

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

파라미터:

t - 새로운 텍스트. 이 파라미터가 null 의 경우, 텍스트는 하늘의 캐릭터 라인 "" 으로 설정되는

관련 항목:

getText()

getText

public String  getText()

이 텍스트 컴퍼넌트에 의해 표시되는 텍스트를 돌려줍니다.

관련 항목:

setText(java.lang.String)

getSelectedText

public String  getSelectedText()

이 텍스트 컴퍼넌트에 의해 표시되는 텍스트로부터 선택 텍스트를 돌려줍니다.

반환값:

이 텍스트 컴퍼넌트의 선택 텍스트

관련 항목:

select(int, int)

isEditable

public boolean isEditable()

이 텍스트 컴퍼넌트가 편집 가능한지 어떤지를 나타냅니다.

반환값:

이 텍스트 컴퍼넌트가 편집 가능한 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

JDK1. 0

관련 항목:

setEditable(boolean)

setEditable

public void setEditable(boolean b)

이 텍스트 컴퍼넌트가 편집 가능한가 어떤가를 지정하는 플래그를 설정합니다.

플래그가 true 로 설정되어 있는 경우, 텍스트 컴퍼넌트는 유저에 의한 편집이 가능하게 됩니다. 플래그가 false 로 설정되어 있는 경우, 유저는 이 텍스트 컴퍼넌트의 텍스트를 변경할 수 없습니다. 디폴트로, 편집 불가능한 텍스트 컴퍼넌트는 SystemColor.control 의 백그라운드 칼라를 가집니다. 이 디폴트는 setBackground 의 호출에 의해 오버라이드(override) 할 수 있습니다.

파라미터:

b - 이 텍스트 컴퍼넌트가 유저에 의해 편집 가능한가 어떤가를 나타내는 플래그

도입된 버젼:

JDK1. 0

관련 항목:

isEditable()

getBackground

public Color  getBackground()

이 텍스트 컴퍼넌트의 백그라운드 칼라를 돌려줍니다. 디폴트로, 편집 불가능한 텍스트 컴퍼넌트는 SystemColor.control 의 백그라운드 칼라를 가집니다. 이 디폴트는 setBackground 의 호출에 의해 오버라이드(override) 할 수 있습니다.

오버라이드(override):

클래스 Component 내의 getBackground

반환값:

이 텍스트 컴퍼넌트의 백그라운드 칼라. 이 텍스트 컴퍼넌트에 백그라운드 칼라가 없는 경우는 부모의 백그라운드 칼라가 돌려주어지는

도입된 버젼:

JDK1. 0

관련 항목:

setBackground

setBackground

public void setBackground(Color  c)

이 텍스트 컴퍼넌트의 백그라운드 칼라를 설정합니다.

오버라이드(override):

클래스 Component 내의 setBackground

파라미터:

c - 이 텍스트 컴퍼넌트의 색이 되는 색. 이 파라미터가 null 의 경우, 이 텍스트 컴퍼넌트는 부모의 백그라운드 칼라를 계승하는

도입된 버젼:

JDK1. 0

관련 항목:

getBackground()

getSelectionStart

public int getSelectionStart()

이 텍스트 컴퍼넌트의 선택 텍스트의 시점을 돌려줍니다.

반환값:

선택 텍스트의 시점

관련 항목:

setSelectionStart(int) , getSelectionEnd()

setSelectionStart

public void setSelectionStart(int selectionStart)

이 텍스트 컴퍼넌트의 선택 범위의 시점을, 지정된 위치로 설정합니다. 새로운 시점은 현재의 선택 범위의 종점 이전에 제한됩니다. 또, 컴퍼넌트의 텍스트의 선두를 나타내는 0 보다 작은 값으로 설정할 수 없습니다. 호출측이 지정한 selectionStart 의 값이 경계외인 경우에서도, 이 메소드는 실패하는 일 없이, 암묵적으로 이러한 제약을 적용합니다.

파라미터:

selectionStart - 선택 텍스트의 시점

도입된 버젼:

JDK1. 1

관련 항목:

getSelectionStart() , setSelectionEnd(int)

getSelectionEnd

public int getSelectionEnd()

이 텍스트 컴퍼넌트의 선택 텍스트의 종점을 돌려줍니다.

반환값:

선택 텍스트의 종점

관련 항목:

setSelectionEnd(int) , getSelectionStart()

setSelectionEnd

public void setSelectionEnd(int selectionEnd)

이 텍스트 컴퍼넌트의 선택 범위의 종점을, 지정된 위치로 설정합니다. 새로운 종점은 현재의 선택 범위의 시점 이후에 제한됩니다. 또, 컴퍼넌트의 텍스트의 말미를 넘는 값으로 설정할 수 없습니다. 호출측이 지정한 selectionEnd 의 값이 경계외인 경우에서도, 이 메소드는 실패하는 일 없이, 암묵적으로 이러한 제약을 적용합니다.

파라미터:

selectionEnd - 선택 텍스트의 종점

도입된 버젼:

JDK1. 1

관련 항목:

getSelectionEnd() , setSelectionStart(int)

select

public void select(int selectionStart,
                   int selectionEnd)

지정된 시점과 종점의 사이에 있는 텍스트를 선택합니다.

이 메소드는 선택 텍스트의 시점과 종점을 설정합니다. 시점은 제로 이상이 아니면 안된다고 하는 제약이 적용됩니다. 종점은 시점과 같은가, 그것보다 크지 않으면 안되어, 또 텍스트 컴퍼넌트의 텍스트의 길이에 동일한지 그것보다 작지 않으면 안됩니다. 캐릭터의 위치는 제로로부터 시작되는 인덱스로 지정합니다. 선택 범위의 길이는 endPosition - startPosition 입니다. 그 때문에,endPosition 에 있는 캐릭터는 선택되지 않습니다. 선택 텍스트의 시점과 종점이 같은 경우는 모든 텍스트의 선택이 해제됩니다.

호출측이 일관성의 없는 값 또는 경계외의 값을 지정했을 경우, 메소드는 메세지를 표시하지 않고 , 이러한 제약을 적용합니다. 구체적으로는 시점 또는 종점이 텍스트의 길이를 넘는 경우, 텍스트와 같은 길이로 다시 설정합니다. 시점이 제로보다 작은 경우, 제로로 다시 설정합니다. 종점이 시점보다 작은 경우, 시점으로 다시 설정합니다.

파라미터:

selectionStart - 선택되는 최초의 캐릭터의 제로로부터 시작되는 인덱스

selectionEnd - 선택되는 텍스트의 종점을 나타내는 제로로부터 시작되는 인덱스. selectionEnd 에 있는 캐릭터는 선택되지 않는

관련 항목:

setSelectionStart(int) , setSelectionEnd(int) , selectAll()

selectAll

public void selectAll()

이 텍스트 컴퍼넌트내의 모든 텍스트를 선택합니다.

관련 항목:

select(int, int)

setCaretPosition

public void setCaretPosition(int position)

이 텍스트 컴퍼넌트에 텍스트 삽입 caret의 위치를 설정합니다. caret 위치는 현재의 선택 범위 말미나 그것보다 전에 제약됩니다. 호출측이 컴퍼넌트의 텍스트의 종점보다 큰 값을 position 로 지정했을 경우, caret 위치는 컴퍼넌트의 텍스트의 종점으로 설정됩니다. 이것은 메세지의 표시없이 행해집니다. caret 위치는 또, 컴퍼넌트의 텍스트의 시점인 제로보다 작게 설정할 수 없습니다. 호출측이 제로보다 작은 값을 position 로 지정했을 경우,IllegalArgumentException 가 슬로우 됩니다.

파라미터:

position - 텍스트 삽입 caret의 위치

예외:

IllegalArgumentException - position 로 지정한 값이 0 미만의 경우

도입된 버젼:

JDK1. 1

getCaretPosition

public int getCaretPosition()

이 텍스트 컴퍼넌트의 텍스트 삽입 caret의 위치를 돌려줍니다.

반환값:

텍스트 삽입 caret의 위치

도입된 버젼:

JDK1. 1

addTextListener

public void addTextListener(TextListener  l)

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

파라미터:

l - 텍스트 이벤트 청취자

관련 항목:

removeTextListener(java.awt.event.TextListener) , getTextListeners() , TextListener

removeTextListener

public void removeTextListener(TextListener  l)

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

파라미터:

l - 텍스트 청취자

도입된 버젼:

JDK1. 1

관련 항목:

addTextListener(java.awt.event.TextListener) , getTextListeners() , TextListener

getTextListeners

public TextListener [] getTextListeners()

이 텍스트 컴퍼넌트에 등록된 모든 텍스트 청취자의 배열을 돌려줍니다.

반환값:

이 텍스트 컴퍼넌트의 모든 TextListener, 또는 현재 텍스트 청취자가 등록되지 않은 경우는 하늘의 배열

도입된 버젼:

1.4

관련 항목:

addTextListener(java.awt.event.TextListener) , removeTextListener(java.awt.event.TextListener)

getListeners

public EventListener [] getListeners(Class  listenerType)

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

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

TextListener[] tls = (TextListener[])(t.getListeners(TextListener.class));

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

오버라이드(override):

클래스 Component 내의 getListeners

파라미터:

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

반환값:

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

예외:

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

도입된 버젼:

1.3

관련 항목:

getTextListeners()

processEvent

protected void processEvent(AWTEvent  e)

이 텍스트 컴퍼넌트의 이벤트를 처리합니다. 이벤트가 TextEvent 의 경우,processTextEvent 메소드를 기동합니다. 그 외의 경우는 슈퍼 클래스의 processEvent 를 기동합니다.

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

오버라이드(override):

클래스 Component 내의 processEvent

파라미터:

e - 이벤트

관련 항목:

Component.processComponentEvent(java.awt.event.ComponentEvent) , Component.processFocusEvent(java.awt.event.FocusEvent) , Component.processKeyEvent(java.awt.event.KeyEvent) , Component.processMouseEvent(java.awt.event.MouseEvent) , Component.processMouseMotionEvent(java.awt.event.MouseEvent) , Component.processInputMethodEvent(java.awt.event.InputMethodEvent) , Component.processHierarchyEvent(java.awt.event.HierarchyEvent) , Component.processMouseWheelEvent(java.awt.event.MouseWheelEvent)

processTextEvent

protected void processTextEvent(TextEvent  e)

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

주: 이 메소드는 텍스트 이벤트가 이 컴퍼넌트에 대해서 유효하지 않은 경우는 불려 가지 않습니다. 이것은 다음의 몇개의 경우에 발생합니다.

• TextListener 오브젝트가 addTextListener 에 의해 등록되어 있다
• enableEvents 에 의해 텍스트 이벤트가 사용 가능하게 되어 있다

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

파라미터:

e - 텍스트 이벤트

관련 항목:

Component.enableEvents(long)

paramString

protected String  paramString()

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

오버라이드(override):

클래스 Component 내의 paramString

반환값:

이 텍스트 컴퍼넌트의 파라미터 캐릭터 라인

getAccessibleContext

public AccessibleContext  getAccessibleContext()

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

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 Component 내의 getAccessibleContext

반환값:

이 TextComponent 의 AccessibleContext 로서 기능하는 AccessibleAWTTextComponent