|
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
,
그렇지 않은 경우는 false
setEchoChar(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 도 참조해 주세요.