Компонент TextField

Компоненты для ввода текста

В библиотеке AWT есть два компонента для ввода текста с клавиатуры: TextField, позволяющий ввести только одну строку, и TextArea, в который можно ввести множество строк.

Оба класса расширяют класс TextComponent, в котором собраны их общие методы, такие как выделение текста, позиционирование курсора, получение текста.

Класс TextComponent

В классе TextComponent нет конструктора, этот класс не используется самостоятельно.

Основной метод класса – метод getText () – возвращает текст, находящийся в поле ввода, в виде строки string.

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

isEditable(),

изменить значения в нем – методом

setEditable(boolean editable).

Текст, находящийся в поле, хранится как объект класса string, поэтому у каждого символа есть индекс (у первого – индекс 0). Индекс используется для определения позиции курсора (caret) методом

getCaretPosition(),

для установки позиции курсора методом setcaretposition(int ind) и для выделения текста.

Текст выделяется, как обычно, мышью или клавишами со стрелками при нажатой клавише <Shift>, но можно выделить его из программы метбдом

select (int begin, int end).

При этом помечается текст от символа с индексом begin включительно, до символа с индексом end исключительно.

Весь текст выделяет метод selectAll(). Можно отметить начало выделения методом

setSelectionStart (int ind)

и конец выделения методом

setSelectionEnd(int ind).

Для получения выделенного текста используют методы

getSelectedText (),

а начальный и конечный индекс выделения возвращают методы

getSelectionStart()

и

getSelectionEnd().

Кроме событий класса Component: ComponentEvent, FocusEvent, KeyEvent, MouseEvent, при изменении текста пользователем происходит событие TextEvent

Компонент TextField – это поле для ввода одной строки текста. Ширина поля измеряется в колонках (column). Ширина колонки – это средняя ширина символа в шрифте, которым вводится текст. Нажатие клавиши <Enter> заканчивает ввод и служит сигналом к началу обработки введенного текста, т. е. при этом происходит событие ActionEvent.

В классе четыре конструктора:

· TextField () – создает пустое поле шириной в одну колонку;

· TextField (int columns) – создает пустое поле с числом колонок columns;

· TextField (string text) – создает поле с текстом text;

· TextField(String text, int columns) – создает поле с текстом text и числом колонок columns.

К методам, унаследованным от класса TextComponent, добавляются еще методы

getColumns()

и

setColumns(int col).

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

Данное поле ввода получается выполнением метода

setEchoChar(char echo).

Аргумент echo – это символ, который будет появляться в поле. Проверить, установлен ли эхо-символ, можно логическим методом

echoCharisSet(),

получить эхо-символ – методом

getEchoChar ().

Чтобы вернуть поле ввода в обычное состояние, достаточно выполнить метод setEchoChar(0).

Кроме событий класса Component: ComponentEvent, FocusEvent, KeyEvent, MouseEvent, при изменении текста пользователем происходит событие TextEvent, а при нажатии на клавишу <Enter> – событие ActionEvent.

Дата добавления: 2015-07-02