java.awt
클래스 TextArea

java.lang.Object 
  java.awt.Component 
      java.awt.TextComponent 
          java.awt.TextArea

모든 구현된 인터페이스:

ImageObserver, MenuContainer, Serializable, Accessible

public class TextArea
extends TextComponent 

TextArea객체는 텍스트를 표시하는 복수행 영역입니다. 편집 가능하게 설정하는 일도, read 전용으로 설정할 수도 있습니다.

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

이 텍스트 영역은 다음의 코드에 의해 작성할 수 있습니다.

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

도입된 버전 :

JDK1. 0

관련 항목:

직렬화 된 형식

중첩(Nested) 클래스 개요

protected class

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

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

TextComponent.AccessibleAWTTextComponent

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

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

필드 개요

static int	SCROLLBARS_BOTH 수평과 수직 스크롤 바를 작성해, 표시합니다.
static int	SCROLLBARS_HORIZONTAL_ONLY 수평 스크롤 바만을 작성해, 표시합니다.
static int	SCROLLBARS_NONE 이 텍스트 영역의 어느 스크롤 바도 작성하지 않습니다.
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 ()
비어있는 캐릭터 라인으로 새로운 텍스트 영역을 구축합니다.

TextArea (int rows, int columns)
지정된 행수와 렬수와 비어있는 텍스트 캐릭터 라인을 가지는 새로운 텍스트 영역을 구축합니다.

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

TextArea (String text, int rows, int columns)
지정된 행수와 렬수를 가지는 비어있는 텍스트 영역을 지정된 텍스트로 구축합니다.

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

메서드 개요

void	addNotify () TextArea 피어를 작성합니다.
void	append (String str) 텍스트 영역의 현재의 텍스트에 지정된 텍스트를 추가합니다.
void	appendText (String str) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 append(String)를 사용합니다.
AccessibleContext	getAccessibleContext () 이 TextArea에 관련된 AccessibleContext를 리턴합니다.
int	getColumns () 이 텍스트 영역의 렬수를 리턴합니다.
Dimension	getMinimumSize () 이 텍스트 영역의 최소 사이즈를 판정합니다.
Dimension	getMinimumSize (int rows, int columns) 지정된 행수 및 렬수의 텍스트 영역의 최소 사이즈를 판정합니다.
Dimension	getPreferredSize () 이 텍스트 영역의 추천 사이즈를 판정합니다.
Dimension	getPreferredSize (int rows, int columns) 지정된 행수 및 렬수의 텍스트 영역의 추천 사이즈를 판정합니다.
int	getRows () 텍스트 영역의 행수를 리턴합니다.
int	getScrollbarVisibility () 텍스트 영역이 사용하는 스크롤 바를 나타내는 열거된 값을 리턴합니다.
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) 이 텍스트 영역의 렬수를 설정합니다.
void	setRows (int rows) 이 텍스트 영역의 행수를 설정합니다.

클래스 java.awt. TextComponent 로부터 상속된 메서드

addTextListener, enableInputMethods, getBackground, getCaretPosition, getInputMethodRequests, 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, 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

필드의 상세

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

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

도입된 버전 :

JDK1. 1

관련 항목:

정수 필드값

생성자 상세

TextArea

public TextArea()
         throws HeadlessException 

비어있는 캐릭터 라인으로 새로운 텍스트 영역을 구축합니다. 이 텍스트 영역은 스크롤 바의 가시성이 SCROLLBARS_BOTH 설정으로 작성됩니다. 이 때문에 이 텍스트 영역에서는 수직과 수평의 양쪽 모두의 스크롤 바가 가시가 됩니다.

예외:

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

관련 항목:

GraphicsEnvironment.isHeadless()

TextArea

public TextArea(String  text)
         throws HeadlessException 

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

파라미터:

text - 표시하는 텍스트. text이 null인 경우는 비어있는 캐릭터 라인 "" 이 표시된다

예외:

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

관련 항목:

GraphicsEnvironment.isHeadless()

TextArea

public TextArea(int rows,
                int columns)
         throws HeadlessException 

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

파라미터:

rows - 행 수

columns - 렬수

예외:

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

관련 항목:

GraphicsEnvironment.isHeadless()

TextArea

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

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

파라미터:

text - 표시하는 텍스트. text이 null인 경우는 비어있는 캐릭터 라인 "" 이 표시되는

rows - 행 수

columns - 렬수

예외:

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

관련 항목:

GraphicsEnvironment.isHeadless()

TextArea

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

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

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

• SCROLLBARS_BOTH
• SCROLLBARS_VERTICAL_ONLY
• SCROLLBARS_HORIZONTAL_ONLY
• SCROLLBARS_NONE

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

파라미터:

text - 표시하는 텍스트. text이 null인 경우는 비어있는 캐릭터 라인 "" 이 표시되는

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

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

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

예외:

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

@Deprecated 
public void insertText(String  str,
                                  int pos)

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

append

public void append(String  str)

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

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

파라미터:

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

도입된 버전 :

JDK1. 1

관련 항목:

insert(java.lang.String, int)

appendText

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

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

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

getRows

public int getRows()

텍스트 영역의 행수를 리턴합니다.

반환값:

텍스트 영역의 행수

도입된 버전 :

JDK1

관련 항목:

setRows(int), getColumns()

setRows

public void setRows(int rows)

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

파라미터:

rows - 행 수

예외:

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

도입된 버전 :

JDK1. 1

관련 항목:

getRows(), setColumns(int)

getColumns

public int getColumns()

이 텍스트 영역의 렬수를 리턴합니다.

반환값:

텍스트 영역의 렬수

관련 항목:

setColumns(int), getRows()

setColumns

public void setColumns(int columns)

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

파라미터:

columns - 렬수

예외:

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

도입된 버전 :

JDK1. 1

관련 항목:

getColumns(), setRows(int)

getScrollbarVisibility

public int getScrollbarVisibility()

텍스트 영역이 사용하는 스크롤 바를 나타내는 열거된 값을 리턴합니다.

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

반환값:

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

도입된 버전 :

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)

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

파라미터:

rows - 행 수

columns - 렬수

반환값:

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

도입된 버전 :

JDK1. 1

관련 항목:

Component.getPreferredSize()

preferredSize

@Deprecated 
public Dimension  preferredSize(int rows,
                                          int columns)

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

getPreferredSize

public Dimension  getPreferredSize()

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

오버라이드(override):

클래스 Component 내의 getPreferredSize

반환값:

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

도입된 버전 :

JDK1. 1

관련 항목:

Component.getPreferredSize()

preferredSize

@Deprecated 
public Dimension  preferredSize()

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

오버라이드(override):

클래스 Component 내의 preferredSize

getMinimumSize

public Dimension  getMinimumSize(int rows,
                                int columns)

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

파라미터:

rows - 행 수

columns - 렬수

반환값:

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

도입된 버전 :

JDK1. 1

관련 항목:

Component.getMinimumSize()

minimumSize

@Deprecated 
public Dimension  minimumSize(int rows,
                                        int columns)

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

getMinimumSize

public Dimension  getMinimumSize()

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

오버라이드(override):

클래스 Component 내의 getMinimumSize

반환값:

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

도입된 버전 :

JDK1. 1

관련 항목:

Component.getPreferredSize()

minimumSize

@Deprecated 
public Dimension  minimumSize()

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

오버라이드(override):

클래스 Component 내의 minimumSize

paramString

protected String  paramString()

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

오버라이드(override):

클래스 TextComponent 내의 paramString

반환값:

텍스트 영역의 파라미터의 캐릭터 라인

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 TextArea에 관련된 AccessibleContext를 리턴합니다. 텍스트 영역의 경우, AccessibleContext는 AccessibleAWTTextArea 형식을 취합니다. 필요에 따라서, 새로운 AccessibleAWTTextArea인스턴스가 작성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 TextComponent 내의 getAccessibleContext

반환값:

이 TextArea AccessibleContext로 서 기능하는 AccessibleAWTTextArea