Java的setLineWrap

在Java中，setLineWrap 方法通常与文本组件一起使用，如 JTextArea。JTextArea 是 Swing 库中的一个组件，用于显示多行区域的文本，并可以由用户编辑。setLineWrap 方法用于控制文本行的换行行为。

当 setLineWrap 设置为 true 时，如果文本长度超出了 JTextArea 的可视区域，那么文本将被换行到下一行，这样用户无需水平滚动即可看到所有内容。当设置为 false 时，文本将不会自动换行，用户可能需要水平滚动来查看超出可视区域的文本。

以下是如何在Java中使用 setLineWrap 方法的例子：

import javax.swing.*;

public class TextAreaExample {
    public static void main(String[] args) {
        SwingUtilities.invokeLater(new Runnable() {
            public void run() {
                // 创建一个 JFrame 容器窗口
                JFrame frame = new JFrame("JTextArea Example");
                frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

                // 创建 JTextArea
                JTextArea textArea = new JTextArea();

                // 启用自动换行
                textArea.setLineWrap(true);
                
                // 可以选择设置换行策略为在单词边界换行（而非在字符中间）
                textArea.setWrapStyleWord(true);

                // 将 JTextArea 添加到 JScrollPane 中以支持滚动
                JScrollPane scrollPane = new JScrollPane(textArea);

                // 将 JScrollPane 添加到 JFrame 中
                frame.add(scrollPane);

                // 设置窗口的尺寸
                frame.setSize(300, 200);
                
                // 显示窗口
                frame.setVisible(true);
            }
        });
    }
}

在这个例子中，我们创建了一个 JTextArea 并使其放在 JScrollPane 中，以便在内容超出显示区域时可以滚动。我们使用了 setLineWrap(true) 来启用自动换行，并且使用了 setWrapStyleWord(true) 让文本在单词边界处换行而非字符中间。这样可以保证换行时单词的完整性，提高文本的可读性。

记住，Swing 组件的所有更改都应当在事件派发线程（Event Dispatch Thread，EDT）上执行，这就是为什么我们在 SwingUtilities.invokeLater 中运行窗口创建代码，以确保线程安全。

一些不同场景下使用 JTextArea 和 setLineWrap 方法的例子。

示例1：带滚动条的基本文本编辑器

import javax.swing.*;

public class BasicTextEditor {
    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> {
            // 创建窗口
            JFrame frame = new JFrame("Basic Text Editor");
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

            // 创建文本区域
            JTextArea textArea = new JTextArea();
            textArea.setLineWrap(true); // 启用自动换行
            textArea.setWrapStyleWord(true); // 在单词边界换行

            // 添加滚动条
            JScrollPane scrollPane = new JScrollPane(textArea);
            frame.add(scrollPane);

            // 设置窗口大小并显示
            frame.setSize(400, 300);
            frame.setVisible(true);
        });
    }
}

示例2：带菜单的文本编辑器，可以切换换行

import javax.swing.*;

public class TextEditorWithMenu {
    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> {
            // 创建窗口
            JFrame frame = new JFrame("Text Editor with Menu");
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

            // 创建文本区域
            JTextArea textArea = new JTextArea();
            textArea.setLineWrap(true);
            textArea.setWrapStyleWord(true);

            // 添加滚动条
            JScrollPane scrollPane = new JScrollPane(textArea);
            frame.add(scrollPane);

            // 创建菜单栏和菜单项
            JMenuBar menuBar = new JMenuBar();
            JMenu optionsMenu = new JMenu("Options");
            JMenuItem toggleWrap = new JMenuItem("Toggle Line Wrap");

            // 添加动作监听器来切换换行
            toggleWrap.addActionListener(e -> {
                boolean isWrap = textArea.getLineWrap();
                textArea.setLineWrap(!isWrap); // 切换换行状态
            });

            // 将菜单项添加到菜单
            optionsMenu.add(toggleWrap);

            // 将菜单添加到菜单栏
            menuBar.add(optionsMenu);

            // 将菜单栏设置到窗口
            frame.setJMenuBar(menuBar);

            // 设置窗口大小并显示
            frame.setSize(400, 300);
            frame.setVisible(true);
        });
    }
}

示例3：文本区域状态显示

import javax.swing.*;
import java.awt.*;

public class TextAreaStatusDisplay {
    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> {
            // 创建窗口
            JFrame frame = new JFrame("Text Area with Status");
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setLayout(new BorderLayout());

            // 创建文本区域
            JTextArea textArea = new JTextArea();
            textArea.setLineWrap(true);
            textArea.setWrapStyleWord(true);

            // 添加滚动条
            JScrollPane scrollPane = new JScrollPane(textArea);
            frame.add(scrollPane, BorderLayout.CENTER);

            // 创建状态栏
            JLabel statusLabel = new JLabel("Line Wrap: ON");
            frame.add(statusLabel, BorderLayout.SOUTH);

            // 添加文本区域的文档监听器
            textArea.getDocument().addDocumentListener(new SimpleDocumentListener() {
                @Override
                public void update() {
                    boolean isWrap = textArea.getLineWrap();
                    statusLabel.setText("Line Wrap: " + (isWrap ? "ON" : "OFF"));
                }
            });

            // 设置窗口大小并显示
            frame.setSize(400, 300);
            frame.setVisible(true);
        });
    }

    // 简单的文档监听器适配器
    public abstract static class SimpleDocumentListener implements javax.swing.event.DocumentListener {
        public abstract void update();

        @Override
        public void insertUpdate(javax.swing.event.DocumentEvent e) {
            update();
        }

        @Override
        public void removeUpdate(javax.swing.event.DocumentEvent e) {
            update();
        }

        @Override
        public void changedUpdate(javax.swing.event.DocumentEvent e) {
            update();
        }
    }
}

这些示例展示了 setLineWrap 在实际应用程序中的多种用途。你可以根据需要将这些示例整合到更复杂的应用程序中，例如文本编辑器或者注释工具。