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