javax.swing
類別 ProgressMonitor

java.lang.Object
  javax.swing.ProgressMonitor

所有已實作的介面：

Accessible

public class ProgressMonitor
extends Object
implements Accessible

監視某個操作的進度的類別。如果表現為操作需要一段時間，則會彈出進度對話框。創建 ProgressMonitor 時，向它提供數字範圍和描述字元串。在操作進行時，調用 setProgress 方法，以指示操作的 [min,max] 範圍有多大。最初，不存在 ProgressDialog。第一個 millisToDecideToPopup 毫秒（預設值為 500）以後，進度監視器會預測該操作將花費多長時間。如果大於 millisToPopup（預設值為 2000，即 2 秒），則彈出 ProgressDialog。

當可以看到 Dialog 框時，調用 setProgress 可以更新進度條。setProgress 並不總是更新該進度條，僅當進度量明顯增多時才進行更新。

有關此內容的更多文檔和範例，請參閱 The Java Tutorial 中的 How to Monitor Progress 一節。

另請參見：

ProgressMonitorInputStream

巢狀類別摘要

protected class

ProgressMonitor.AccessibleProgressMonitor AccessibleProgressMonitor 實作 ProgressMonitor 類別的可存取性支持。

欄位摘要

protected AccessibleContext

accessibleContext ProgressMonitor 的 AccessibleContext

建構子摘要

ProgressMonitor(Component parentComponent, Object message, String note, int min, int max)
建構一個圖形物件，它一般會根據進程的完成情況通過填充矩形條來顯示進度。

方法摘要

void	close() 指示操作已完成。
AccessibleContext	getAccessibleContext() 獲得 ProgressMonitor 的 AccessibleContext。
int	getMaximum() 返回最大值 - 進度值的較高端。
int	getMillisToDecideToPopup() 返回在確定是否彈出進度監視器之前此物件等待的時間量。
int	getMillisToPopup() 返回顯示彈出監視器花費的時間量。
int	getMinimum() 返回最小值 - 進度值的較低端。
String	getNote() 指定隨進度訊息一起顯示的其他註釋。
boolean	isCanceled() 如果使用者單擊進度對話框中的 Cancel 按鈕，則返回 true。
void	setMaximum(int m) 指定最大值。
void	setMillisToDecideToPopup(int millisToDecideToPopup) 指定在確定是否彈出進度監視器之前要等待的時間量。
void	setMillisToPopup(int millisToPopup) 指定顯示彈出監視器花費的時間量。
void	setMinimum(int m) 指定最小值。
void	setNote(String note) 指定與進度訊息一起顯示的其他註釋。
void	setProgress(int nv) 指示正被監視操作的進度。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

欄位詳細資訊

accessibleContext

protected AccessibleContext accessibleContext

ProgressMonitor 的 AccessibleContext

從以下版本開始：

1.5

建構子詳細資訊

ProgressMonitor

public ProgressMonitor(Component parentComponent,
                       Object message,
                       String note,
                       int min,
                       int max)

建構一個圖形物件，它一般會根據進程的完成情況通過填充矩形條來顯示進度。

參數：

parentComponent - 對話框的父元件

message - 要顯示給使用者的描述訊息，以指示在監視什麼操作。這不隨操作進度而更改。請參閱 JOptionPane.message 中方法的 message 參數，瞭解值的範圍。

note - 描述操作狀態的簡短註釋。隨著操作的進行，可以調用 setNote 來更改顯示的註釋。例如，這可用於迭代檔案列表以顯示正在處理的檔案名稱的操作中。如果註釋最初為 null，則對話框中將不存在註釋行，並且 setNote 無效

min - 範圍的下邊界

max - 範圍的上邊界

另請參見：

JDialog, JOptionPane

方法詳細資訊

setProgress

public void setProgress(int nv)

指示正被監視操作的進度。如果指定值 >= 最大值，則關閉進度監視器。

參數：

nv - 指定當前值的 int，位於為此元件指定的最大值和最小值之間

另請參見：

setMinimum(int), setMaximum(int), close()

close

public void close()

指示操作已完成。當 setProgress 設置的值 >= 最大值時，此過程自動發生，但是如果提前結束該操作，則可以提前調用它。

getMinimum

public int getMinimum()

返回最小值 - 進度值的較低端。

返回：

表示最小值的 int

另請參見：

setMinimum(int)

setMinimum

public void setMinimum(int m)

指定最小值。

參數：

m - 指定最小值的 int

另請參見：

getMinimum()

getMaximum

public int getMaximum()

返回最大值 - 進度值的較高端。

返回：

表示最大值的 int

另請參見：

setMaximum(int)

setMaximum

public void setMaximum(int m)

指定最大值。

參數：

m - 指定最大值的 int

另請參見：

getMaximum()

isCanceled

public boolean isCanceled()

如果使用者單擊進度對話框中的 Cancel 按鈕，則返回 true。

setMillisToDecideToPopup

public void setMillisToDecideToPopup(int millisToDecideToPopup)

指定在確定是否彈出進度監視器之前要等待的時間量。

參數：

millisToDecideToPopup - 指定要等待的時間（以毫秒為單位）的 int

另請參見：

getMillisToDecideToPopup()

getMillisToDecideToPopup

public int getMillisToDecideToPopup()

返回在確定是否彈出進度監視器之前此物件等待的時間量。

另請參見：

setMillisToDecideToPopup(int)

setMillisToPopup

public void setMillisToPopup(int millisToPopup)

指定顯示彈出監視器花費的時間量。（如果剩餘的預計時間小於此時間，則不顯示彈出監視器。）

參數：

millisToPopup - 指定時間（以毫秒為單位）的 int

另請參見：

getMillisToPopup()

getMillisToPopup

public int getMillisToPopup()

返回顯示彈出監視器花費的時間量。

另請參見：

setMillisToPopup(int)

setNote

public void setNote(String note)

指定與進度訊息一起顯示的其他註釋。例如，在複製多個檔案的過程中，用於顯示當前正在複製哪一個檔案。

參數：

note - 指定要顯示的註釋的 String

另請參見：

getNote()

getNote

public String getNote()

指定隨進度訊息一起顯示的其他註釋。

返回：

指定要顯示的註釋的 String

另請參見：

setNote(java.lang.String)

getAccessibleContext

public AccessibleContext getAccessibleContext()

獲得 ProgressMonitor 的 AccessibleContext。

指定者：

介面 Accessible 中的 getAccessibleContext

返回：

ProgressMonitor 的 AccessibleContext

從以下版本開始：

1.5