Summary

JProgressBarでページのスクロールした距離を表示する進捗インジケーターを作成し、JScrollPaneのヘッダに追加します。

Source Code Examples

JScrollPane scroll = new JScrollPane(new JTextArea(buf.toString()));
BoundedRangeModel model = scroll.getVerticalScrollBar().getModel();
JProgressBar progress = new ScrollIndicator(model);
scroll.setColumnHeaderView(progress);
// ...

class ScrollIndicator extends JProgressBar {
  protected ScrollIndicator(BoundedRangeModel model) {
    super(model);
  }

  @Override public void updateUI() {
    super.updateUI();
    setUI(new ScrollIndicatorUI());
    setBorder(BorderFactory.createEmptyBorder());
  }

  @Override public double getPercentComplete() {
    long span = model.getMaximum() - model.getMinimum();
    // double currentValue = model.getValue();
    double currentValue = model.getValue() + model.getExtent();
    return  (currentValue - model.getMinimum()) / span;
  }

  @Override public Dimension getPreferredSize() {
    Dimension d = super.getPreferredSize();
    if (getOrientation() == HORIZONTAL) {
      d.height = 4;
    } else {
      d.width = 4;
    }
    return d;
  }
}

class ScrollIndicatorUI extends BasicProgressBarUI {
  @Override public void paintDeterminate(Graphics g, JComponent c) {
    Insets b = progressBar.getInsets();
    Rectangle r = SwingUtilities.calculateInnerArea(progressBar, null);
    // BoundedRangeModel m = progressBar.getModel();
    if (!r.isEmpty()) {
      // int range = m.getMaximum() - m.getMinimum();
      // int extent = (int) Math.floor(r.width *  m.getExtent() / (float) range);
      int amountFull = getAmountFull(b, r.width, r.height); // + extent;
      Graphics2D g2 = (Graphics2D) g.create();
      g2.setColor(UIManager.getColor("ProgressBar.foreground"));
      if (progressBar.getOrientation() == SwingConstants.HORIZONTAL) {
        g2.fillRect(r.x, r.y, amountFull, r.height);
      } else { // VERTICAL
        g2.fillRect(r.x, r.y + r.height - amountFull, r.width, amountFull);
      }
      // Deal with possible text painting
      if (progressBar.isStringPainted()) {
        paintString(g2, r.x, r.y, r.width, r.height, amountFull, b);
      }
      g2.dispose();
    }
  }
}
View in GitHub: Java, Kotlin

Description

  • JScrollPane#getVerticalScrollBar()で縦JScrollBarを取得し、そのBoundedRangeModelを共有するJProgressBarを作成
    • JScrollPane#setColumnHeaderView(...)JScrollPaneのカラムヘッダに配置
  • JScrollBarの表示領域(JViewportの高さ)がそのBoundedRangeModelextent(ノブの高さ)となるが、JProgressBarBoundedRangeModelは進捗の描画にextentは使用しない(常に0)ので、進捗が100%になってもJProgressBarの右端にextent分の塗り残しが発生する
    • このサンプルではこれを解消するため、以下のような調整を行っている
    • 進捗状況の描画領域サイズを計算するBasicProgressBarUI#getAmountFull(...)が内部でJProgressBar#getPercentComplete()を使用するので、JProgressBar#getPercentComplete()をオーバーライドし、縦JScrollBarのノブの下辺の位置がJProgressBarの現在値となるよう、BoundedRangeModel#getValue()ではなくBoundedRangeModel#getValue() + BoundedRangeModel#getExtent()の値で進捗のパーセントを求めるよう変更

Reference

Comment