全面确保Swing中JPanel自绘图形完整可见的实用技巧

在 Swing 图形界面开发过程中，自绘内容的完整显示往往并非绘画技巧存在问题，而是组件尺寸协商机制导致的常见陷阱。你可能会遇到这样的情况：明明在 JPanel 的 paintComponent 方法里绘制了清晰的网格线条，运行时却只呈现右上角一小块区域，其余部分仿佛被裁剪掉了。这其实是一个非常典型的“坑”——问题的根源不在于绘制了什么内容，而在于容器是否为组件分配了足够的空间。

我们来深入剖析一下原因。多数布局管理器（例如 FlowLayout）在安排组件位置时，优先参考的是 getPreferredSize() 方法返回的尺寸，而非 setMinimumSize() 或 setMaximumSize() 的设置。如果没有重写 getPreferredSize()，系统就会使用默认值——通常是一个非常小的尺寸，面板自然会被压缩，绘制的图形也因此被截断。这正是症结所在。

正确的解决方案是：让组件自己声明所需要的空间大小。即重写 getPreferredSize()，并连带重写 getMinimumSize() 和 getMaximumSize()，形成一个完整的尺寸“契约”。下面是一个典型的修复示例：

public class SchedulePanel extends JPanel {
    private static final long serialVersionUID = 1L;
    static final int cellSide = 50;
    static final int cols = 5;
    static final int rows = 5;

    public SchedulePanel() {
        setBackground(Color.LIGHT_GRAY);
        // setMinimumSize(...) 可以保留，但不是关键
    }

    @Override
    public Dimension getPreferredSize() {
        // 核心修复：告诉布局管理器“我需要这么大”
        return new Dimension(cols * cellSide, rows * cellSide);
    }

    @Override
    public Dimension getMinimumSize() {
        // 保持最小尺寸与首选一致，避免意外压缩
        return getPreferredSize();
    }

    @Override
    protected void paintComponent(Graphics g) {
        super.paintComponent(g); // 必须调用，确保背景正确绘制
        Graphics2D g2d = (Graphics2D) g.create();
        g2d.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);

        // 绘制水平线
        for (int i = 0; i <= rows; i++) {
            int y = i * cellSide;
            g2d.drawLine(0, y, cols * cellSide, y);
        }

        // 绘制垂直线
        for (int i = 0; i <= cols; i++) {
            int x = i * cellSide;
            g2d.drawLine(x, 0, x, rows * cellSide);
        }

        g2d.dispose();
    }
}

这里有几个关键点需要特别留意：

• 不要在构造函数中调用 setPreferredSize()。这种做法会覆盖组件自身的尺寸逻辑，且容易被外部代码意外修改，违反 Swing 的尺寸协商原则。getPreferredSize() 是组件的“声明式”表达，而 setXxxSize() 则是外部的“强制覆盖”，应尽量避免。
• 注意循环边界。原代码中 for (int i = 0; i < rows; i++) 只绘制了 rows-1 条水平线，缺少底部边框。改为 i <= rows 后，可以绘制 rows+1 条线，形成完整的 rows × cols 网格。
• 开启抗锯齿。使用 Graphics2D 并开启 KEY_ANTIALIASING 提示，能让线条更平滑，视觉效果显著提升。
• 调用 super.paintComponent(g)。这是必须的步骤，负责清除脏区域、绘制背景等。缺失会导致残留图像或背景不显示，很多人会忽略这个细节。

此外，在父容器 EventSchedulerGUI 中，建议为 schedulePanel 显式指定布局约束。例如使用 BorderLayout 替代 FlowLayout，因为 FlowLayout 对组件尺寸的控制力较弱。一个更可控的做法如下：

public EventSchedulerGUI() {
    setLayout(new BorderLayout());
    roomPanel = new RoomPanel();
    schedulePanel = new SchedulePanel();
    add(roomPanel, BorderLayout.WEST);
    add(schedulePanel, BorderLayout.CENTER); // CENTER 会自动拉伸填充可用空间
}

总的来说，让自绘图形始终完整可见的核心在于：组件必须主动、准确地通过 getPreferredSize() 告知布局系统自身所需空间，而不是被动接受外部尺寸设定。这正是 Swing 尺寸协商机制的设计哲学，也是构建健壮 GUI 的基础实践。一旦理解了这个原理，许多类似的布局问题便能迎刃而解。