如何确保 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 的基础实践。搞懂了这一点，很多类似的布局问题就能迎刃而解。