自定义JTableHeader样式以移除多余空白区域

我之前也碰到过类似的JTable表头适配深色主题时出现末尾空白的情况，结合你提到的自定义TableUI、继承MetalLookAndFeel的场景，给你几个可以尝试的解决方向：

• 检查表头UI的内边距与边框设置
  自定义继承自BasicTableUI的TableHeaderUI时，很可能是默认的内边距或者边框带来了额外空白。你可以重写getInsets方法，把右侧内边距强制设为0：

  @Override
  public Insets getInsets(JComponent c) {
      // 根据你的需求调整上下左内边距，右边距设为0消除空白
      return new Insets(3, 5, 3, 0);
  }
  

  同时，别忘了清空表头的默认边框，比如在自定义UI的初始化方法里加上：

  tableHeader.setBorder(BorderFactory.createEmptyBorder());
  

• 调整MetalLookAndFeel的全局UI默认值
  既然你继承了MetalLookAndFeel，可以在initClassDefaults方法里覆盖表头相关的默认属性，避免主题自带的样式干扰：

  @Override
  protected void initClassDefaults(UIDefaults defaults) {
      super.initClassDefaults(defaults);
      // 替换为自定义的表头渲染器，确保背景填充完整
      defaults.put("TableHeader.cellRenderer", DarkTableHeaderRenderer.class);
      // 移除表头的默认边框
      defaults.put("TableHeader.border", BorderFactory.createEmptyBorder());
  }
  

  自定义的DarkTableHeaderRenderer要确保在paintComponent里填充整个单元格区域，不要留空白：

  @Override
  protected void paintComponent(Graphics g) {
      g.setColor(getBackground());
      // 填充整个组件的宽高，覆盖所有区域
      g.fillRect(0, 0, getWidth(), getHeight());
      super.paintComponent(g);
  }
  

• 确保表头宽度与表格列总宽度匹配
  有时候空白是因为表头的宽度没有和表格所有列的总宽度对齐。你可以手动计算并设置表头的首选宽度：

  int totalColumnWidth = 0;
  TableColumnModel columnModel = table.getColumnModel();
  for (int i = 0; i < columnModel.getColumnCount(); i++) {
      totalColumnWidth += columnModel.getColumn(i).getWidth();
  }
  Dimension headerSize = table.getTableHeader().getPreferredSize();
  table.getTableHeader().setPreferredSize(new Dimension(totalColumnWidth, headerSize.height));
  

  如果JTable放在JScrollPane里，还要确保滚动面板的视口没有额外边框：

  scrollPane.setViewportBorder(BorderFactory.createEmptyBorder());
  

• 排查自定义绘制方法的细节
  如果你重写了表头的paint方法，一定要确认绘制背景时没有遗漏右侧区域。比如避免使用固定宽度绘制背景，而是用组件的实际宽度：

  @Override
  public void paint(Graphics g, JComponent c) {
      // 用c.getWidth()获取实际宽度，不要写死数值
      g.setColor(darkHeaderColor);
      g.fillRect(0, 0, c.getWidth(), c.getHeight());
      // 再绘制表头内容
      super.paint(g, c);
  }
  

如果尝试了这些方法还是没解决，可以把你的自定义TableUI、MetalLookAndFeel子类的关键代码片段贴出来，这样更容易定位具体问题。

内容的提问来源于stack exchange，提问作者sjyn