Класс TextField

Объект TextField представляет собой текстовую область, которая позволяет редактировать одну строку текста.

Например, на следующем изображении показана рамка с четырьмя текстовыми полями различной ширины. Два из этих текстовых полей отображают предопределенный текст "Hello".

Вот код, который генерирует эти четыре текстовых поля:

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);

Каждый раз, когда пользователь нажимает клавишу в текстовом поле, одно или несколько событий нажатия клавиши отправляются в текстовое поле. Событие нажатия клавиши может быть одного из трех типов: keyPressed, keyReleased или keyTyped. Свойства события нажатия клавиши указывают, к какому типу оно относится, а также дополнительную информацию об событии, например, какие модификаторы применяются к событию нажатия клавиши и время, когда событие произошло.

Событие нажатия клавиши передается каждому объекту типа KeyListener или KeyAdapter, который зарегистрирован на получение таких событий с помощью метода addKeyListener компонента. (Объекты KeyAdapter реализуют интерфейс KeyListener)

Также возможно инициировать событие ActionEvent. Если события действия включены для текстового поля, они могут быть инициированы нажатием клавиши Return.

Метод processEvent класса TextField проверяет событие действия и передает его дальше processActionEvent. Последний метод перенаправляет событие любым объектам ActionListener, которые зарегистрированы на получение событий действия, сгенерированных этим текстовым полем.

Конструкторы

TextField

public TextField()
          throws HeadlessException

Создаёт новое текстовое поле.

Исключение:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

GraphicsEnvironment.isHeadless()

TextField

public TextField(String text)
          throws HeadlessException

Создаёт новое текстовое поле, инициализированное указанным текстом.

Параметры:

text - текст, который должен быть отображён. Если text является null, будет отображена пустая строка "".

Исключение:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

GraphicsEnvironment.isHeadless()

TextField

public TextField(int columns)
          throws HeadlessException

Создаёт новое пустое текстовое поле с указанным количеством столбцов. Столбец — это приблизительная средняя ширина символа, зависящая от платформы.

Параметры:

columns - количество столбцов. Если columns меньше 0, columns устанавливается в 0.

Исключение:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

GraphicsEnvironment.isHeadless()

TextField

public TextField(String text,
                 int columns)
          throws HeadlessException

Создаёт новое текстовое поле, инициализированное указанным текстом для отображения и достаточной шириной для размещения указанного количества столбцов. Столбец — это приблизительная средняя ширина символа, зависящая от платформы.

Параметры:

text - текст, который должен быть отображён. Если text является null, будет отображена пустая строка "".

columns - количество столбцов. Если columns меньше 0, columns устанавливается в 0.

Исключение:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

GraphicsEnvironment.isHeadless()

Методы

addNotify

public void addNotify()

Создаёт компонент-визуализацию TextField. Компонент-визуализация позволяет изменять внешний вид TextField без изменения его функциональности.

Переопределяет:

addNotify в классе TextComponent

См. также:

TextComponent.removeNotify()

getEchoChar

public char getEchoChar()

Возвращает:

символ эха для этого текстового поля.

См. также:

echoCharIsSet(), setEchoChar(char)

setEchoChar

public void setEchoChar(char c)

Параметры:

c - символ эха для этого текстового поля.

С:

JDK1.1

См. также:

echoCharIsSet(), getEchoChar()

setEchoCharacter

@Deprecated
public void setEchoCharacter(char c)

Устарело. С версии JDK 1.1 заменено на setEchoChar(char).

setText

public void setText(String t)

Устанавливает текст, отображаемый этим текстовым компонентом, на указанный текст.

Переопределяет:

setText в классе TextComponent

Параметры:

t - новый текст.

См. также:

TextComponent.getText()

echoCharIsSet

public boolean echoCharIsSet()

Возвращает:

true если в этом текстовом поле установлен символ эха; false в противном случае.

См. также:

setEchoChar(char), getEchoChar()

getColumns

public int getColumns()

Возвращает количество столбцов в этом текстовом поле. Столбец — это приблизительная средняя ширина символа, зависящая от платформы.

Возвращает:

количество столбцов.

С:

JDK1.1

См. также:

setColumns(int)

setColumns

public void setColumns(int columns)

Устанавливает количество столбцов в этом текстовом поле. Столбец — это приблизительная средняя ширина символа, зависящая от платформы.

Параметры:

columns - количество столбцов.

Исключение:

IllegalArgumentException - если значение, предоставленное для columns, меньше 0.

С:

JDK1.1

См. также:

getColumns()

getPreferredSize

public Dimension getPreferredSize(int columns)

Возвращает предпочтительный размер этого текстового поля с указанным количеством столбцов.

Параметры:

columns - количество столбцов в этом текстовом поле.

Возвращает:

предпочтительные размеры для отображения этого текстового поля.

С:

JDK1.1

preferredSize

@Deprecated
public Dimension preferredSize(int columns)

Устарело. С версии JDK 1.1 заменено на getPreferredSize(int).

getPreferredSize

public Dimension getPreferredSize()

Возвращает предпочтительный размер этого текстового поля.

Переопределяет:

getPreferredSize в классе Component

Возвращает:

предпочтительные размеры для отображения этого текстового поля.

С:

JDK1.1

См. также:

Component.getMinimumSize(), LayoutManager

preferredSize

@Deprecated
public Dimension preferredSize()

Устарело. С версии JDK 1.1 заменено на getPreferredSize().

Переопределяет:

preferredSize в классе Component

getMinimumSize

public Dimension getMinimumSize(int columns)

Возвращает минимальные размеры текстового поля с указанным количеством столбцов.

Параметры:

columns - количество столбцов в этом текстовом поле.

С:

JDK1.1

minimumSize

@Deprecated
public Dimension minimumSize(int columns)

Устарело. С версии JDK 1.1 заменено на getMinimumSize(int).

getMinimumSize

public Dimension getMinimumSize()

Возвращает минимальные размеры этого текстового поля.

Переопределяет:

getMinimumSize в классе Component

Возвращает:

минимальные размеры для отображения этого текстового поля.

С:

JDK1.1

См. также:

Component.getPreferredSize(), LayoutManager

minimumSize

@Deprecated
public Dimension minimumSize()

Устарело. С версии JDK 1.1 заменено на getMinimumSize().

Переопределяет:

minimumSize в классе Component

addActionListener

public void addActionListener(ActionListener l)

Параметры:

l - обработчик событий действия.

С:

JDK1.1

См. также:

removeActionListener(java.awt.event.ActionListener), getActionListeners(), ActionListener

removeActionListener

public void removeActionListener(ActionListener l)

Параметры:

l - обработчик событий действия.

С:

JDK1.1

См. также:

addActionListener(java.awt.event.ActionListener), getActionListeners(), ActionListener

getActionListeners

public ActionListener[] getActionListeners()

Возвращает массив всех обработчиков событий действия, зарегистрированных в этом текстовом поле.

Возвращает:

все обработчики событий действия этого текстового поля или пустой массив, если обработчики событий действия в настоящее время не зарегистрированы

С:

1.4

См. также:

addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener), ActionListener

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

ActionListener[] als = (ActionListener[])(t.getListeners(ActionListener.class));

Переопределяет:

getListeners в классе TextComponent

Параметры:

listenerType - тип запрашиваемых слушателей; этот параметр должен указать интерфейс, который происходит от java.util.EventListener

Возвращает:

массив всех объектов, зарегистрированных в качестве FooListener на этом текстовом поле, или пустой массив, если такие слушатели не были добавлены

Исключения:

ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener

С:

1.3

См. также:

getActionListeners()

processEvent

protected void processEvent(AWTEvent e)

Переопределяет:

processEvent в классе TextComponent

Параметры:

e - событие

С:

JDK1.1

См. также:

ActionEvent, processActionEvent(java.awt.event.ActionEvent)

processActionEvent

protected void processActionEvent(ActionEvent e)

Параметры:

e - событие действия

С:

JDK1.1

См. также:

ActionListener, addActionListener(java.awt.event.ActionListener), Component.enableEvents(long)

paramString

protected String paramString()

Возвращает строку, представляющую состояние этого TextField. Этот метод предназначен только для отладки, и содержимое и формат возвращаемой строки могут различаться между реализациями. Возвращаемая строка может быть пустой, но не может быть null.

Переопределяет:

paramString в классе TextComponent

Возвращает:

строку параметров этого текстового поля

getAccessibleContext

public AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этим TextField. Для текстовых полей AccessibleContext принимает вид AccessibleAWTTextField. Новый экземпляр AccessibleAWTTextField создается при необходимости.

Определено в:

getAccessibleContext в интерфейсе Accessible

Переопределяет:

getAccessibleContext в классе TextComponent

Возвращает:

AccessibleAWTTextField, который служит AccessibleContext этого TextField

С:

1.3