Java Swing JProgressBar：进度条组件

Love The Way You Lie 2024-03-30 11:32 74阅读 0赞

进度条（JProgressBar）是一种以可视化形式显示某些任务进度的组件。JProgressBar 类实现了一个用于为长时间的操作提供可视化指示器的 GUI 进度条。在任务的完成进度中，进度条显示该任务完成的百分比。此百分比通常由一个矩形以可视化形式表示，该矩形开始是空的，随着任务的完成逐渐被填充。此外，进度条可显示此百分比的文本表示形式。

JProgressBar 类的常用构造方法和 JSlider 类的常用构造方法一样，这里不再重复。如下示例代码演示了如何创建一个 JProgressBar 类实例。

> 1.  `//创建一个最小值是0，最大值是100的进度条`
> 2.  `JProgressBar pgbar=new JProgressBar(0,100);`
> 3.  `//创建一个最小值是0，最大值是60，当前值是20的进度条`
> 4.  `JProgressBar pgbar=new JProgressBar(0,60,20);`

JProgressBar 类的常用方法如表 1 所示。

<table> 
 <thead> 
  <tr> 
   <th>方法名称</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>getMaximum()</td> 
   <td>返回进度条的最大值</td> 
  </tr> 
  <tr> 
   <td>getMinimum()</td> 
   <td>返回进度条的最小值</td> 
  </tr> 
  <tr> 
   <td>getPercentComplete()</td> 
   <td>返回进度条的完成百分比</td> 
  </tr> 
  <tr> 
   <td>getString()</td> 
   <td>返回当前进度的 String 表示形式</td> 
  </tr> 
  <tr> 
   <td>getValue()</td> 
   <td>返回进度条的当前 value</td> 
  </tr> 
  <tr> 
   <td>setBorderPainted(boolean b)</td> 
   <td>设置 borderPainted 属性，如果进度条应该绘制其边框，则此属性为 true</td> 
  </tr> 
  <tr> 
   <td>setIndeterminate(boolean newValue)</td> 
   <td>设置进度条的 indeterminate 属性，该属性确定进度条处于确定模式中还 是处于不确定模式中</td> 
  </tr> 
  <tr> 
   <td>setMaximum(int n)</td> 
   <td>将进度条的最大值设置为 n</td> 
  </tr> 
  <tr> 
   <td>setMinimum(int n)</td> 
   <td>将进度条的最小值设置为 n</td> 
  </tr> 
  <tr> 
   <td>setOrientation(int newOrientation)</td> 
   <td>将进度条的方向设置为 newOrientation</td> 
  </tr> 
  <tr> 
   <td>setString(String s)</td> 
   <td>设置进度字符串的值</td> 
  </tr> 
  <tr> 
   <td>setStringPainted(boolean b)</td> 
   <td>设置 stringPainted 属性的值，该属性确定进度条是否应该呈现进度字符串</td> 
  </tr> 
  <tr> 
   <td>setValue(int n)</td> 
   <td>将进度条的当前值设置为 n</td> 
  </tr> 
  <tr> 
   <td>updateUI()</td> 
   <td>将 UI 属性重置为当前外观对应的值</td> 
  </tr> 
 </tbody> 
</table>

其中，setOrientation() 方法的参数值必须为 SwingConstants.VERTICAL 或 SwingConstants.HORIZONTAL。JProgressBar 使用 BoundedRangeModel 作为其数据模型，以 value 属性表示该任务的“当前”状态，minimum 和 maximum 属性分别表示开始点和结束点。

技巧：如果要执行一个未知长度的任务，可以调用 setlndeterminate(true) 将进度条设置为不确定模式。不确定模式的进度条将持续地显示动画来表示正进行的操作。一旦可以确定任务长度和进度量，则应该更新进度条的值，将其切换到确定模式。

例 1

使用 JProgressBar 类创建一个进度条模拟程序升级过程，实现过程如下。

(1) 创建一个继承自 JFrame 的 JProgressBarDemo 类。

(2) 在构造方法中添加一个空的进度条，然后设置它的显示属性。主要代码如下:

> 1.  `package ch18;`
> 2.  `import java.awt.Container;`
> 3.  `import java.awt.FlowLayout;`
> 4.  `import java.awt.GridLayout;`
> 5.  `import java.awt.event.ActionEvent;`
> 6.  `import java.awt.event.ActionListener;`
> 7.  `import javax.swing.JButton;`
> 8.  `import javax.swing.JFrame;`
> 9.  `import javax.swing.JLabel;`
> 10. `import javax.swing.JPanel;`
> 11. `import javax.swing.JProgressBar;`
> 12. `public class JProgressBarDemo extends JFrame`
> 13. `{`
> 14. `//static JProgressBarDemo frame;`
> 15. `public JProgressBarDemo()`
> 16. `{`
> 17. `setTitle("使用进度条");`
> 18. `JLabel label=new JLabel("欢迎使用在线升级功能！");`
> 19. `//创建一个进度条`
> 20. `JProgressBar progressBar=new JProgressBar();`
> 21. `JButton button=new JButton("完成");`
> 22. `button.setEnabled(false);`
> 23. `Container container=getContentPane();`
> 24. `container.setLayout(new GridLayout(3,1));`
> 25. `JPanel panel1=new JPanel(new FlowLayout(FlowLayout.LEFT));`
> 26. `JPanel panel2=new JPanel(new FlowLayout(FlowLayout.CENTER));`
> 27. `JPanel panel3=new JPanel(new FlowLayout(FlowLayout.RIGHT));`
> 28. `panel1.add(label); //添加标签`
> 29. `panel2.add(progressBar); //添加进度条`
> 30. `panel3.add(button); //添加按钮`
> 31. `container.add(panel1);`
> 32. `container.add(panel2);`
> 33. `container.add(panel3);`
> 34. `progressBar.setStringPainted(true);`
> 35. `//如果不需要进度上显示“升级进行中...”，可注释此行`
> 36. `progressBar.setString("升级进行中...");`
> 37. `//如果需要使用不确定模式，可使用此行`
> 38. `//progressBar.setIndeterminate(true);`
> 39. `//开启一个线程处理进度`
> 40. `new Progress(progressBar, button).start();`
> 41. `//单机“完成”按钮结束程序`
> 42. `button.addActionListener(new ActionListener()`
> 43. `{`
> 44. `@Override`
> 45. `public void actionPerformed(ActionEvent e)`
> 46. `{`
> 47. `dispose();`
> 48. `System.exit(0);`
> 49. `}`
> 50. `});`
> 51. `}`
> 52. `/**`
> 53. `* @param args`
> 54. `*/`
> 55. `public static void main(String[] args)`
> 56. `{`
> 57. `// TODO Auto-generated method stub`
> 58. `JProgressBarDemo frame=new JProgressBarDemo();`
> 59. `//frame.setBounds(300,200,300,150); //设置容器的大小`
> 60. `frame.setVisible(true);`
> 61. `frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);`
> 62. `frame.pack();`
> 63. `}`
> 64. `}`

(3) 创建 Progress 线程并实现对进度条进度的控制，实现代码如下。

> 1.  `private class Progress extends Thread`
> 2.  `{`
> 3.  `JProgressBar progressBar;`
> 4.  `JButton button;`
> 5.  `//进度条上的数字`
> 6.  `int[] progressValues={6,18,27,39,51,66,81,100};`
> 7.  `Progress(JProgressBar progressBar,JButton button)`
> 8.  `{`
> 9.  `this.progressBar=progressBar;`
> 10. `this.button=button;`
> 11. `}`
> 12. `public void run()`
> 13. `{`
> 14. `for(int i=0;i<progressValues.length;i++)`
> 15. `{`
> 16. `try`
> 17. `{`
> 18. `Thread.sleep(3000);`
> 19. `}`
> 20. `catch(InterruptedException e)`
> 21. `{`
> 22. `e.printStackTrace();`
> 23. `}`
> 24. `//设置进度条的值`
> 25. `progressBar.setValue(progressValues[i]);`
> 26. `}`
> 27. `progressBar.setIndeterminate(false);`
> 28. `progressBar.setString("升级完成！");`
> 29. `button.setEnabled(true);`
> 30. `}`
> 31. `}`

上述代码定义了一个进度条的进度数组 progressValues。线程每隔 1000 毫秒从数组中取一个数字作为当前进度，并使用 JProgressBar 类的 setValue() 方法更新到进度条。最后使进度条显示“升级完成！”字符串，并使“完成”按钮可用。

图 1 为程序的运行效果。图 2 为调用 Setlndeterminate(true) 方法后进度条使用不确定模式的运行效果。图 3 为默认的数字进度条运行效果。

![0f7d15f0f2c69f082fdbe29fbd1e3bf7.gif][]

图1 进度条运行效果

![f9b7317a0e4e032297ee82502371d00d.gif][]

图2 不确定模式进度条效果

![e5c4eeb1907f7c79f7885082b91087c2.gif][]

图3 数字进度条运行效果

[0f7d15f0f2c69f082fdbe29fbd1e3bf7.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/d444b2b226084ada8003cc0ee2aa6b43.gif
[f9b7317a0e4e032297ee82502371d00d.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/9d3ec1f3386545ec916715acad298fe4.gif
[e5c4eeb1907f7c79f7885082b91087c2.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/cdf41e755758403c985dc501012dafa2.gif