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

관련 항목:

직렬화 된 형식

상자의 클래스의 개요

protected class

TextArea.AccessibleAWTTextArea 이 클래스는 TextArea 클래스용의 접근성?의 지원를 구현하고 있습니다.

클래스 java.awt. TextComponent 로부터 상속된 상자의 클래스/인터페이스

TextComponent.AccessibleAWTTextComponent

클래스 java.awt. Component 로부터 상속된 상자의 클래스/인터페이스

Component.AccessibleAWTComponent , Component.BaselineResizeBehavior , 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 ()
빈 상태(empty)의 캐릭터 라인으로 새로운 텍스트 영역을 구축합니다.

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

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

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

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

메소드의 개요

void	addNotify () TextArea 의 피어를 작성합니다.
void	append (String str) 텍스트 영역의 현재의 텍스트에, 지정된 텍스트를 추가합니다.
void	appendText (String str) 추천 되고 있지 않습니다. JDK version 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 version 1.1 이후는, insert(String, int) 로 옮겨졌습니다.
Dimension	minimumSize () 추천 되고 있지 않습니다. JDK version 1.1 이후는, getMinimumSize() 로 옮겨졌습니다.
Dimension	minimumSize (int rows, int columns) 추천 되고 있지 않습니다. JDK version 1.1 이후는, getMinimumSize(int, int) 로 옮겨졌습니다.
protected String	paramString () 이 TextArea 상태를 나타내는 캐릭터 라인을 돌려줍니다.
Dimension	preferredSize () 추천 되고 있지 않습니다. JDK version 1.1 이후는, getPreferredSize() 로 옮겨졌습니다.
Dimension	preferredSize (int rows, int columns) 추천 되고 있지 않습니다. JDK version 1.1 이후는, getPreferredSize(int, int) 로 옮겨졌습니다.
void	replaceRange (String str, int start, int end) 지정된 시점과 종점의 사이의 텍스트를, 지정된 텍스트에 옮겨놓습니다.
void	replaceText (String str, int start, int end) 추천 되고 있지 않습니다. JDK version 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 , getBaseline , getBaselineResizeBehavior , 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 

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

예외:

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

관련 항목:

GraphicsEnvironment.isHeadless()

TextArea

public TextArea(String  text)
         throws HeadlessException 

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

파라미터:

text - 표시되는 텍스트. text 가 null 의 경우는, 빈 상태(empty)의 캐릭터 라인 "" 이 표시된다

예외:

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

관련 항목:

GraphicsEnvironment.isHeadless()

TextArea

public TextArea(int rows,
                int columns)
         throws HeadlessException 

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

파라미터:

rows - 행 수

columns - 렬수

예외:

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

관련 항목:

GraphicsEnvironment.isHeadless()

TextArea

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

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

파라미터:

text - 표시되는 텍스트. text 가 null 의 경우는, 빈 상태(empty)의 캐릭터 라인 "" 이 표시되는

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 의 경우는, 빈 상태(empty)의 캐릭터 라인 "" 이 표시되는

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 version 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 version 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 version 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 version 1.1 이후는, getPreferredSize(int, int) 로 옮겨졌습니다.

getPreferredSize

public Dimension  getPreferredSize()

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

오버라이드(override):

클래스 Component 내의 getPreferredSize

반환값:

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

도입된 버젼:

JDK1. 1

관련 항목:

Component.getPreferredSize()

preferredSize

@Deprecated 
public Dimension  preferredSize()

추천 되고 있지 않습니다. JDK version 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 version 1.1 이후는, getMinimumSize(int, int) 로 옮겨졌습니다.

getMinimumSize

public Dimension  getMinimumSize()

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

오버라이드(override):

클래스 Component 내의 getMinimumSize

반환값:

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

도입된 버젼:

JDK1. 1

관련 항목:

Component.getPreferredSize()

minimumSize

@Deprecated 
public Dimension  minimumSize()

추천 되고 있지 않습니다. JDK version 1.1 이후는, getMinimumSize() 로 옮겨졌습니다.

오버라이드(override):

클래스 Component 내의 minimumSize

paramString

protected String  paramString()

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

오버라이드(override):

클래스 TextComponent 내의 paramString

반환값:

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

getAccessibleContext

public AccessibleContext  getAccessibleContext()

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

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 TextComponent 내의 getAccessibleContext

반환값:

이 TextArea 의 AccessibleContext 로서 기능한다 AccessibleAWTTextArea

도입된 버젼:

1.3