java - JTable#scrollRectToVisible 结合 JSplitPlane 显示错误的行

Question

当我调用 JTable#scrollRectToVisible 时，在某些情况下我想要显示的行隐藏在标题下方。

这个问题的其余部分只有在使用以下代码时才有意义。这是一个非常简单的程序，我用它来说明问题。它显示了一个包含 JSplitPane 的 UI，上半部分包含一些控制按钮，下半部分包含一个包裹在 JScrollPane 中的 JTable(请参阅截图在这篇文章的底部)。

import java.awt.EventQueue;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.ItemEvent;
import java.awt.event.ItemListener;

import javax.swing.*;
import javax.swing.table.DefaultTableModel;
import javax.swing.table.TableModel;

public class DividerTest {

  private final JSplitPane fSplitPane = new JSplitPane(JSplitPane.VERTICAL_SPLIT);
  private final JTable fTable;
  private final JScrollPane fScrollPane;

  private boolean fHideTable = false;

  public DividerTest() {
    fTable = new JTable( createTableModel(50));
    fScrollPane = new JScrollPane(fTable);
    fSplitPane.setBottomComponent(fScrollPane);
    fSplitPane.setTopComponent(createControlsPanel());
    fSplitPane.setDividerLocation(0.5);
  }

  private JPanel createControlsPanel(){
    JPanel result = new JPanel();
    result.setLayout(new BoxLayout(result, BoxLayout.PAGE_AXIS));

    final JCheckBox checkBox = new JCheckBox("Make table invisible before adjusting divider");
    checkBox.addItemListener(new ItemListener() {
      @Override
      public void itemStateChanged(ItemEvent e) {
        fHideTable = checkBox.isSelected();
      }
    });
    result.add(checkBox);

    JButton upperRow = new JButton("Select row 10");
    upperRow.addActionListener(new ActionListener() {
      @Override
      public void actionPerformed(ActionEvent e) {
        selectRowInTableAndScroll(10);
      }
    });
    result.add(upperRow);

    JButton lowerRow = new JButton("Select row 45");
    lowerRow.addActionListener(new ActionListener() {
      @Override
      public void actionPerformed(ActionEvent e) {
        selectRowInTableAndScroll(45);
      }
    });
    result.add(lowerRow);

    JButton hideBottom = new JButton("Hide bottom");
    hideBottom.addActionListener(new ActionListener() {
      @Override
      public void actionPerformed(ActionEvent e) {
        if (fHideTable) {
          fScrollPane.setVisible(false);
        }
        fSplitPane.setDividerLocation(1.0);
      }
    });
    result.add(hideBottom);

    JButton showBottom = new JButton("Show bottom");
    showBottom.addActionListener(new ActionListener() {
      @Override
      public void actionPerformed(ActionEvent e) {
        fScrollPane.setVisible(true);
        fSplitPane.setDividerLocation(0.5);
      }
    });
    result.add(showBottom);

    return result;
  }

  private void selectRowInTableAndScroll( int aRowIndex ){
    fTable.clearSelection();
    fTable.getSelectionModel().addSelectionInterval(aRowIndex, aRowIndex);
    fTable.scrollRectToVisible(fTable.getCellRect(aRowIndex, 0, true));
  }

  public JComponent getUI(){
    return fSplitPane;
  }

  private TableModel createTableModel(int aNumberOfRows){
    Object[][] data = new Object[aNumberOfRows][1];
    for( int i = 0; i < aNumberOfRows; i++ ){
      data[i] = new String[]{"Row" + i};
    }
    return new DefaultTableModel(data, new String[]{"Column"});
  }

  public static void main(String[] args) {
    EventQueue.invokeLater(new Runnable() {
      @Override
      public void run() {
        JFrame frame = new JFrame("Test frame");

        frame.getContentPane().add(new DividerTest().getUI());
        frame.pack();
        frame.setVisible(true);
        frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
      }
    });
  }
}

不良行为

• 运行上面的代码
• 按“选择第 10 行”:第 10 行被选中并可见
• 按“选择第 45 行”:第 45 行被选中并可见
• 点击“隐藏底部”按钮。这将调整 JSplitPane 的分隔线，以便只有上面板可见
• 点击“选择第 10 行”按钮。你当然什么也看不到，因为 table 还不可见
• 点击“显示底部”按钮。分隔符已调整，但第 10 行隐藏在标题下方。我希望它无需滚动即可显示。

想要的行为

重复上述步骤，但要确保选中“调整分隔线前使表格不可见”复选框。这将在隐藏底部面板之前调用 JTable 周围的 JScrollPane 上的 setVisible(false)。

通过这样做，在最后一步中，第 10 行将显示为最顶行，这正是我想要的。 我只是不想让滚动 Pane 不可见:在我的实际应用程序中，分隔线以动画方式调整，因此您希望在动画期间保持表格可见。

屏幕截图

不需要:执行上述步骤后第 10 行不可见

需要:执行上述步骤后第 10 行可见

环境

我认为这无关紧要，但以防万一:我在 Linux 系统上使用 JDK7。

Answer 1

这似乎是由 JViewport 处理 scrollRectToVisible 调用的方式引起的，因为它的大小小于所需的矩形。它在 JavaDocs 中包含一条(有点模糊，但可能相关的)评论:

Note that this method will not scroll outside of the valid viewport; for example, if contentRect is larger than the viewport, scrolling will be confined to the viewport's bounds.

我没有仔细阅读完整的代码并进行所有数学运算并检查所有情况。所以一个警告:以下解释包含完全相同的挥手。但是在这个特殊情况下这对我意味着什么的简单描述:

当底部部分被隐藏时(通过相应地设置分隔线位置)，则 JScrollPane 及其 JViewport 的高度为 0。现在，当请求 scrollRectToVisible 和一个高度为 20 的矩形(例如，对于一个表格行)，然后它会注意到这不适合。根据 JViewport 的当前 View 位置，这可能会导致滚动视口(viewport)，以便该矩形的底部可见。

(您可以观察到这一点:手动拖动分隔线位置，以便一个表格行的大约 一半 可见。单击“选择第 45 行”按钮时，该行的上半部分将可见。单击“选择第 10 行”按钮时，该行的下半部分将可见)

这里似乎对我有用的一个实用解决方案是确保它始终滚动，以便矩形的顶部可见(即使矩形根本不适合视口(viewport)!)。像这样:

private void selectRowInTableAndScroll(int aRowIndex)
{
    fTable.clearSelection();
    fTable.getSelectionModel().addSelectionInterval(aRowIndex, aRowIndex);

    Rectangle r = fTable.getCellRect(aRowIndex, 0, true);
    r.height = Math.min(fScrollPane.getHeight(), r.height);
    fTable.scrollRectToVisible(r);
}

但是当动画发挥作用时，我不能保证这会对您产生预期的效果...