Класс JTextField

@JavaBean(defaultProperty="UIClassID",
          description="A component which allows for the editing of a single line of text.")
public class JTextField
extends JTextComponent
implements SwingConstants

JTextField — это лёгкий компонент, который позволяет редактировать одну строку текста. Сведения и примеры использования текстовых полей см. в Руководстве по компонентам «Текстовые поля» в учебнике Java.

JTextField предназначен для совместимости с java.awt.TextField, где это возможно. Этот компонент обладает возможностями, которых нет у класса java.awt.TextField. Для получения дополнительных возможностей следует обратиться к суперклассу.

JTextField имеет метод для установки строки, используемой в качестве строки команды для события действия, которое срабатывает. java.awt.TextField использовал текст поля в качестве строки команды для ActionEvent. JTextField будет использовать строку команды, установленную методом setActionCommand, если она не null, иначе — текст поля для совместимости с java.awt.TextField.

Методы setEchoChar и getEchoChar не предоставляются напрямую, чтобы избежать случайного раскрытия символов пароля при новой реализации внешнего вида и ощущений. Для предоставления функций, связанных с паролями, отдельный класс JPasswordField расширяет JTextField для предоставления этой услуги с независимо настраиваемым внешним видом и ощущениями.

За изменениями в java.awt.TextField можно следить, добавив TextListener для TextEvent. В компонентах, основанных на JTextComponent, изменения транслируются из модели через DocumentEvent в DocumentListeners. DocumentEvent указывает местоположение изменения и тип изменения, если это необходимо. Фрагмент кода может выглядеть примерно так:

    DocumentListener myListener = ??;
     JTextField myArea = ??;
     myArea.getDocument().addDocumentListener(myListener);

Выравнивание текста JTextField может быть установлено в левое, начальное, центрированное, правое или заключительное выравнивание. Правое/заключительное выравнивание полезно, если требуемый размер текста поля меньше выделенного для него размера. Это определяется методами setHorizontalAlignment и getHorizontalAlignment. По умолчанию используется начальное выравнивание.

Как текстовое поле обрабатывает события VK_ENTER, зависит от наличия слушателей событий действия в текстовом поле. Если они есть, то VK_ENTER приводит к получению слушателями события ActionEvent, и событие VK_ENTER обрабатывается. Это совместимо с тем, как текстовые поля AWT обрабатывают события VK_ENTER. Если в текстовом поле нет слушателей событий действия, то начиная с версии 1.3, событие VK_ENTER не обрабатывается. Вместо этого обрабатываются связи родительских компонентов, что позволяет использовать функцию стандартной кнопки JFC/Swing.

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

 public class UpperCaseField extends JTextField {
 
     public UpperCaseField(int cols) {
         super(cols);
     }
 
     protected Document createDefaultModel() {
         return new UpperCaseDocument();
     }
 
     static class UpperCaseDocument extends PlainDocument {
 
         public void insertString(int offs, String str, AttributeSet a)
             throws BadLocationException {
 
             if (str == null) {
                 return;
             }
             char[] upper = str.toCharArray();
             for (int i = 0; i < upper.length; i++) {
                 upper[i] = Character.toUpperCase(upper[i]);
             }
             super.insertString(offs, new String(upper), a);
         }
     }
 }

Предупреждение: Swing не является потокобезопасным. Дополнительную информацию см. в Политике многопоточности Swing.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4, поддержка долгосрочного хранения всех JavaBeans™ была добавлена в пакет java.beans. См. XMLEncoder.