|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
| 개요 : 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 | |||||||||
java.lang.Objectjava.awt.Component
java.awt.TextComponent
java.awt.TextField
public class TextField
TextField 객체는, 1 행의 텍스트의 편집을 실시할 수 있도록(듯이) 하는 텍스트 컴퍼넌트입니다.
예를 들어, 다음의 그림은, 폭이 다른 4 개의 텍스트 필드를 가지는 프레임을 나타내고 있습니다. 이러한 텍스트 필드 가운데 2 개에는,"Hello" 라고 하는 정의 끝난 텍스트가 표시됩니다.
이것들 4 개의 텍스트 필드를 생성하는 코드를 다음에 나타냅니다.
TextField tf1, tf2, tf3, tf4;
// a blank text field
tf1 = new TextField();
// blank field of 20 columns
tf2 = new TextField("", 20);
// predefined text displayed
tf3 = new TextField("Hello! ");
// predefined text in 30 columns
tf4 = new TextField("Hello", 30);
사용자가 텍스트 필드로 키를 누를 때마다, 1 개(살) 이상의 키 이벤트가 텍스트 필드에 보내집니다. KeyEvent 는, keyPressed, keyReleased, keyTyped 라고 하는 3 개의 형태의 어느 쪽인가에 됩니다. 키 이벤트의 프로퍼티은, 그 이벤트가 이러한 형태 가운데 어느 것으로 되는지, 및 키 이벤트에 적용되는 수식자나 이벤트 발생의 시간등의 이벤트에 관한 추가 정보를 나타냅니다.
키 이벤트는, 컴퍼넌트의 addKeyListener 메소드를 사용해, 그 이벤트를 받도록(듯이) 등록되어 모든 KeyListener 객체 또는 KeyAdapter 객체에게 건네집니다. (KeyAdapter 객체는, KeyListener 인터페이스를 구현하고 있습니다.
ActionEvent 를 트리거하는 일도 가능합니다. 텍스트 필드로 액션 이벤트가 가능한 경우,Return 키를 누르면(자) 이벤트가 트리거됩니다.
TextField 클래스의 processEvent 메소드가 액션 이벤트를 조사해, 그 이벤트를 processActionEvent 에 건네줍니다. processActionEvent 메소드는, 이 텍스트 필드가 생성하는 액션 이벤트를 받도록(듯이) 등록되어 모든 ActionListener 객체에 이벤트를 전송 합니다.
KeyEvent ,
KeyAdapter ,
KeyListener ,
ActionEvent ,
Component.addKeyListener(java.awt.event.KeyListener) ,
processEvent(java.awt.AWTEvent) ,
processActionEvent(java.awt.event.ActionEvent) ,
addActionListener(java.awt.event.ActionListener) ,
직렬화 된 형식 | 상자의 클래스의 개요 | |
|---|---|
protected class |
TextField.AccessibleAWTTextField
이 클래스는 TextField 클래스용의 접근성?의 지원를 구현하고 있습니다. |
| 클래스 java.awt. TextComponent 로부터 상속된 상자의 클래스/인터페이스 |
|---|
TextComponent.AccessibleAWTTextComponent |
| 클래스 java.awt. Component 로부터 상속된 상자의 클래스/인터페이스 |
|---|
Component.AccessibleAWTComponent , Component.BaselineResizeBehavior , Component.BltBufferStrategy , Component.FlipBufferStrategy |
| 필드의 개요 |
|---|
| 클래스 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 |
| 생성자 의 개요 | |
|---|---|
TextField ()
새로운 텍스트 필드를 구축합니다. |
|
TextField (int columns)
지정된 렬수로 새로운 빈 상태(empty)의 텍스트 필드를 구축합니다. |
|
TextField (String text)
지정된 텍스트로 초기화된 새로운 텍스트 필드를 구축합니다. |
|
TextField (String text,
int columns)
지정된 텍스트가 표시되도록(듯이) 초기화되어 지정된 렬수를 표시할 수 있는 폭의 새로운 텍스트 필드를 구축합니다. |
|
| 메소드의 개요 | ||
|---|---|---|
void |
addActionListener (ActionListener l)
이 텍스트 필드의 액션 이벤트를 받기 위해서(때문에), 지정된 액션 청취자를 추가합니다. |
|
void |
addNotify ()
TextField 의 피어를 작성합니다. |
|
boolean |
echoCharIsSet ()
이 텍스트 필드로 메아리용의 문자가 설정되어 있는지 어떤지를 나타냅니다. |
|
AccessibleContext |
getAccessibleContext ()
이 TextField 에 관련한 AccessibleContext 를 돌려줍니다. |
|
ActionListener [] |
getActionListeners ()
이 텍스트 필드에 등록된 모든 액션 청취자의 배열을 돌려줍니다. |
|
int |
getColumns ()
이 텍스트 필드의 렬수를 돌려줍니다. |
|
char |
getEchoChar ()
메아리용으로 사용되는 문자를 돌려줍니다. |
|
|
getListeners (Class <T> listenerType)
이 TextField 에 FooListener 로서 현재 등록되어 모든 객체의 배열을 돌려줍니다. |
|
Dimension |
getMinimumSize ()
이 텍스트 필드의 최소 사이즈를 돌려줍니다. |
|
Dimension |
getMinimumSize (int columns)
지정된 렬수에서의, 이 텍스트 필드의 최소 사이즈를 돌려줍니다. |
|
Dimension |
getPreferredSize ()
이 텍스트 필드의 추천 사이즈를 돌려줍니다. |
|
Dimension |
getPreferredSize (int columns)
지정된 렬수에서의, 이 텍스트 필드의 추천 사이즈를 돌려줍니다. |
|
Dimension |
minimumSize ()
추천 되고 있지 않습니다. JDK version 1.1 이후는, getMinimumSize() 로 옮겨졌습니다. |
|
Dimension |
minimumSize (int columns)
추천 되고 있지 않습니다. JDK version 1.1 이후는, getMinimumSize(int) 로 옮겨졌습니다. |
|
protected String |
paramString ()
이 TextField 상태를 나타내는 캐릭터 라인을 돌려줍니다. |
|
Dimension |
preferredSize ()
추천 되고 있지 않습니다. JDK version 1.1 이후는, getPreferredSize() 로 옮겨졌습니다. |
|
Dimension |
preferredSize (int columns)
추천 되고 있지 않습니다. JDK version 1.1 이후는, getPreferredSize(int) 로 옮겨졌습니다. |
|
protected void |
processActionEvent (ActionEvent e)
이 텍스트 필드로 발생하는 액션 이벤트를, 등록된 ActionListener 객체에 발송 하는 것으로써, 이 이벤트를 처리합니다. |
|
protected void |
processEvent (AWTEvent e)
이 텍스트 필드의 이벤트를 처리합니다. |
|
void |
removeActionListener (ActionListener l)
이후 이 텍스트 필드로부터 액션 이벤트를 받지 않게, 지정된 액션 청취자를 삭제합니다. |
|
void |
setColumns (int columns)
이 텍스트 필드의 렬수를 설정합니다. |
|
void |
setEchoChar (char c)
이 텍스트 필드의 메아리 문자를 설정합니다. |
|
void |
setEchoCharacter (char c)
추천 되고 있지 않습니다. JDK version 1.1 이후는, setEchoChar(char) 로 옮겨졌습니다. |
|
void |
setText (String t)
이 텍스트 컴퍼넌트로 표시되는 텍스트를, 지정된 텍스트로 설정합니다. |
|
| 클래스 java.awt. TextComponent 로부터 상속된 메소드 |
|---|
addTextListener , enableInputMethods , getBackground , getCaretPosition , getInputMethodRequests , getSelectedText , getSelectionEnd , getSelectionStart , getText , getTextListeners , isEditable , processTextEvent , removeNotify , removeTextListener , select , selectAll , setBackground , setCaretPosition , setEditable , setSelectionEnd , setSelectionStart |
| 클래스 java.lang. Object 로부터 상속된 메소드 |
|---|
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait |
| 생성자 의 상세 |
|---|
public TextField()
throws HeadlessException
HeadlessException - GraphicsEnvironment.isHeadless()가
true 를 돌려주는 경우GraphicsEnvironment.isHeadless()
public TextField(String text)
throws HeadlessException
text - 표시되는 텍스트.
text 가 null 의 경우는,
빈 상태(empty)의 캐릭터 라인 "" 이 표시된다
HeadlessException - GraphicsEnvironment.isHeadless()가
true 를 돌려주는 경우GraphicsEnvironment.isHeadless()
public TextField(int columns)
throws HeadlessException
columns - 렬수.
columns 가 0 보다 작은 경우,
columns 는 0 으로 설정된다
HeadlessException - GraphicsEnvironment.isHeadless()가
true 를 돌려주는 경우GraphicsEnvironment.isHeadless()
public TextField(String text,
int columns)
throws HeadlessException
text - 표시되는 텍스트.
text 가 null 의 경우는,
빈 상태(empty)의 캐릭터 라인 "" 이 표시되는columns - 렬수.
columns 가 0 보다 작은 경우,
columns 는 0 으로 설정된다
HeadlessException - GraphicsEnvironment.isHeadless()가
true 를 돌려주는 경우GraphicsEnvironment.isHeadless() | 메소드의 상세 |
|---|
public void addNotify()
TextComponent 내의 addNotify TextComponent.removeNotify() public char getEchoChar()
메아리 문자는, 패스워드 입력용 텍스트 필드 등, 사용자 입력이 화면에 표시되어서는 안 되는 텍스트 필드로 사용됩니다. echoChar = 0 의 경우, 사용자가 입력한 채로 화면에 표시됩니다.
Java 플랫폼 구현에서는, 메아리 문자의 빈 상태(empty)이 아닌 한정적인 세트만을 지원하고 있는 경우가 있습니다. 이 함수는, 원래 setEchoChar()로 요구된 메아리 문자를 돌려줍니다. TextField 구현에 의해 실제로 사용되는 메아리 문자는, 다른 경우가 있습니다.
echoCharIsSet() ,
setEchoChar(char) public void setEchoChar(char c)
메아리 문자는, 패스워드 입력용 텍스트 필드 등, 사용자 입력이 화면에 표시되어서는 안 되는 텍스트 필드로 사용됩니다. echoChar = 0 으로 설정하면(자), 사용자 입력을 다시 화면에 표시할 수 있습니다.
Java 플랫폼 구현에서는, 메아리 문자의 빈 상태(empty)이 아닌 한정적인 세트만을 지원하고 있는 경우가 있습니다. 지원되어 있지 않은 메아리 문자를 설정하려고 하면(자), 대신에 디폴트의 메아리 문자가 사용됩니다. 그 이후의 getEchoChar()의 호출은, 원래 요구되고 있던 메아리 문자를 돌려줍니다. 이것은, TextField 구현으로 실제로 사용되는 메아리 문자와 동일한 경우도, 동일하지 않은 경우도 있습니다.
c - 이 텍스트 필드의 메아리 문자echoCharIsSet() ,
getEchoChar() @Deprecated public void setEchoCharacter(char c)
setEchoChar(char) 로 옮겨졌습니다.
public void setText(String t)
TextComponent 내의 setText t - 새로운 텍스트TextComponent.getText() public boolean echoCharIsSet()
메아리 문자는, 패스워드 입력용 텍스트 필드 등, 사용자 입력이 화면에 표시되어서는 안 되는 텍스트 필드로 사용됩니다.
true,
그렇지 않은 경우는 falsesetEchoChar(char) ,
getEchoChar() public int getColumns()
setColumns(int) public void setColumns(int columns)
columns - 렬수
IllegalArgumentException - columns 에
지정된 값이
0 보다 작은 경우getColumns() public Dimension getPreferredSize(int columns)
columns - 이 텍스트 필드의
렬수
@Deprecated public Dimension preferredSize(int columns)
getPreferredSize(int) 로 옮겨졌습니다.
public Dimension getPreferredSize()
Component 내의 getPreferredSize Component.getMinimumSize() ,
LayoutManager @Deprecated public Dimension preferredSize()
getPreferredSize() 로 옮겨졌습니다.
Component 내의 preferredSize public Dimension getMinimumSize(int columns)
columns - 이 텍스트 필드의
렬수@Deprecated public Dimension minimumSize(int columns)
getMinimumSize(int) 로 옮겨졌습니다.
public Dimension getMinimumSize()
Component 내의 getMinimumSize Component.getPreferredSize() ,
LayoutManager @Deprecated public Dimension minimumSize()
getMinimumSize() 로 옮겨졌습니다.
Component 내의 minimumSize public void addActionListener(ActionListener l)
AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.
l - 액션 청취자removeActionListener(java.awt.event.ActionListener) ,
getActionListeners() ,
ActionListener public void removeActionListener(ActionListener l)
AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.
l - 액션 청취자addActionListener(java.awt.event.ActionListener) ,
getActionListeners() ,
ActionListener public ActionListener [] getActionListeners()
ActionListener,
또는 현재 액션 청취자가
등록되지 않은 경우는 빈 상태(empty)의 배열addActionListener(java.awt.event.ActionListener) ,
removeActionListener(java.awt.event.ActionListener) ,
java.awt.event public <T extends EventListener > T[] getListeners(Class <T> listenerType)
TextField 에 FooListener 로서 현재 등록되어 모든 객체의 배열을 돌려줍니다. FooListener 는,addFooListener 메소드를 사용해 등록합니다.
FooListener.class 라고 하는 클래스 리터럴을 사용해,listenerType 인수를 지정할 수 있습니다. 예를 들어, 다음의 코드를 사용해, 그 액션 청취자의 TextField t 를 조회할 수 있습니다.
ActionListener[] als = (ActionListener[])(t.getListeners(ActionListener.class));이러한 청취자가 없는 경우는 빈 상태(empty)의 배열을 돌려줍니다.
TextComponent 내의 getListeners listenerType - 요구되는 청취자의 형태.
java.util.EventListener 의
하위 인터페이스를 지정
FooListener 로서 등록된 모든 객체의 배열,
또는 그러한 청취자가
추가되어 있지 않은 경우는 빈 상태(empty)의 배열
ClassCastException - listenerType 가
java.util.EventListener 를 구현한다
클래스 또는 인터페이스를 지정하지 않는 경우getActionListeners() protected void processEvent(AWTEvent e)
ActionEvent 의 인스턴스인 경우는,processActionEvent 메소드를 호출합니다. 그렇지 않은 경우는 슈퍼 클래스의 processEvent 를 호출합니다.
이벤트 파라미터가 null 의 경우의 동작은 정의되어 있지 않기 때문에 예외가 throw 됩니다.
TextComponent 내의 processEvent e - 이벤트ActionEvent ,
processActionEvent(java.awt.event.ActionEvent) protected void processActionEvent(ActionEvent e)
ActionListener 객체에 발송 하는 것으로써, 이 이벤트를 처리합니다. 이 컴퍼넌트에 대해서 액션 이벤트가 사용 가능하지 않은 한, 이 메소드는 불려 가지 않습니다. 액션 이벤트는, 다음의 어느 쪽인가의 경우에 사용 가능하게 됩니다.
ActionListener 객체가 addActionListener 에 의해 등록되어 있다
enableEvents 에 의해 액션 이벤트가 사용 가능하게 되어 있다
이벤트 파라미터가 null 의 경우의 동작은 정의되어 있지 않기 때문에 예외가 throw 됩니다.
e - 액션 이벤트ActionListener ,
addActionListener(java.awt.event.ActionListener) ,
Component.enableEvents(long) protected String paramString()
TextField 상태를 나타내는 캐릭터 라인을 돌려줍니다. 이 메소드는 디버그 전용이며, 반환되는 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 반환되는 캐릭터 라인은 빈 상태(empty)의 경우가 있습니다만,null 로는 되지 않습니다.
TextComponent 내의 paramString public AccessibleContext getAccessibleContext()
Accessible 내의 getAccessibleContext TextComponent 내의 getAccessibleContext
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
| 개요 : 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 | |||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.