文本组件

文本组件用于接收用户输入的信息，其中包括文本框（JTextField）、文本域（JTextArea）等，它们都有一个共同父类JTextComponent，JTextComponent是一个抽象类，它提供了文本组件常用的方法，如表1所示。

表1 JTextComponent常用方法

表8-7中列出了文本组件常用的几种操作方法，其中包括选中文本内容、设置文本内容以及获取文本内容等。由于JTextField和JTextArea这两个文本组件都继承了JTextComponent类，因此它们都具有表8-7中的方法。但在使用上还有一定的区别，接下来就对这两个文本组件进行详细讲解。
1．JTextField

JTextField称为文本框，它只能接收单行文本的输入，接下来介绍一下JTextField常用的构造方法，如表2所示。

表2 JTextField常用构造方法

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

JTextField有一个子类JPasswordField，它表示一个密码框，只能接收用户的单行输入，但是在此框中不显示用户输入的真实信息，而是通过显示指定的回显字符作为占位符。新创建的密码框默认的回显字符为“*”。JPasswordField和JTextField的构造方法相似，这里就不再介绍了。

2．JTextArea

JTextArea称为文本域，它能接收多行文本的输入，使用JTextArea构造方法创建对象时可以设定区域的行数、列数，接下来介绍一下JTextArea常用的构造方法，如表3所示。

表3 JTextArea常用构造方法

表3中，列出了JTextArea的四个构造方法，在创建文本域时，通常会使用最后两个构造方法，指定文本域的行数和列数。

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

文件1 Example11.java

 1    import java.awt.*;
 2    import javax.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按钮用于发送聊天信息。

需要说明的是，文件1中使用到的JLabel组件，是一个静态组件，用于显示一行静态文本和图标，它起到的作用只是信息说明，不接收用户的输入，也不能添加事件，具体用法会在下一小节说明。

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

图2 运行结果

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