|
JavaTM Platform Standard Ed. 6 |
|||||||||
앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 |
java.lang.Objectjava.awt.Component
java.awt.TextComponent
public class TextComponent
TextComponent
클래스는, 텍스트의 편집을 가능하게 하는 모든 컴퍼넌트의 슈퍼 클래스입니다.
텍스트 컴퍼넌트는 텍스트의 캐릭터 라인을 구체적으로 표현합니다. TextComponent
클래스는, 이 텍스트가 편집 가능한지 어떤지를 판정하는 메소드 세트를 정의합니다. 컴퍼넌트가 편집 가능한 경우는, 텍스트 삽입 caret를 지원하는 다른 메소드 세트도 정의합니다.
또, 이 클래스는, 텍스트의 현재의 「선택 범위」를 보관 유지하기 위해서 사용되는 메소드도 정의합니다. 컴퍼넌트의 텍스트의 부분 텍스트인 텍스트의 선택 범위는, 편집 조작의 대상이 됩니다. 텍스트의 선택 범위는, 「선택 텍스트」라고도 불립니다.
상자의 클래스의 개요 | |
---|---|
protected class |
TextComponent.AccessibleAWTTextComponent
이 클래스는 TextComponent 클래스용의 접근성?의 지원를 구현하고 있습니다. |
클래스 java.awt. Component 로부터 상속된 상자의 클래스/인터페이스 |
---|
Component.AccessibleAWTComponent , Component.BaselineResizeBehavior , 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의 위치를 돌려줍니다. |
|
InputMethodRequests |
getInputMethodRequests ()
이 컴퍼넌트의 입력 메소드로부터의 요구를 지원하는 입력 메소드 요구 핸들러를 돌려줍니다. |
|
|
getListeners (Class <T> 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.lang. Object 로부터 상속된 메소드 |
---|
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait |
필드의 상세 |
---|
protected transient TextListener textListener
메소드의 상세 |
---|
public void enableInputMethods(boolean enable)
Component
내의 enableInputMethods
enable
- 사용 가능하게 하려면 true, 사용 불가능하게 하려면 falseComponent.processKeyEvent(java.awt.event.KeyEvent)
public InputMethodRequests getInputMethodRequests()
Component
의 기술:InputMethodRequests
의 인스턴스를 돌려주기 위해서(때문에)는 이 메소드를 오버라이드(override) 할 필요가 있습니다. 동시에, 입력 메소드 이벤트를 처리할 필요도 있습니다.
Component
내의 getInputMethodRequests
null
Component.addInputMethodListener(java.awt.event.InputMethodListener)
public void addNotify()
Component
내의 addNotify
removeNotify()
public void removeNotify()
TextComponent
의 피어를 삭제합니다. 피어는,TextComponent
의 기능을 바꾸지 않고 로 외관을 변경할 수가 있습니다.
Component
내의 removeNotify
Component.isDisplayable()
,
Component.addNotify()
public void setText(String t)
t
- 새로운 텍스트.
이 파라미터가 null
의 경우,
텍스트는 빈 상태(empty)의 캐릭터 라인 "" 으로 설정됩니다. getText()
public String getText()
TextComponent
의 값setText(java.lang.String)
public String getSelectedText()
select(int, int)
public boolean isEditable()
true
,
그렇지 않은 경우는 false
setEditable(boolean)
public void setEditable(boolean b)
플래그가 true
로 설정되어 있는 경우, 텍스트 컴퍼넌트는 사용자에 의한 편집이 가능하게 됩니다. 플래그가 false
로 설정되어 있는 경우, 사용자는 이 텍스트 컴퍼넌트의 텍스트를 변경할 수 없습니다. 디폴트로, 편집 불가능한 텍스트 컴퍼넌트는 SystemColor.control 의 백그라운드 칼라를 가집니다. 이 디폴트는 setBackground 의 호출에 의해 오버라이드(override) 할 수 있습니다.
b
- 이 텍스트 컴퍼넌트가 사용자에 의해
편집 가능한가 어떤가를 나타내는 플래그isEditable()
public Color getBackground()
Component
내의 getBackground
setBackground(Color)
public void setBackground(Color c)
Component
내의 setBackground
c
- 이 텍스트 컴퍼넌트의 색이 되는 색.
이 파라미터가 null 의 경우, 이 텍스트 컴퍼넌트는
부모의 백그라운드 칼라를 상속하는getBackground()
public int getSelectionStart()
setSelectionStart(int)
,
getSelectionEnd()
public void setSelectionStart(int selectionStart)
selectionStart
의 값이 경계외인 경우에서도, 이 메소드는, 실패하는 일 없이, 암묵적으로 이러한 제약을 적용합니다.
selectionStart
- 선택한 텍스트의
시점getSelectionStart()
,
setSelectionEnd(int)
public int getSelectionEnd()
setSelectionEnd(int)
,
getSelectionStart()
public void setSelectionEnd(int selectionEnd)
selectionEnd
의 값이 경계외인 경우에서도, 이 메소드는, 실패하는 일 없이, 암묵적으로 이러한 제약을 적용합니다.
selectionEnd
- 선택한 텍스트의
종점getSelectionEnd()
,
setSelectionStart(int)
public void select(int selectionStart, int selectionEnd)
이 메소드는 선택 텍스트의 시점과 종점을 설정합니다. 시점은 0 이상이 아니면 안된다고 하는 제약이 적용됩니다. 종점은 시점과 같은가, 그것보다 큰 값이 아니면 안되어, 또 텍스트 컴퍼넌트의 텍스트의 길이에 동일한지, 그것보다 짧지 않으면 안됩니다. 문자의 위치는, 제로로부터 시작되는 인덱스로 지정합니다. 선택 범위의 길이는, endPosition
- startPosition
입니다. 그 때문에,endPosition
에 있는 문자는 선택되지 않습니다. 선택 텍스트의 시점과 종점이 같은 경우는, 모든 텍스트의 선택이 해제됩니다.
호출측이 일관성의 없는 값 또는 경계외의 값을 지정했을 경우, 메소드는 메세지를 표시하지 않고 , 이러한 제약을 적용합니다. 구체적으로는, 시점 또는 종점이 텍스트의 길이를 넘는 경우, 텍스트와 같은 길이로 다시 설정합니다. 시점이 제로보다 작은 경우, 제로로 다시 설정합니다. 종점이 시점보다 작은 경우, 시점으로 다시 설정합니다.
selectionStart
- 선택되는 최초의 문자
(char
치)의 제로로부터 시작되는 인덱스selectionEnd
- 선택되는 텍스트의 종점을 나타내는 제로로부터 시작되는 인덱스.
selectionEnd
에 있는 문자
(char
치)(은)는 선택되지 않는setSelectionStart(int)
,
setSelectionEnd(int)
,
selectAll()
public void selectAll()
select(int, int)
public void setCaretPosition(int position)
TextComponent
에 텍스트가 포함되어 있지 않은 경우는 0)가 설정되어 에러는 돌려주어지지 않습니다. 건네받은 값이 0 보다 작은 경우는, IllegalArgumentException
가 throw 됩니다.
position
- 텍스트 삽입 caret의 위치
IllegalArgumentException
- position
가
제로보다 작은 경우public int getCaretPosition()
setCaretPosition(int)
public void addTextListener(TextListener l)
l
가 null
의 경우, 예외는 throw 되지 않고, 처리도 실행되지 않습니다.
AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.
l
- 텍스트 이벤트 청취자removeTextListener(java.awt.event.TextListener)
,
getTextListeners()
,
TextListener
public void removeTextListener(TextListener l)
l
가 null
의 경우, 예외는 throw 되지 않고, 처리도 실행되지 않습니다.
AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.
l
- 텍스트 청취자addTextListener(java.awt.event.TextListener)
,
getTextListeners()
,
TextListener
public TextListener [] getTextListeners()
TextListener
,
또는 현재 텍스트 청취자가
등록되지 않은 경우는 빈 상태(empty)의 배열addTextListener(java.awt.event.TextListener)
,
removeTextListener(java.awt.event.TextListener)
public <T extends EventListener > T[] getListeners(Class <T> listenerType)
TextComponent
에 FooListener
로서 현재 등록되어 모든 객체의 배열을 돌려줍니다. FooListener
는,addFooListener
메소드를 사용해 등록합니다.
FooListener.class
라고 하는 클래스 리터럴을 사용해,listenerType
인수를 지정할 수 있습니다. 예를 들어, 다음의 코드를 사용해, 그 텍스트 청취자의 TextComponent
t
를 조회할 수 있습니다.
이러한 청취자가 없는 경우는 빈 상태(empty)의 배열을 돌려줍니다.
Component
내의 getListeners
listenerType
- 요구되는 청취자의 형태.
java.util.EventListener
의
하위 인터페이스를 지정
FooListener
로서 등록되어 모든 객체의 배열.
또는 그러한 청취자가
추가되어 있지 않은 경우는 빈 상태(empty)의 배열
ClassCastException
- listenerType
가
java.util.EventListener
를 구현한다
클래스 또는 인터페이스를 지정하지 않는 경우getTextListeners()
protected void processEvent(AWTEvent e)
TextEvent
의 경우,processTextEvent
메소드를 기동합니다. 그 외의 경우는, 슈퍼 클래스의 processEvent
를 기동합니다.
이벤트 파라미터가 null
의 경우의 동작은 정의되어 있지 않기 때문에 예외가 throw 됩니다.
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)
protected void processTextEvent(TextEvent e)
TextListener
객체에 발송 하는 것으로써, 액션 이벤트를 처리합니다. 주:이 메소드는, 텍스트 이벤트가 이 컴퍼넌트에 대해서 유효하지 않은 경우는 불려 가지 않습니다. 이것은 다음의 어느쪽이든 1 개(살)이 발생했을 경우에 실행됩니다.
TextListener
객체가 addTextListener
에 의해 등록되어 있다
enableEvents
에 의해 텍스트 이벤트가 사용 가능하게 되어 있다
이벤트 파라미터가 null
의 경우의 동작은 정의되어 있지 않기 때문에 예외가 throw 됩니다.
e
- 텍스트 이벤트Component.enableEvents(long)
protected String paramString()
TextComponent
상태를 나타내는 캐릭터 라인을 돌려줍니다. 이 메소드는 디버그 전용이며, 반환되는 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 반환되는 캐릭터 라인은 빈 상태(empty)의 경우가 있습니다만,null
로는 되지 않습니다.
Component
내의 paramString
public AccessibleContext getAccessibleContext()
Accessible
내의 getAccessibleContext
Component
내의 getAccessibleContext
|
JavaTM Platform Standard Ed. 6 |
|||||||||
앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.