Swing JProgressBar類

JProgressBar類是一個可視地顯示某個任務進度的元件。

類宣告

以下是javax.swing.JProgressBar類的宣告 -

public class JProgressBar
   extends JComponent
      implements SwingConstants, Accessible

欄位

以下是javax.swing.JProgressBar類的欄位 -

• protected ChangeEvent changeEvent - 每個範例只需要一個ChangeEvent，因為事件唯一有趣的屬性是不可變源，即進度條。
• protected ChangeListener changeListener - 偵聽進度條模型傳送的更改事件，將它們重新分配給在此進度條上註冊的更改事件偵聽器。
• protected BoundedRangeModel model - 儲存進度條資料的物件。
• protected int orientation - 進度條是水平還是垂直。
• protected boolean paintBorder - 是否在進度條周圍顯示邊框。
• protected boolean paintString - 是否在進度條上顯示文字字串。
• protected String progressString - 可以在進度條上顯示的可選字串。

類建構函式

類方法

方法繼承

該類繼承以下類中的方法 -

• javax.swing.JComponent
• java.awt.Container
• java.awt.Component
• java.lang.Object

JProgressBar範例

使用編輯器建立以下Java程式 -

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

public class JProgressBarExample {
    private JFrame mainFrame;
    private JLabel headerLabel;
    private JLabel statusLabel;
    private JPanel controlPanel;

    public JProgressBarExample() {
        prepareGUI();
    }

    public static void main(String[] args) {
        JProgressBarExample swingControlDemo = new JProgressBarExample();
        swingControlDemo.showProgressBarDemo();
    }

    private void prepareGUI() {
        mainFrame = new JFrame("Java Swing JProgressBar範例(tw511.com)");
        mainFrame.setSize(400, 400);
        mainFrame.setLayout(new GridLayout(3, 1));

        mainFrame.addWindowListener(new WindowAdapter() {
            public void windowClosing(WindowEvent windowEvent) {
                System.exit(0);
            }
        });
        headerLabel = new JLabel("", JLabel.CENTER);
        statusLabel = new JLabel("", JLabel.CENTER);
        statusLabel.setSize(350, 100);

        controlPanel = new JPanel();
        controlPanel.setLayout(new FlowLayout());

        mainFrame.add(headerLabel);
        mainFrame.add(controlPanel);
        mainFrame.add(statusLabel);
        mainFrame.setVisible(true);
    }

    private JProgressBar progressBar;
    private Task task;
    private JButton startButton;
    private JTextArea outputTextArea;

    private void showProgressBarDemo() {
        headerLabel.setText("Control in action: JProgressBar");
        progressBar = new JProgressBar(0, 100);
        progressBar.setValue(0);
        progressBar.setStringPainted(true);
        startButton = new JButton("開始...");
        outputTextArea = new JTextArea("", 5, 20);
        JScrollPane scrollPane = new JScrollPane(outputTextArea);

        startButton.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                task = new Task();
                task.start();
            }
        });
        controlPanel.add(startButton);
        controlPanel.add(progressBar);
        controlPanel.add(scrollPane);
        mainFrame.setVisible(true);
    }

    private class Task extends Thread {
        public Task() {
        }

        public void run() {
            for (int i = 0; i <= 100; i += 10) {
                final int progress = i;

                SwingUtilities.invokeLater(new Runnable() {
                    public void run() {
                        progressBar.setValue(progress);
                        outputTextArea.setText(
                                outputTextArea.getText() + String.format("任務已完成：%d%% \n", progress));
                    }
                });
                try {
                    Thread.sleep(100);
                } catch (InterruptedException e) {
                }
            }
        }
    }
}

執行上面範例程式碼，得到以下結果：