Java Swing GUI开发：JFrame与JDialog窗体创建详解

Swing框架概述与组件层次

Swing是Java语言提供的图形化界面工具包，以抽象窗口工具包（AWT）为基础构建，支持跨平台应用程序的可插拔外观风格。相较于重量级的AWT组件，Swing提供了更丰富、灵活且轻量级的库，开发人员只需少量代码即可创建优秀的用户界面。

所有Swing组件均位于javax.swing包中，其类结构继承自Container，主要划分为两个分支：

• 容器分支：用于构建图形化界面的窗口层级。
• 组件分支：用于填充数据、元素及提供交互功能。

在容器分支中，存在三个直接继承AWT Window类的顶级容器：JWindow、JFrame和JDialog。其中，JFrame和JDialog最为常用。JFrame作为独立存在的顶级容器，支持窗口最小化、尺寸调整等基本功能；JDialog则用于表示对话框窗口，分为模态和非模态两种类型。

第1步：使用JFrame创建主窗口

JFrame是Swing中用于创建独立窗口的核心类。在实际开发中，推荐使用SwingUtilities.invokeLater确保GUI创建在事件调度线程中执行，以保证线程安全。

操作目的：创建一个带有标题、固定尺寸、指定位置及自定义图标的完整窗口，并处理关闭事件。

import javax.imageio.ImageIO;
import javax.swing.*;
import java.awt.*;
import java.io.File;
import java.io.IOException;

public class JFrameBasicDemo extends JFrame {
    public static void main(String[] args) {
        // 使用SwingUtilities确保线程安全地显示GUI
        SwingUtilities.invokeLater(JFrameBasicDemo::createAndShowGUI);
    }

    private static void createAndShowGUI() {
        // 1. 创建窗口实例
        JFrame frame = new JFrame("JFrameText");
        
        // 2. 设置关闭时的默认操作（退出程序）
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        
        // 3. 设置窗口标题
        frame.setTitle("应用主窗口");
        
        // 4. 设置窗口尺寸（宽, 高）
        frame.setSize(350, 300);
        
        // 5. 设置窗口显示位置（相对于屏幕左上角）
        frame.setLocation(300, 200);
        
        // 6. 加载并设置窗口图标
        try {
            Image image = ImageIO.read(new File("image.png")); // 替换为实际图片路径
            frame.setIconImage(image);
        } catch (IOException e) {
            e.printStackTrace();
        }
        
        // 7. 显示窗口
        frame.setVisible(true);
        
        // 调试输出：验证标题获取
        System.out.println(frame.getTitle());
    }
}

第2步：实现JDialog模态与非模态对话框

JDialog常用于临时交互或信息提示。模态对话框（Modal）会阻塞父窗口的其他操作，直到对话框关闭；非模态对话框则允许用户同时与父窗口进行交互。

操作目的：在主窗口中添加按钮，分别触发模态和非模态对话框，并在对话框内添加“确定”按钮以关闭自身。

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

public class DialogDemo {
    public static void main(String[] args) {
        // 1. 创建主窗口
        JFrame f = new JFrame("DialogDemo");
        f.setSize(300, 250);
        f.setLocation(300, 200);
        f.setLayout(new FlowLayout());
        f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

        // 2. 创建两个按钮，分别对应模态和非模态
        JButton btn1 = new JButton("打开模态对话框");
        JButton btn2 = new JButton("打开非模态对话框");
        
        f.add(btn1);
        f.add(btn2);
        f.setVisible(true);

        // 3. 预定义共享标签
        final JLabel label = new JLabel();

        // 4. 创建JDialog实例，绑定父窗口f
        final JDialog dialog = new JDialog(f, "DialogTitle", true); // 默认模式可后续修改
        dialog.setSize(220, 150);
        dialog.setLocation(350, 250);
        dialog.setLayout(new FlowLayout());

        // 5. 在对话框中添加内容
        final JButton btn3 = new JButton("确定");
        dialog.add(label);
        dialog.add(btn3);

        // 6. 事件处理：模态按钮点击
        btn1.addActionListener(e -> {
            dialog.setModal(true);
            label.setText("模态对话框：必须关闭此框才能操作主窗口");
            dialog.setVisible(true);
        });

        // 7. 事件处理：非模态按钮点击
        btn2.addActionListener(e -> {
            dialog.setModal(false);
            label.setText("非模态对话框：可同时操作主窗口");
            dialog.setVisible(true);
        });

        // 8. 事件处理：对话框内“确定”按钮点击
        btn3.addActionListener(e -> {
            dialog.dispose();
        });
    }
}

补充：使用JPanel优化界面布局

当需要在JFrame中放置多个组件时，直接使用默认BorderLayout可能导致布局混乱。推荐先创建JPanel作为中间容器，统一管理按钮、文本框等组件，再将JPanel添加到JFrame中。

操作目的：构建一个简单的登录表单，统一字体样式，并将标签与输入框有序排列。

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

public class LoginPanelDemo extends JFrame {
    public static void main(String[] args) {
        SwingUtilities.invokeLater(LoginPanelDemo::createAndShowGUI);
    }

    private static void createAndShowGUI() {
        JFrame frame = new JFrame("Login Demo");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(350, 300);
        frame.setLocation(300, 200);

        // 1. 创建面板容器
        JPanel jp = new JPanel();
        jp.setLayout(new GridLayout(3, 2, 5, 5)); // 三行两列网格布局，间距5像素

        // 2. 统一字体设置
        Font font = new Font("宋体", Font.PLAIN, 14);

        // 3. 创建组件
        JLabel jlUser = new JLabel("用户名：");
        JTextField jtfUser = new JTextField("请输入用户名", 15);
        
        JLabel jlPass = new JLabel("密 码：");
        // 注意：密码框建议使用JPasswordField，此处为保持通用性使用JTextField
        JTextField jtfPass = new JTextField("请输入密码", 15);
        
        JButton jbLogin = new JButton("登录");
        JButton jbExit = new JButton("退出");

        // 4. 应用字体
        jlUser.setFont(font);
        jtfUser.setFont(font);
        jlPass.setFont(font);
        jtfPass.setFont(font);
        jbLogin.setFont(font);
        jbExit.setFont(font);

        // 5. 添加至面板
        jp.add(jlUser);
        jp.add(jtfUser);
        jp.add(jlPass);
        jp.add(jtfPass);
        jp.add(jbLogin);
        jp.add(jbExit);

        // 6. 将面板添加至窗口
        frame.add(jp);
        frame.setVisible(true);
    }
}

完成判断与注意事项

判断窗体创建成功的标准如下：

• JFrame：屏幕出现指定位置和尺寸的独立窗口，任务栏有相应图标，点击右上角关闭按钮可正常终止进程。
• JDialog：鼠标悬停于触发按钮上时未报错，点击后弹出子窗口。若设为模态，尝试点击背后主窗口应无响应；若设为非模态，主窗口仍可被激活。
• 异常处理：代码中捕获了IOException以应对图片加载失败的情况，确保程序健壮性。

以上就是Java Swing中JFrame主窗口与JDialog对话框创建的详细内容，更多关于Java GUI界面设计、布局管理器及应用实战的资料请关注本站其它相关文章！