文本组件概述

文本组件用于接收用户输入的信息，其中包括文本框（JTextField）、文本域（JTextArea）等，它们都有一个共同父类JTextComponent。

JTextComponent是一个抽象类，它提供了文本组件常用的方法，如表1所示。

表1 JTextComponent常用方法

表8-7中列出了文本组件常用的几种操作方法，其中包括选中文本内容、设置文本内容以及获取文本内容等。

由于JTextField和JTextArea这两个文本组件都继承了JTextComponent类，因此它们都具有表8-7中的方法。

不过，这两个文本组件在使用上还有一定区别，接下来将分别进行详细讲解。

1．JTextField

JTextField称为文本框，它只能接收单行文本的输入。

接下来介绍一下JTextField常用的构造方法，如表2所示。

表2 JTextField常用构造方法

表2中列出了JTextField的四个构造方法。

在创建JTextField文本框时，通常使用第二个或者第四个构造方法，以指定文本框的列数。

JPasswordField简介

JTextField还有一个常用子类叫JPasswordField，它专门用来表示密码输入框。

它同样只接受用户输入单行内容，不过和普通文本框不同的是，这里不会直接显示用户输入的真实字符，而是用预先设定好的回显字符来代替显示。

一般情况下，新建出来的密码框默认回显字符是“*”。

至于JPasswordField的构造方法，和JTextField基本是类似的，这里就不展开说明了。

2．JTextArea

JTextArea称为文本域，它能接收多行文本的输入。

使用JTextArea构造方法创建对象时，可以设定区域的行数、列数。

接下来介绍一下JTextArea常用的构造方法，如表3所示。

表3 JTextArea常用构造方法

表3中列出了JTextArea的四个构造方法。

在创建文本域时，通常会使用最后两个构造方法，以指定文本域的行数和列数。

案例演示：聊天窗口

接下来编写一个聊天窗口的案例，来演示文本组件JTextField和JTextArea组件的基本使用，如文件1所示。

文件1 Example11.ja va

 1    import ja va.awt.*;
 2    import ja vax.swing.*;
 3    public class Example11 {
 4        private static void createAndShowGUI() {
 5            // 1、创建一个JFrame聊天窗口
 6            JFrame f = new JFrame("聊天窗口");
 7            f.setLayout(new BorderLayout());
 8            f.setSize(400, 300);
 9            f.setLocation(300, 200);
 10            f.setVisible(true);
 11            f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
 12            // 2、创建一个JTextArea文本域，用来显示多行聊天信息
 13            JTextArea showArea = new JTextArea(12, 34);
 14            // 创建一个JScrollPane滚动面板组件，将JTextArea文本域作为其显示组件
 15            JScrollPane scrollPane = new JScrollPane(showArea);
 16            showArea.setEditable(false); // 设置文本域不可编辑
 17            // 3、创建一个JTextField文本框，用来输入单行聊天信息
 18            JTextField inputField = new JTextField(20);
 19            JButton btn = new JButton("发送"); 
 20            // 为按钮添加监听事件
 21            btn.addActionListener(e -> {
 22                String content = inputField.getText();
 23                // 判断输入的信息是否为空
 24                if (content != null && !content.trim().equals("")) {
 25                    // 如果不为空，将输入的文本追加到到聊天窗口
 26                    showArea.append("本人输入信息:" + content + "n");
 27                } else {
 28                    // 如果为空，提示聊天信息不能为空
 29                    showArea.append("聊天信息不能为空！！！" + "n");
 30                }
 31                inputField.setText(""); // 将输入的文本域内容置为空
 32            });
 33            // 3、创建一个JPanel面板组件
 34            JPanel panel = new JPanel();
 35            JLabel label = new JLabel("聊天信息");// 创建一个标签
 36            panel.add(label);                        // 将标签组件添加到JPanel面板
 37            panel.add(inputField);                  // 将文本框添加到JPanel面板
 38            panel.add(btn);                          // 将按钮添加到JPanel面板
 39            // 4、向JFrame聊天窗口的顶部和尾部分别加入面板组件JScrollPane和JPanel
 40            f.add(scrollPane, BorderLayout.PAGE_START);
 41            f.add(panel, BorderLayout.PAGE_END);
 42        }
 43        public static void main(String[] args) {
 44            // 使用SwingUtilities工具类调用createAndShowGUI()方法并显示GUI程序
 45            SwingUtilities.invokeLater(Example11::createAndShowGUI);
 46        }
 47    }

运行结果如图1所示。

图1 运行结果

案例结构说明

在文件1里，借助JFrame搭了一个简洁的聊天窗口。

程序先使用JFrame这个顶级容器创建聊天界面，并完成基础设置。

然后通过BorderLayout布局管理器，把整个窗口划分为上下两个区域，分别放入一个JScrollPane滚动面板组件和一个JPanel面板组件。

• PAGE_START区域：放置一个JScrollPane滚动面板，里面封装了一个JTextArea文本域，用来展示聊天记录。
• PAGE_END区域：放置一个JPanel面板，面板中包含JLabel、JTextField和JButton三个组件。
• JLabel：负责信息说明。
• JTextField：用于输入用户的聊天内容。
• JButton：用于发送聊天信息。

JLabel组件说明

需要说明的是，文件1中使用到的JLabel组件，是一个静态组件。

它用于显示一行静态文本和图标，只起到信息说明的作用。

JLabel不接收用户输入，也不能添加事件。

具体用法会在下一小节说明。

运行效果说明

在图1所示的聊天窗口中输入聊天信息，并单击【发送】按钮，结果如图2所示。

图2 运行结果

从图2可以看出，该聊天窗口工具可以按照程序正确执行。