12.7Swing控件5 JProgressBar

news2025/6/9 15:15:33

Swing 进度条（JProgressBar）是用于可视化展示任务完成进度的组件，通常用于显示长时间运行任务的完成百分比。以下是关于 Swing 进度条的详细介绍：

1. 基本概念与用途

作用：直观展示任务完成进度，避免用户在等待时感到焦虑。
常见场景：文件下载、数据导入、批量处理等耗时操作。

2. 核心类与方法

Swing 进度条的核心类是 JProgressBar，它继承自 JComponent，主要方法包括：

构造方法：

JProgressBar()                          // 创建默认进度条（0-100）
JProgressBar(int min, int max)         // 指定最小值和最大值
JProgressBar(int orientation, int min, int max)  // 指定方向（HORIZONTAL 或 VERTICAL）

进度控制：

setValue(int n)      // 设置当前进度值
getValue()           // 获取当前进度值
setMinimum(int min)  // 设置最小值
setMaximum(int max)  // 设置最大值
setIndeterminate(boolean b)  // 设置为不确定模式（任务时长未知时使用）

外观设置：

setString(String s)       // 设置进度条上的文本
setStringPainted(boolean b)  // 是否显示文本
setForeground(Color c)    // 设置进度条颜色
setBackground(Color c)    // 设置背景色

主要属性和方法

setValue(int n)：设置当前进度值。
setMinimum(int min) 和 setMaximum(int max)：设置进度条的最小值和最大值。
setStringPainted(boolean b)：如果为 true，则会在进度条上显示当前进度值作为文本。
setOrientation(int orientation)：改变进度条的方向，可以是 JProgressBar.HORIZONTAL 或 JProgressBar.VERTICAL。

3. 简单示例：文件下载进度条

下面是一个模拟文件下载进度的示例代码：

import javax.swing.*;
import java.awt.*;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

public class ProgressBarExample {
    public static void main(String[] args) {
        // 创建 JFrame
        JFrame frame = new JFrame("文件下载进度");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(400, 200);
        frame.setLocationRelativeTo(null);

        // 创建进度条（最小值0，最大值100）
        JProgressBar progressBar = new JProgressBar(0, 100);
        progressBar.setStringPainted(true);  // 显示进度百分比文本
        progressBar.setPreferredSize(new Dimension(300, 30));

        // 创建开始按钮
        JButton startButton = new JButton("开始下载");
        startButton.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                // 禁用按钮，防止重复点击
                startButton.setEnabled(false);
                
                // 创建并启动后台任务
                SwingWorker<Void, Void> worker = new SwingWorker<Void, Void>() {
                    @Override
                    protected Void doInBackground() throws Exception {
                        // 模拟下载进度（0-100）
                        for (int i = 0; i <= 100; i++) {
                            // 更新进度条
                            progressBar.setValue(i);
                            
                            // 模拟耗时操作
                            Thread.sleep(100);
                        }
                        return null;
                    }
                    
                    @Override
                    protected void done() {
                        // 任务完成后恢复按钮状态
                        startButton.setEnabled(true);
                        progressBar.setString("下载完成！");
                    }
                };
                
                worker.execute();  // 执行后台任务
            }
        });

        // 添加组件到面板
        JPanel panel = new JPanel();
        panel.setLayout(new FlowLayout(FlowLayout.CENTER, 20, 50));
        panel.add(progressBar);
        panel.add(startButton);

        frame.add(panel);
        frame.setVisible(true);
    }
}

4. 不确定模式（Indeterminate Mode）

当任务时长无法预估时，可以使用不确定模式：

// 创建不确定模式的进度条
JProgressBar indeterminateBar = new JProgressBar();
indeterminateBar.setIndeterminate(true);  // 开启不确定模式
indeterminateBar.setString("加载中...");
indeterminateBar.setStringPainted(true);

不确定模式下，进度条会显示一个平滑移动的动画，提示用户 “任务正在进行中”。

5. 自定义外观

可以通过以下方式自定义进度条的外观：

// 设置进度条颜色
progressBar.setForeground(Color.GREEN);  // 进度条颜色
progressBar.setBackground(Color.LIGHT_GRAY);  // 背景色

// 设置字体和文本
progressBar.setFont(new Font("Arial", Font.BOLD, 12));
progressBar.setString("处理中: " + progressBar.getValue() + "%");

// 设置垂直进度条
JProgressBar verticalBar = new JProgressBar(JProgressBar.VERTICAL, 0, 100);