javax.swing
클래스 JTextArea

java.lang.Object 
  java.awt.Component 
      java.awt.Container 
          javax.swing.JComponent 
              javax.swing.text.JTextComponent 
                  javax.swing.JTextArea

모든 구현된 인터페이스:

ImageObserver , MenuContainer , Serializable , Accessible , Scrollable

public class JTextArea
extends JTextComponent 

JTextArea 는, plaintext를 표시하는 복수행의 영역입니다. 이 처리를 적절히 실시하는 java.awt.TextArea 클래스와의 소스의 호환성을 제공하는 경량 컴퍼넌트로서 준비되어 있습니다. 텍스트 컴퍼넌트의 상세 및 예에 대해서는, 「The Java Tutorial」의「Using Text Components」를 참조해 주세요.

이 컴퍼넌트는,java.awt.TextArea 클래스에는 없는 기능을 갖추고 있습니다. 추가 기능에 대해서는, 슈퍼 클래스를 참조해 주세요. 보다 많은 기능을 갖춘 복수행 텍스트 클래스로서 그 밖에 JTextPane 와 JEditorPane 가 있습니다.

java.awt.TextArea 는 내부적으로 스크롤을 처리합니다. JTextArea 는 스크롤을 관리하지 않는 점에서는 다릅니다만, Swing 의 Scrollable 인터페이스를 구현합니다. 이것에 의해, 그 인터페이스를 스크롤 동작이 필요한 경우에 JScrollPane 의 내부에 배치해, 스크롤의 동작이 불필요한 경우에 직접 사용할 수 있도록 할 수 있습니다.

java.awt.TextArea 하행 반환을 실시하는 기능을 갖추고 있습니다. 이것은, 수평 스크롤 정책로 제어되고 있었습니다. 스크롤은 JTextArea 에 의해 직접 실행되는 것은 아니기 때문에, 하위 호환은 다른 방법으로 제공되지 않으면 안됩니다. JTextArea 는, 행을 되풀이할지 어떨지를 제어하는 행 즉시의 바운드 프로퍼티을 가집니다. 디폴트에서는, 행 즉시 프로퍼티은 false (되풀이하지 않는다)로 설정되어 있습니다.

java.awt.TextArea 에는, 적절한 사이즈를 지정하는데 사용되는 rows 및 columns 의 2 개의 프로퍼티이 있습니다. JTextArea 는 이러한 프로퍼티을 사용해,java.awt.TextArea 로 제공되는 기능과 일치하도록(듯이) JScrollPane 의 내부에 뷰포트를 배치할 때의 적절한 사이즈를 나타냅니다. JTextArea 에는, 텍스트 모든 표시에 필요한 최적인 사이즈가 준비되어 있으므로, 뷰포트는 JScrollPane 의 내부에서 적절히 기능합니다. rows 또는 columns 의 값이 0 때, 그 축으로 따른 최적인 사이즈가, 같은 축으로 따른 뷰포트의 적절한 사이즈에 사용됩니다.

java.awt.TextArea 의 변경을 감시하려면 ,TextEvent 의 TextListener 를 추가합니다. JTextComponent 베이스의 컴퍼넌트에서는,DocumentEvent 경유로 모델로부터 DocumentListeners 로 변경이 보내집니다. DocumentEvent 는, 필요에 따라서, 변경 위치라고 변경의 종류를 제공합니다. 이 부분의 코드는 다음과 같이 됩니다.

DocumentListener myListener = ??;
JTextArea myArea = ??;
myArea.getDocument(). addDocumentListener(myListener);
 

개행

개행의 처리 방법에 대해서는,DefaultEditorKit 를 참조해 주세요.

경고: Swing 는 thread에 대해서 안전하지는 않습니다. 자세한 것은,「Swing's Threading Policy」를 참조해 주세요.

경고: 이 클래스의 직렬화 된 객체는, 향후의 Swing 릴리스와 호환은 아니게 될 예정입니다. 현재의 직렬화의 지원는, 단기간의 운용이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. JDK Version 1.4 이후, 모든 JavaBeans^™ 의 장기간의 운용 지원는,java.beans 패키지에 추가되고 있습니다. 자세한 것은,XMLEncoder 를 참조해 주세요.

관련 항목:

JTextPane , JEditorPane

상자의 클래스의 개요

protected class

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

클래스 javax.swing.text. JTextComponent 로부터 상속된 상자의 클래스/인터페이스

JTextComponent.AccessibleJTextComponent , JTextComponent.DropLocation , JTextComponent.KeyBinding

클래스 javax.swing. JComponent 로부터 상속된 상자의 클래스/인터페이스

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

Component.AccessibleAWTComponent , Component.BaselineResizeBehavior , Component.BltBufferStrategy , Component.FlipBufferStrategy

필드의 개요

클래스 javax.swing.text. JTextComponent 로부터 상속된 필드

DEFAULT_KEYMAP , FOCUS_ACCELERATOR_KEY

클래스 javax.swing. JComponent 로부터 상속된 필드

accessibleContext , listenerList , TOOL_TIP_TEXT_KEY , ui , UNDEFINED_CONDITION , WHEN_ANCESTOR_OF_FOCUSED_COMPONENT , WHEN_FOCUSED , WHEN_IN_FOCUSED_WINDOW

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

생성자 의 개요

JTextArea ()
새로운 TextArea 를 구축합니다.

JTextArea (Document doc)
지정된 문서 모델과 다른 인수는 모두 디폴트 (null, 0, 0)로, 새로운 JTextArea 를 구축합니다.

JTextArea (Document doc, String text, int rows, int columns)
지정된 행수와 렬수, 및 지정된 모델로 새로운 JTextArea 를 구축합니다.

JTextArea (int rows, int columns)
지정된 행수와 렬수로 새로운 빈 상태(empty)의 TextArea 를 구축합니다.

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

JTextArea (String text, int rows, int columns)
지정된 텍스트와 행수와 렬수로 새로운 TextArea 를 구축합니다.

메소드의 개요

void	append (String str) 지정된 텍스트를 문서의 말미에 추가합니다.
protected Document	createDefaultModel () 모델이 명시적으로 지정되지 않는 경우는, 구축시에 사용하는 모델의 디폴트 구현을 작성합니다.
AccessibleContext	getAccessibleContext () 이 JTextArea 에 관련한 AccessibleContext 를 돌려줍니다.
int	getColumns () TextArea 내의 렬수를 돌려줍니다.
protected int	getColumnWidth () 렬폭을 돌려줍니다.
int	getLineCount () 영역내에 넣는 행수를 돌려줍니다.
int	getLineEndOffset (int line) 지정된 행의 종료 오프셋(offset)를 돌려줍니다.
int	getLineOfOffset (int offset) 컴퍼넌트 텍스트의 오프셋(offset)를 행 번호로 변환합니다.
int	getLineStartOffset (int line) 지정된 행의 개시 오프셋(offset)를 돌려줍니다.
boolean	getLineWrap () 텍스트 영역의 행 즉시 정책를 돌려줍니다.
Dimension	getPreferredScrollableViewportSize () 이 컴퍼넌트가 JScrollPane 에 짜넣어지고 있는 경우는 뷰포트의 적절한 사이즈를 돌려줍니다.
Dimension	getPreferredSize () TextArea 의 적절한 사이즈를 돌려줍니다.
protected int	getRowHeight () 행의 높이의 의미를 돌려줍니다.
int	getRows () TextArea 내의 행수를 돌려줍니다.
boolean	getScrollableTracksViewportWidth () 뷰포트가 항상 이 Scrollable 의 폭을 강제적으로 뷰포트의 폭에 일치 시키려고 하는 경우에 true 를 돌려줍니다.
int	getScrollableUnitIncrement (Rectangle visibleRect, int orientation, int direction) 논리행 또는 논리열을 표시하는 컴퍼넌트는, orientation 의 값에 의해, 새로운 1 행 또는 1 열을 완전하게 에크스포즈 하는 스크롤 증분치를 계산합니다.
int	getTabSize () 탭을 전개하는 문자수를 가져옵니다.
String	getUIClassID () UI 의 클래스 ID 를 돌려줍니다.
boolean	getWrapStyleWord () 텍스트 영역이 되풀이해 행의 경우에 사용하는 즉시 서식을 돌려줍니다.
void	insert (String str, int pos) 지정된 텍스트를 지정의 위치에 삽입합니다.
protected String	paramString () 이 JTextArea 의 캐릭터 라인 표현을 돌려줍니다.
void	replaceRange (String str, int start, int end) 지정된 개시 위치로부터 종료 위치까지의 텍스트를, 새로운 지정 텍스트로 옮겨놓습니다.
void	setColumns (int columns) 이 TextArea 의 렬수를 설정합니다.
void	setFont (Font f) 현재의 폰트를 설정합니다.
void	setLineWrap (boolean wrap) 텍스트 영역의 행 즉시 정책를 설정합니다.
void	setRows (int rows) 이 TextArea 의 행수를 설정합니다.
void	setTabSize (int size) 탭을 전개하는 문자수를 설정합니다.
void	setWrapStyleWord (boolean word) 텍스트 영역이 되풀이해 행의 경우에 사용하는 즉시 서식을 설정합니다.

클래스 javax.swing.text. JTextComponent 로부터 상속된 메소드

addCaretListener , addInputMethodListener , addKeymap , copy , cut , fireCaretUpdate , getActions , getCaret , getCaretColor , getCaretListeners , getCaretPosition , getDisabledTextColor , getDocument , getDragEnabled , getDropLocation , getDropMode , getFocusAccelerator , getHighlighter , getInputMethodRequests , getKeymap , getKeymap , getMargin , getNavigationFilter , getPrintable , getScrollableBlockIncrement , getScrollableTracksViewportHeight , getSelectedText , getSelectedTextColor , getSelectionColor , getSelectionEnd , getSelectionStart , getText , getText , getToolTipText , getUI , isEditable , loadKeymap , modelToView , moveCaretPosition , paste , print , print , print , processInputMethodEvent , read , removeCaretListener , removeKeymap , removeNotify , replaceSelection , select , selectAll , setCaret , setCaretColor , setCaretPosition , setComponentOrientation , setDisabledTextColor , setDocument , setDragEnabled , setDropMode , setEditable , setFocusAccelerator , setHighlighter , setKeymap , setMargin , setNavigationFilter , setSelectedTextColor , setSelectionColor , setSelectionEnd , setSelectionStart , setText , setUI , updateUI , viewToModel , write

클래스 javax.swing. JComponent 로부터 상속된 메소드

addAncestorListener , addNotify , addVetoableChangeListener , computeVisibleRect , contains , createToolTip , disable , enable , firePropertyChange , firePropertyChange , firePropertyChange , fireVetoableChange , getActionForKeyStroke , getActionMap , getAlignmentX , getAlignmentY , getAncestorListeners , getAutoscrolls , getBaseline , getBaselineResizeBehavior , getBorder , getBounds , getClientProperty , getComponentGraphics , getComponentPopupMenu , getConditionForKeyStroke , getDebugGraphicsOptions , getDefaultLocale , getFontMetrics , getGraphics , getHeight , getInheritsPopupMenu , getInputMap , getInputMap , getInputVerifier , getInsets , getInsets , getListeners , getLocation , getMaximumSize , getMinimumSize , getNextFocusableComponent , getPopupLocation , getRegisteredKeyStrokes , getRootPane , getSize , getToolTipLocation , getToolTipText , getTopLevelAncestor , getTransferHandler , getVerifyInputWhenFocusTarget , getVetoableChangeListeners , getVisibleRect , getWidth , getX , getY , grabFocus , isDoubleBuffered , isLightweightComponent , isManagingFocus , isOpaque , isOptimizedDrawingEnabled , isPaintingForPrint , isPaintingTile , isRequestFocusEnabled , isValidateRoot , paint , paintBorder , paintChildren , paintComponent , paintImmediately , paintImmediately , print , printAll , printBorder , printChildren , printComponent , processComponentKeyEvent , processKeyBinding , processKeyEvent , processMouseEvent , processMouseMotionEvent , putClientProperty , registerKeyboardAction , registerKeyboardAction , removeAncestorListener , removeVetoableChangeListener , repaint , repaint , requestDefaultFocus , requestFocus , requestFocus , requestFocusInWindow , requestFocusInWindow , resetKeyboardActions , reshape , revalidate , scrollRectToVisible , setActionMap , setAlignmentX , setAlignmentY , setAutoscrolls , setBackground , setBorder , setComponentPopupMenu , setDebugGraphicsOptions , setDefaultLocale , setDoubleBuffered , setEnabled , setFocusTraversalKeys , setForeground , setInheritsPopupMenu , setInputMap , setInputVerifier , setMaximumSize , setMinimumSize , setNextFocusableComponent , setOpaque , setPreferredSize , setRequestFocusEnabled , setToolTipText , setTransferHandler , setUI , setVerifyInputWhenFocusTarget , setVisible , unregisterKeyboardAction , update

클래스 java.awt. Container 로부터 상속된 메소드

add , add , add , add , add , addContainerListener , addImpl , addPropertyChangeListener , addPropertyChangeListener , applyComponentOrientation , areFocusTraversalKeysSet , countComponents , deliverEvent , doLayout , findComponentAt , findComponentAt , getComponent , getComponentAt , getComponentAt , getComponentCount , getComponents , getComponentZOrder , getContainerListeners , getFocusTraversalKeys , getFocusTraversalPolicy , getLayout , getMousePosition , insets , invalidate , isAncestorOf , isFocusCycleRoot , isFocusCycleRoot , isFocusTraversalPolicyProvider , isFocusTraversalPolicySet , layout , list , list , locate , minimumSize , paintComponents , preferredSize , printComponents , processContainerEvent , processEvent , remove , remove , removeAll , removeContainerListener , setComponentZOrder , setFocusCycleRoot , setFocusTraversalPolicy , setFocusTraversalPolicyProvider , setLayout , transferFocusBackward , transferFocusDownCycle , validate , validateTree

클래스 java.awt. Component 로부터 상속된 메소드

action , add , addComponentListener , addFocusListener , addHierarchyBoundsListener , addHierarchyListener , addKeyListener , addMouseListener , addMouseMotionListener , addMouseWheelListener , bounds , checkImage , checkImage , coalesceEvents , contains , createImage , createImage , createVolatileImage , createVolatileImage , disableEvents , dispatchEvent , enable , enableEvents , enableInputMethods , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , getBackground , getBounds , getColorModel , getComponentListeners , getComponentOrientation , getCursor , getDropTarget , getFocusCycleRootAncestor , getFocusListeners , getFocusTraversalKeysEnabled , getFont , getForeground , getGraphicsConfiguration , getHierarchyBoundsListeners , getHierarchyListeners , getIgnoreRepaint , getInputContext , getInputMethodListeners , getKeyListeners , getLocale , getLocation , getLocationOnScreen , getMouseListeners , getMouseMotionListeners , getMousePosition , getMouseWheelListeners , getName , getParent , getPeer , getPropertyChangeListeners , getPropertyChangeListeners , getSize , getToolkit , getTreeLock , gotFocus , handleEvent , hasFocus , hide , imageUpdate , inside , isBackgroundSet , isCursorSet , isDisplayable , isEnabled , isFocusable , isFocusOwner , isFocusTraversable , isFontSet , isForegroundSet , isLightweight , isMaximumSizeSet , isMinimumSizeSet , isPreferredSizeSet , isShowing , isValid , isVisible , keyDown , keyUp , list , list , list , location , lostFocus , mouseDown , mouseDrag , mouseEnter , mouseExit , mouseMove , mouseUp , move , nextFocus , paintAll , postEvent , prepareImage , prepareImage , processComponentEvent , processFocusEvent , processHierarchyBoundsEvent , processHierarchyEvent , processMouseWheelEvent , remove , removeComponentListener , removeFocusListener , removeHierarchyBoundsListener , removeHierarchyListener , removeInputMethodListener , removeKeyListener , removeMouseListener , removeMouseMotionListener , removeMouseWheelListener , removePropertyChangeListener , removePropertyChangeListener , repaint , repaint , repaint , resize , resize , setBounds , setBounds , setCursor , setDropTarget , setFocusable , setFocusTraversalKeysEnabled , setIgnoreRepaint , setLocale , setLocation , setLocation , setName , setSize , setSize , show , show , size , toString , transferFocus , transferFocusUpCycle

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait

생성자 의 상세

JTextArea

public JTextArea()

새로운 TextArea 를 구축합니다. 디폴트 모델이 설정되어 초기 캐릭터 라인은 null, 행/렬수는 0 으로 설정됩니다.

JTextArea

public JTextArea(String  text)

지정된 표시 텍스트로 새로운 TextArea 를 구축합니다. 디폴트 모델이 작성되어 행/렬수는 0 으로 설정됩니다.

파라미터:

text - 표시되는 텍스트 또는 null

JTextArea

public JTextArea(int rows,
                 int columns)

지정된 행수와 렬수로 새로운 빈 상태(empty)의 TextArea 를 구축합니다. 디폴트 모델이 작성되어 초기 캐릭터 라인은 null 로 설정됩니다.

파라미터:

rows - 행 수 >= 0

columns - 렬수 >= 0

예외:

IllegalArgumentException - 행 또는 열의 인수가 부의 수의 경우

JTextArea

public JTextArea(String  text,
                 int rows,
                 int columns)

지정된 텍스트와 행수와 렬수로 새로운 TextArea 를 구축합니다. 디폴트 모델이 작성됩니다.

파라미터:

text - 표시되는 텍스트 또는 null

rows - 행 수 >= 0

columns - 렬수 >= 0

예외:

IllegalArgumentException - 행 또는 열의 인수가 부의 수의 경우

JTextArea

public JTextArea(Document  doc)

지정된 문서 모델과 다른 인수는 모두 디폴트 (null, 0, 0)로, 새로운 JTextArea 를 구축합니다.

파라미터:

doc - 사용하는 모델

JTextArea

public JTextArea(Document  doc,
                 String  text,
                 int rows,
                 int columns)

지정된 행수와 렬수, 및 지정된 모델로 새로운 JTextArea 를 구축합니다. 생성자 의 모든 것은, 이 생성자 에 파급효과를 가져옵니다.

파라미터:

doc - 사용하는 모델. 다만 null 의 경우는, 디폴트 모델을 작성하는

text - 표시되는 텍스트. 없는 경우는 null

rows - 행 수 >= 0

columns - 렬수 >= 0

예외:

IllegalArgumentException - 행 또는 열의 인수가 부의 수의 경우

메소드의 상세

getUIClassID

public String  getUIClassID()

UI 의 클래스 ID 를 돌려줍니다.

오버라이드(override):

클래스 JComponent 내의 getUIClassID

반환값:

ID ("TextAreaUI")

관련 항목:

JComponent.getUIClassID() , UIDefaults.getUI(javax.swing.JComponent)

createDefaultModel

protected Document  createDefaultModel()

모델이 명시적으로 지정되지 않는 경우는, 구축시에 사용하는 모델의 디폴트 구현을 작성합니다. PlainDocument 의 새로운 인스턴스가 돌려주어집니다.

반환값:

디폴트의 문서 모델

setTabSize

public void setTabSize(int size)

탭을 전개하는 문자수를 설정합니다. 가변폭폰트에 대해서는 최대 유효폭이 곱셈됩니다. 탭의 사이즈가 변경되면(자), PropertyChange 이벤트 (tabSize)가 발생합니다.

파라미터:

size - 전개하는 문자수

관련 항목:

getTabSize()

getTabSize

public int getTabSize()

탭을 전개하는 문자수를 가져옵니다. 문서가 null 의 경우, 혹은 탭 설정을 가지지 않는 경우는, 디폴트의 8 을 돌려줍니다.

반환값:

문자수

setLineWrap

public void setLineWrap(boolean wrap)

텍스트 영역의 행 즉시 정책를 설정합니다. true 로 설정하면(자), 할당폭에 완전히 해결되지 않는 길이의 행은 되접어 꺾입니다. false 로 설정하면(자), 행은 되접어 꺾이지 않습니다. 정책를 변경하면(자),PropertyChange 이벤트 (lineWrap)가 발생합니다. 디폴트에서는 이 프로퍼티은 false 입니다.

파라미터:

wrap - 행을 되풀이할지 어떨지를 나타내는

관련 항목:

getLineWrap()

getLineWrap

public boolean getLineWrap()

텍스트 영역의 행 즉시 정책를 돌려줍니다. true 로 설정하면(자), 할당폭에 완전히 해결되지 않는 길이의 행은 되접어 꺾입니다. false 로 설정하면(자), 행은 되접어 꺾이지 않습니다.

반환값:

행이 되접어 꺾일지 어떨지

setWrapStyleWord

public void setWrapStyleWord(boolean word)

텍스트 영역이 되풀이해 행의 경우에 사용하는 즉시 서식을 설정합니다. true 로 설정하면(자), 할당폭에 완전히 해결되지 않는 길이의 행은 워드 경계 (공백 부분)에서 되접어 꺾입니다. false 로 설정하면(자), 행은 문자 경계에서 되접어 꺾입니다. 디폴트에서는 이 프로퍼티은 false 입니다.

파라미터:

word - 행 즉시에 워드 경계를 사용할지 어떨지를 나타내는

관련 항목:

getWrapStyleWord()

getWrapStyleWord

public boolean getWrapStyleWord()

텍스트 영역이 되풀이해 행의 경우에 사용하는 즉시 서식을 돌려줍니다. true 로 설정하면(자), 할당폭에 완전히 해결되지 않는 길이의 행은 워드 경계 (공백 부분)에서 되접어 꺾입니다. false 로 설정하면(자), 행은 문자 경계에서 되접어 꺾입니다.

반환값:

즉시 서식이 문자 경계가 아니고 워드 경계인가 어떤가

관련 항목:

setWrapStyleWord(boolean)

getLineOfOffset

public int getLineOfOffset(int offset)
                    throws BadLocationException 

컴퍼넌트 텍스트의 오프셋(offset)를 행 번호로 변환합니다.

파라미터:

offset - 오프셋(offset) >= 0

반환값:

행 번호 >= 0

예외:

BadLocationException - 오프셋(offset)가 0 보다 작은 경우, 또는 문서의 길이보다 큰 경우

getLineCount

public int getLineCount()

영역내에 넣는 행수를 돌려줍니다.

반환값:

행 수 > 0

getLineStartOffset

public int getLineStartOffset(int line)
                       throws BadLocationException 

지정된 행의 개시 오프셋(offset)를 돌려줍니다.

파라미터:

line - 변환 대상의 행 번호 >= 0

반환값:

오프셋(offset) >= 0

예외:

BadLocationException - 행이 0 보다 작은 경우, 또는 문서에 포함되는 행수 (getLineCount 로부터 보고된다) 이상인 경우에 throw 된다

getLineEndOffset

public int getLineEndOffset(int line)
                     throws BadLocationException 

지정된 행의 종료 오프셋(offset)를 돌려줍니다.

파라미터:

line - 행 >= 0

반환값:

오프셋(offset) >= 0

예외:

BadLocationException - 행이 0 보다 작은 경우, 또는 문서에 포함되는 행수 (getLineCount 로부터 보고된다) 이상인 경우에 throw 된다

insert

public void insert(String  str,
                   int pos)

지정된 텍스트를 지정의 위치에 삽입합니다. 모델이 null 의 경우, 혹은 텍스트가 null 또는 빈 상태(empty)의 경우는 아무것도 실시하지 않습니다.

이 메소드는 thread에 대해서 안전합니다만, 대부분의 Swing 메소드는 다릅니다. 자세한 것은,「How to Use Threads」를 참조해 주세요.

파라미터:

str - 삽입하는 텍스트

pos - 삽입 위치 >= 0

예외:

IllegalArgumentException - pos 가 모델내의 무효인 위치에 있는 경우

관련 항목:

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

append

public void append(String  str)

지정된 텍스트를 문서의 말미에 추가합니다. 모델이 null 의 경우, 혹은 캐릭터 라인이 null 나 빈 상태(empty)의 경우에는 아무것도 실시하지 않습니다.

이 메소드는 thread에 대해서 안전합니다만, 대부분의 Swing 메소드는 다릅니다. 자세한 것은,「How to Use Threads」를 참조해 주세요.

파라미터:

str - 삽입하는 텍스트

관련 항목:

insert(java.lang.String, int)

replaceRange

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

지정된 개시 위치로부터 종료 위치까지의 텍스트를, 새로운 지정 텍스트로 옮겨놓습니다. 모델이 null 의 경우는 아무것도 실시하지 않습니다. 새로운 캐릭터 라인이 null 또는 빈 상태(empty)의 경우는, 단순하게 delete 를 실행합니다.

이 메소드는 thread에 대해서 안전합니다만, 대부분의 Swing 메소드는 다릅니다. 자세한 것은,「How to Use Threads」를 참조해 주세요.

파라미터:

str - 옮겨놓아에 사용하는 텍스트

start - 개시 위치 >= 0

end - 종료 위치 >= start

예외:

IllegalArgumentException - 범위의 일부가 모델내의 무효인 위치에 있는 경우

관련 항목:

insert(java.lang.String, int) , replaceRange(java.lang.String, int, int)

getRows

public int getRows()

TextArea 내의 행수를 돌려줍니다.

반환값:

행 수 >= 0

setRows

public void setRows(int rows)

이 TextArea 의 행수를 설정합니다. 새로운 값을 설정한 뒤에 invalidate()를 호출합니다.

파라미터:

rows - 행 수 >= 0

예외:

IllegalArgumentException - 행이 0 보다 작은 경우

관련 항목:

getRows()

getRowHeight

protected int getRowHeight()

행의 높이의 의미를 돌려줍니다. 이 디폴트는 폰트의 높이입니다.

반환값:

높이 >= 1

getColumns

public int getColumns()

TextArea 내의 렬수를 돌려줍니다.

반환값:

렬수 >= 0

setColumns

public void setColumns(int columns)

이 TextArea 의 렬수를 설정합니다. 새로운 값을 설정한 뒤에 invalidate()를 실행합니다.

파라미터:

columns - 렬수 >= 0

예외:

IllegalArgumentException - 렬수가 0 보다 작은 경우

관련 항목:

getColumns()

getColumnWidth

protected int getColumnWidth()

렬폭을 돌려줍니다. 폰트에 따라서는, 열은 약한 의미 밖에 가지지 않습니다. 이 메소드를 사용하면(자), 1 열의 폭을 정의할 수 있습니다. 이것은 디폴트로, 사용 폰트의 문자 「m」의 폭으로 정의됩니다. 이 메소드는, 다른 폭이 되도록(듯이) 재정의할 수 있습니다.

반환값:

렬폭 >= 1

getPreferredSize

public Dimension  getPreferredSize()

TextArea 의 적절한 사이즈를 돌려줍니다. 이것은, 텍스트의 표시에 필요한 사이즈와 뷰포트에 요구되는 사이즈의 큰 (분)편입니다.

오버라이드(override):

클래스 JComponent 내의 getPreferredSize

반환값:

사이즈

관련 항목:

JComponent.setPreferredSize(java.awt.Dimension) , ComponentUI

setFont

public void setFont(Font  f)

현재의 폰트를 설정합니다. 캐쉬된 행의 높이와 열의 폭을 삭제해 새로운 폰트의 설정이 반영되도록(듯이) 해, revalidate()를 호출합니다.

오버라이드(override):

클래스 JComponent 내의 setFont

파라미터:

f - 현재의 폰트로서 사용하는 폰트

관련 항목:

Component.getFont()

paramString

protected String  paramString()

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

오버라이드(override):

클래스 JTextComponent 내의 paramString

반환값:

이 JTextArea 의 캐릭터 라인 표현

getScrollableTracksViewportWidth

public boolean getScrollableTracksViewportWidth()

뷰포트가 항상 이 Scrollable 의 폭을 강제적으로 뷰포트의 폭에 일치 시키려고 하는 경우에 true 를 돌려줍니다. 이것을 구현하면(자), 행 즉시 정책가 true 의 경우는 true 를 돌려주어, 행이 되접어 꺾이지 않는 경우는 false 를 돌려줍니다.

정의:

인터페이스 Scrollable 내의 getScrollableTracksViewportWidth

오버라이드(override):

클래스 JTextComponent 내의 getScrollableTracksViewportWidth

반환값:

뷰포트가 Scrollable 의 폭을 강제적으로 그 자체에 일치시키는 경우는 true

getPreferredScrollableViewportSize

public Dimension  getPreferredScrollableViewportSize()

이 컴퍼넌트가 JScrollPane 에 짜넣어지고 있는 경우는 뷰포트의 적절한 사이즈를 돌려줍니다. 바람직한 행과 열이 설정되어 있는 경우는 그것을 사용해, 그렇지 않은 경우는 슈퍼 클래스의 동작이 사용됩니다.

정의:

인터페이스 Scrollable 내의 getPreferredScrollableViewportSize

오버라이드(override):

클래스 JTextComponent 내의 getPreferredScrollableViewportSize

반환값:

뷰가 이 Scrollable 인 JViewport 의 preferredSize

관련 항목:

JComponent.getPreferredSize()

getScrollableUnitIncrement

public int getScrollableUnitIncrement(Rectangle  visibleRect,
                                      int orientation,
                                      int direction)

논리행 또는 논리열을 표시하는 컴퍼넌트는, orientation 의 값에 의해, 새로운 1 행 또는 1 열을 완전하게 에크스포즈 하는 스크롤 증분치를 계산합니다. 이 메소드를 구현하면(자),getRowHeight 메소드와 getColumnWidth 메소드가 돌려주는 값을 사용할 수 있습니다.

JScrollPane 등의 스크롤 컨테이너는, 사용자가 유니트 스크롤을 요구하면(자), 이 메소드를 사용합니다.

정의:

인터페이스 Scrollable 내의 getScrollableUnitIncrement

오버라이드(override):

클래스 JTextComponent 내의 getScrollableUnitIncrement

파라미터:

visibleRect - 뷰포트내의 가시의 뷰 영역

orientation - SwingConstants.VERTICAL 또는 SwingConstants.HORIZONTAL

direction - 상또는왼쪽으로 스크롤 하는 경우는 0 보다 작은 값, 아래 또는 오른쪽으로 스크롤 하는 경우는 제로보다 큰 값

반환값:

지정된 방향으로 스크롤하기 위한 「유니트」증분치

예외:

IllegalArgumentException - 방향이 무효인 경우

관련 항목:

JScrollBar.setUnitIncrement(int) , getRowHeight() , getColumnWidth()

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 JTextArea 에 관련한 AccessibleContext 를 돌려줍니다. JTextArea 의 경우, AccessibleContext 는 AccessibleJTextArea 의 형식을 취합니다. 필요에 따라서 새로운 AccessibleJTextArea 인스턴스를 작성합니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 JTextComponent 내의 getAccessibleContext

반환값:

이 JTextArea 의 AccessibleContext 로서 기능하는 AccessibleJTextArea