如何确保 JPanel 中的自绘图形完全可见

在 Swing 开发中，自绘组件只显示一半的情况，其实挺常见的。比如画个网格，结果只露出来几行，剩下的全被裁掉了。问题出在哪儿？很简单：组件没有把自己的“真实尺寸”告诉布局管理器。

很多开发者习惯用 setPreferredSize() 或者 setMinimumSize() 来硬性指定一个尺寸，觉得这样省事。但 Swing 的布局系统，尤其是 FlowLayout 这类非约束型布局，并不会老老实实听你的。它更倾向于按组件的“默认大小”来排布，结果就是——你设的尺寸被忽略了，绘图区域被截断。

正确的做法，不是在外面“硬塞”一个尺寸，而是让组件自身来决定它需要多大。换句话说，重写 getPreferredSize()、getMinimumSize()，甚至 getMaximumSize()，让布局管理器知道你的组件到底想占多少空间。

来看一个优化后的 SchedulePanel 实现：

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);
    }

    @Override
    public Dimension getPreferredSize() {
        // 基于网格逻辑动态计算：宽 = 列数 × 单元格边长，高 = 行数 × 单元格边长
        return new Dimension(cols * cellSide, rows * cellSide);
    }

    @Override
    public Dimension getMinimumSize() {
        // 最小尺寸至少等于首选尺寸，避免压缩
        return getPreferredSize();
    }

    @Override
    public Dimension getMaximumSize() {
        // 可选：限制最大尺寸，防止过度拉伸（如需）
        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);

        // 绘制水平线（rows + 1 条，覆盖所有行间隔）
        for (int i = 0; i <= rows; i++) {
            int y = i * cellSide;
            g2d.drawLine(0, y, cols * cellSide, y);
        }

        // 绘制垂直线（cols + 1 条，覆盖所有列间隔）
        for (int i = 0; i <= cols; i++) {
            int x = i * cellSide;
            g2d.drawLine(x, 0, x, rows * cellSide);
        }
        g2d.dispose();
    }
}

这段代码有几个关键改进：

• ✅ 重写 getPreferredSize()：返回精确匹配网格需求的尺寸（cols * cellSide × rows * cellSide），而非硬编码的 400×400，这样不仅灵活，后续修改网格大小也方便；
• ✅ 同步 getMinimumSize()：防止布局管理器因为最小尺寸过小而压缩面板，保证组件有足够的空间；
• ✅ 使用 Graphics2D 与抗锯齿：提升线条绘制质量，虽然不是必须的，但推荐加上；
• ✅ 修正循环边界：原代码只画了 rows 条横线和 cols 条竖线，实际上需要 rows+1 条横线、cols+1 条竖线，才能完整围出 rows×cols 个单元格；
• ❌ 移除 setMinimumSize() 调用：外部设置会破坏组件的自治性，而且容易被后续代码覆盖，不如让组件自己决定。

另外，主界面的布局也值得优化。如果改用 BorderLayout 或 GridBagLayout，组件的空间分配会更可控。比如：

public EventSchedulerGUI() {
    setLayout(new BorderLayout());
    roomPanel = new RoomPanel();
    schedulePanel = new SchedulePanel();
    add(roomPanel, BorderLayout.WEST);
    add(schedulePanel, BorderLayout.CENTER); // CENTER 自动填充剩余空间
}

这样一来，SchedulePanel 就能获得充足的绘制区域，不再需要担心被截断的问题。

再次强调：Swing 组件应该“声明意图”，而不是“强制尺寸”。让布局系统基于你的尺寸策略智能排布，才是稳定、可维护的 GUI 开发之道。