java.awt
클래스 TextArea

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

모든 구현 인터페이스:

Accessible , ImageObserver , MenuContainer , Serializable

public class TextArea

extends TextComponent

TextArea 오브젝트는 텍스트를 표시하는 복수행 area입니다. 편집 가능하게 설정하는 일도, 독해 전용으로 설정할 수도 있습니다.

다음의 그림은 텍스트 area의 외관을 나타냅니다.

이 텍스트 area는 다음의 코드에 의해 작성할 수 있습니다.

 new TextArea("Hello", 5, 40);
 

도입된 버젼:

JDK1. 0

관련 항목:

직렬화 된 형식

중첩된 클래스의 개요

protected class

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

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

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

Component.BltBufferStrategy , Component.FlipBufferStrategy

필드의 개요

static int	SCROLLBARS_BOTH 수평과 수직 스크롤 바를 작성해, 표시합니다.
static int	SCROLLBARS_HORIZONTAL_ONLY 수평 스크롤 바만을 작성해, 표시합니다.
static int	SCROLLBARS_NONE 이 텍스트 area의 어느 스크롤 바도 작성하지 않습니다.
static int	SCROLLBARS_VERTICAL_ONLY 수직 스크롤 바만을 작성해, 표시합니다.

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

생성자의 개요

TextArea ()
하늘의 텍스트 캐릭터 라인으로 새로운 텍스트 area를 구축합니다.

TextArea (int rows, int columns)
지정된 행수와 렬수와 하늘의 텍스트 캐릭터 라인을 가지는 새로운 텍스트 area를 구축합니다.

TextArea (String text)
지정된 텍스트로 새로운 텍스트 area를 구축합니다.

TextArea (String text, int rows, int columns)
지정된 행수와 렬수를 가지는 하늘의 텍스트 area를, 지정된 텍스트로 구축합니다.

TextArea (String text, int rows, int columns, int scrollbars)
지정된 행수 및 렬수의, 지정된 텍스트가 표시되는 새로운 텍스트 area를, 지정된 스크롤 바의 가시성으로 구축합니다.

메소드의 개요

void	addNotify () TextArea 의 피어를 작성합니다.
void	append (String str) 텍스트 area의 현재의 텍스트에, 지정된 텍스트를 추가합니다.
void	appendText (String str) 추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 append(String) 를 사용
AccessibleContext	getAccessibleContext () 이 TextArea 에 관련지을 수 있었던 AccessibleContext 를 돌려줍니다.
int	getColumns () 이 텍스트 area의 렬수를 돌려줍니다.
Dimension	getMinimumSize () 이 텍스트 area의 최소 사이즈를 판정합니다.
Dimension	getMinimumSize (int rows, int columns) 지정된 행수 및 렬수의 텍스트 area의 최소 사이즈를 판정합니다.
Dimension	getPreferredSize () 이 텍스트 area의 추천 사이즈를 판정합니다.
Dimension	getPreferredSize (int rows, int columns) 지정된 행수 및 렬수의 텍스트 area의 추천 사이즈를 판정합니다.
int	getRows () 텍스트 area의 행수를 돌려줍니다.
int	getScrollbarVisibility () 텍스트 area가 사용하는 스크롤 바를 나타내는 열거된 값을 돌려줍니다.
void	insert (String str, int pos) 이 텍스트 영역내의 지정된 위치에, 지정된 텍스트를 삽입합니다.
void	insertText (String str, int pos) 추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 insert(String, int) 를 사용
Dimension	minimumSize () 추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getMinimumSize() 를 사용
Dimension	minimumSize (int rows, int columns) 추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getMinimumSize(int, int) 를 사용
protected String	paramString () 이 TextArea 상태를 나타내는 캐릭터 라인을 돌려줍니다.
Dimension	preferredSize () 추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getPreferredSize() 를 사용
Dimension	preferredSize (int rows, int columns) 추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getPreferredSize(int, int) 를 사용
void	replaceRange (String str, int start, int end) 지정된 시점과 종점의 사이의 텍스트를, 지정된 텍스트에 옮겨놓습니다.
void	replaceText (String str, int start, int end) 추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 replaceRange(String, int, int) 를 사용
void	setColumns (int columns) 이 텍스트 area의 렬수를 설정합니다.
void	setRows (int rows) 이 텍스트 area의 행수를 설정합니다.

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

addTextListener , enableInputMethods , getBackground , getCaretPosition , getListeners , getSelectedText , getSelectionEnd , getSelectionStart , getText , getTextListeners , isEditable , processEvent , processTextEvent , removeNotify , removeTextListener , select , selectAll , setBackground , setCaretPosition , setEditable , setSelectionEnd , setSelectionStart , setText

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

필드의 상세

SCROLLBARS_BOTH

public static final int SCROLLBARS_BOTH

수평과 수직 스크롤 바를 작성해, 표시합니다.

도입된 버젼:

JDK1. 1

관련 항목:

정수 필드치

SCROLLBARS_VERTICAL_ONLY

public static final int SCROLLBARS_VERTICAL_ONLY

수직 스크롤 바만을 작성해, 표시합니다.

도입된 버젼:

JDK1. 1

관련 항목:

정수 필드치

SCROLLBARS_HORIZONTAL_ONLY

public static final int SCROLLBARS_HORIZONTAL_ONLY

수평 스크롤 바만을 작성해, 표시합니다.

도입된 버젼:

JDK1. 1

관련 항목:

정수 필드치

SCROLLBARS_NONE

public static final int SCROLLBARS_NONE

이 텍스트 area의 어느 스크롤 바도 작성하지 않습니다.

도입된 버젼:

JDK1. 1

관련 항목:

정수 필드치

생성자의 상세

TextArea

public TextArea()
         throws HeadlessException 

하늘의 텍스트 캐릭터 라인으로 새로운 텍스트 area를 구축합니다. 이 텍스트 area는 스크롤 바의 가시성이 SCROLLBARS_BOTH 의 설정으로 작성됩니다. 이 때문에, 이 텍스트 area에서는 수직과 수평의 양쪽 모두의 스크롤 바가 가시가 됩니다.

예외:

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

관련 항목:

GraphicsEnvironment.isHeadless()

TextArea

public TextArea(String  text)
         throws HeadlessException 

지정된 텍스트로 새로운 텍스트 area를 구축합니다. 이 텍스트 area는 스크롤 바의 가시성이 SCROLLBARS_BOTH 의 설정으로 작성됩니다. 이 때문에, 이 텍스트 area에서는 수직과 수평의 양쪽 모두의 스크롤 바가 가시가 됩니다.

파라미터:

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

예외:

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

관련 항목:

GraphicsEnvironment.isHeadless()

TextArea

public TextArea(int rows,
                int columns)
         throws HeadlessException 

지정된 행수와 렬수와 하늘의 텍스트 캐릭터 라인을 가지는 새로운 텍스트 area를 구축합니다. 렬폭은 플랫폼에 의해 달라 대략 평균 캐릭터폭이 됩니다. 텍스트 area는 스크롤 바의 가시성이 SCROLLBARS_BOTH 의 설정으로 작성됩니다. 이 때문에, 이 텍스트 area에서는 수직과 수평의 양쪽 모두의 스크롤 바가 가시가 됩니다.

파라미터:

rows - 행 수

columns - 렬수

예외:

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

관련 항목:

GraphicsEnvironment.isHeadless()

TextArea

public TextArea(String  text,
                int rows,
                int columns)
         throws HeadlessException 

지정된 행수와 렬수를 가지는 하늘의 텍스트 area를, 지정된 텍스트로 구축합니다. 렬폭은 플랫폼에 의해 달라 대략 평균 캐릭터폭이 됩니다. 텍스트 area는 스크롤 바의 가시성이 SCROLLBARS_BOTH 의 설정으로 작성됩니다. 이 때문에, 이 텍스트 area에서는 수직과 수평의 양쪽 모두의 스크롤 바가 가시가 됩니다.

파라미터:

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

rows - 행 수

columns - 렬수

예외:

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

관련 항목:

GraphicsEnvironment.isHeadless()

TextArea

public TextArea(String  text,
                int rows,
                int columns,
                int scrollbars)
         throws HeadlessException 

지정된 행수 및 렬수의, 지정된 텍스트가 표시되는 새로운 텍스트 area를, 지정된 스크롤 바의 가시성으로 구축합니다. 모든 TextArea constructor 은 이 constructor 에 따릅니다.

TextArea 는 scrollbars 의 인수의 값으로 해서 제공되는 다음과 같은 몇개의 정수를 정의합니다.

• SCROLLBARS_BOTH
• SCROLLBARS_VERTICAL_ONLY
• SCROLLBARS_HORIZONTAL_ONLY
• SCROLLBARS_NONE

scrollbars 의 그 외의 인수는 무효가 되어, 그 때문에 SCROLLBARS_BOTH 의 기정치와 같은 스크롤 바의 가시성이 이 텍스트 area로 작성됩니다.

파라미터:

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

rows - 행 수. rows 가 0 보다 작은 경우,rows 는 0 으로 설정되는

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

scrollbars - 텍스트 area를 표시하기 위해서 어느 스크롤 바가 작성되는지를 지정하는 정수

예외:

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

도입된 버젼:

JDK1. 1

관련 항목:

GraphicsEnvironment.isHeadless()

메소드의 상세

addNotify

public void addNotify()

TextArea 의 피어를 작성합니다. 피어는 TextArea 의 기능을 변경하지 않고 로 외관을 변경할 수 있습니다.

오버라이드(override):

클래스 TextComponent 내의 addNotify

관련 항목:

TextComponent.removeNotify()

insert

public void insert(String  str,
                   int pos)

이 텍스트 영역내의 지정된 위치에, 지정된 텍스트를 삽입합니다.

null 를 건네주거나 무효인 정합성이 없는 파라미터에 의해, 특정할 수 없는 동작을 발생시키지 않게 해 주세요.

파라미터:

str - 삽입하는 null 이외의 캐릭터 라인

pos - 삽입하는 위치

도입된 버젼:

JDK1. 1

관련 항목:

TextComponent.setText(java.lang.String) , replaceRange(java.lang.String, int, int) , append(java.lang.String)

insertText

public void insertText(String  str,
                       int pos)

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

append

public void append(String  str)

텍스트 area의 현재의 텍스트에, 지정된 텍스트를 추가합니다.

null 를 건네주거나 무효인 정합성이 없는 파라미터에 의해, 특정할 수 없는 동작을 발생시키지 않게 해 주세요.

파라미터:

str - 추가하는 null 이외의 캐릭터 라인

도입된 버젼:

JDK1. 1

관련 항목:

insert(java.lang.String, int)

appendText

public void appendText(String  str)

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

replaceRange

public void replaceRange(String  str,
                         int start,
                         int end)

지정된 시점과 종점의 사이의 텍스트를, 지정된 텍스트에 옮겨놓습니다. 종점의 텍스트는 옮겨놓을 수 없습니다. 시점의 텍스트는 시점이 종점과 같은 위치에 없는 경우로 옮겨집니다. 텍스트의 위치는 제로로부터 시작됩니다. 삽입되는 부분 캐릭터 라인은 옮겨놓는 텍스트와 길이가 다른 경우가 있습니다.

null 를 건네주거나 무효인 정합성이 없는 파라미터에 의해, 특정할 수 없는 동작을 발생시키지 않게 해 주세요.

파라미터:

str - 옮겨놓아에 사용하는 null 이외의 텍스트

start - 시점

end - 종점

도입된 버젼:

JDK1. 1

관련 항목:

insert(java.lang.String, int)

replaceText

public void replaceText(String  str,
                        int start,
                        int end)

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

getRows

public int getRows()

텍스트 area의 행수를 돌려줍니다.

반환값:

텍스트 area의 행수

도입된 버젼:

JDK1

관련 항목:

setRows(int) , getColumns()

setRows

public void setRows(int rows)

이 텍스트 area의 행수를 설정합니다.

파라미터:

rows - 행 수

예외:

IllegalArgumentException - rows 로 지정된 값이 0 보다 작은 경우

도입된 버젼:

JDK1. 1

관련 항목:

getRows() , setColumns(int)

getColumns

public int getColumns()

이 텍스트 area의 렬수를 돌려줍니다.

반환값:

텍스트 area의 렬수

관련 항목:

setColumns(int) , getRows()

setColumns

public void setColumns(int columns)

이 텍스트 area의 렬수를 설정합니다.

파라미터:

columns - 렬수

예외:

IllegalArgumentException - columns 로 지정된 값이 0 보다 작은 경우

도입된 버젼:

JDK1. 1

관련 항목:

getColumns() , setRows(int)

getScrollbarVisibility

public int getScrollbarVisibility()

텍스트 area가 사용하는 스크롤 바를 나타내는 열거된 값을 돌려줍니다.

TextArea 클래스는 어느 스크롤 바가 이용 가능한가를 지정하기 위해서 사용되는 4 개의 정수형 정수를 정의합니다. TextArea 는 어플리케이션에 스크롤 바의 선택을 주는 1 개의 constructor를 가집니다.

반환값:

어느 스크롤 바를 사용하는지를 나타내는 정수형

도입된 버젼:

JDK1. 1

관련 항목:

SCROLLBARS_BOTH , SCROLLBARS_VERTICAL_ONLY , SCROLLBARS_HORIZONTAL_ONLY , SCROLLBARS_NONE , TextArea(java.lang.String, int, int, int)

getPreferredSize

public Dimension  getPreferredSize(int rows,
                                  int columns)

지정된 행수 및 렬수의 텍스트 area의 추천 사이즈를 판정합니다.

파라미터:

rows - 행 수

반환값:

지정된 행수 및 렬수의 텍스트 area를 표시하기 위해서 필요한 추천 사이즈

도입된 버젼:

JDK1. 1

관련 항목:

Component.getPreferredSize()

preferredSize

public Dimension  preferredSize(int rows,
                               int columns)

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

getPreferredSize

public Dimension  getPreferredSize()

이 텍스트 area의 추천 사이즈를 판정합니다.

오버라이드(override):

클래스 Component 내의 getPreferredSize

반환값:

이 텍스트 area에 필요한 추천 사이즈

도입된 버젼:

JDK1. 1

관련 항목:

Component.getPreferredSize()

preferredSize

public Dimension  preferredSize()

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

오버라이드(override):

클래스 Component 내의 preferredSize

getMinimumSize

public Dimension  getMinimumSize(int rows,
                                int columns)

지정된 행수 및 렬수의 텍스트 area의 최소 사이즈를 판정합니다.

파라미터:

rows - 행 수

반환값:

지정된 행수 및 렬수의 텍스트 area를 표시하기 위해서 필요한 최소 사이즈

도입된 버젼:

JDK1. 1

관련 항목:

Component.getMinimumSize()

minimumSize

public Dimension  minimumSize(int rows,
                             int columns)

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

getMinimumSize

public Dimension  getMinimumSize()

이 텍스트 area의 최소 사이즈를 판정합니다.

오버라이드(override):

클래스 Component 내의 getMinimumSize

반환값:

이 텍스트 area에 필요한 추천 사이즈

도입된 버젼:

JDK1. 1

관련 항목:

Component.getPreferredSize()

minimumSize

public Dimension  minimumSize()

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

오버라이드(override):

클래스 Component 내의 minimumSize

paramString

protected String  paramString()

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

오버라이드(override):

클래스 TextComponent 내의 paramString

반환값:

텍스트 area의 파라미터의 캐릭터 라인

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 TextArea 에 관련지을 수 있었던 AccessibleContext 를 돌려줍니다. 텍스트 area의 경우,AccessibleContext 는 AccessibleAWTTextArea 의 형식을 취합니다. 필요에 따라서, 새로운 AccessibleAWTTextArea 인스턴스가 작성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 TextComponent 내의 getAccessibleContext

반환값:

이 TextArea 의 AccessibleContext 로서 기능하는 AccessibleAWTTextArea