JavaTM 2
Platform
Std. Ed. v1.4.0

javax.swing
クラス ProgressMonitor

java.lang.Object
  |
  +--javax.swing.ProgressMonitor

public class ProgressMonitor
extends Object

処理の進捗を監視するクラスです。処理にしばらく時間がかかる場合には、進捗ダイアログが表示されます。作成された ProgressMonitor には、数値範囲と説明的な文字列が与えられます。処理が進むと、setProgress メソッドを呼び出して、[min,max] の範囲でどのくらい処理が進んでいるかを示します。初期状態では、ProgressDialog はありません。最初の millisToDecideToPopup ミリ秒 (デフォルトは 500) が経過してから、進捗モニターで処理にかかる時間が予測されます。その時間が millisToPopup (デフォルトは 2000, 2 秒) より長い場合は、ProgressDialog が表示されます。

ダイアログボックスが可視である場合は、setProgress が呼び出されたときに進捗バーが更新されることがあります。setProgress は、常に進捗バーを更新するわけではなく、操作が非常に進んでいる場合にだけ更新します。

例および詳細は、「The Java Tutorial」の「How to Monitor Progress」を参照してください。

関連項目:
ProgressMonitorInputStream

コンストラクタの概要
ProgressMonitor(Component parentComponent, Object message, String note, int min, int max)
          進捗状況を示すグラフィックオブジェクトを構築します。
 
メソッドの概要
 void close()
          処理が完了したことを示します。
 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
 

コンストラクタの詳細

ProgressMonitor

public ProgressMonitor(Component parentComponent,
                       Object message,
                       String note,
                       int min,
                       int max)
進捗状況を示すグラフィックオブジェクトを構築します。進捗状況は、通常、処理が完了に近づくにつれて矩形のバーを埋めていくことで示します。

パラメータ:
parentComponent - ダイアログボックスの親コンポーネント
message - 監視している処理をユーザに示すために表示される説明的なメッセージ。これは、処理が進んでも変更されない。値の範囲については、JOptionPane.message のメソッドのメッセージパラメータを参照
note - 処理の状態を説明する短い注。処理が進むと、setNote を呼び出して、表示されている注を変更できる。たとえば、ファイルのリストを繰り返し処理する操作で、処理中のファイル名を表示する場合などに、この注を使用する。初期状態で note が null の場合、ダイアログボックスに注の行はなく、setNote は無効である
min - 範囲の下限
max - 範囲の上限
関連項目:
JDialog, JOptionPane
メソッドの詳細

setProgress

public void setProgress(int nv)
監視している処理の進捗状況を示します。指定された値が最大値以上の場合、進捗モニターは閉じます。

パラメータ:
nv - 現在の値を示す int 値。このコンポーネントに指定された最大値と最小値の範囲内
関連項目:
setMinimum(int), setMaximum(int), close()

close

public void close()
処理が完了したことを示します。これは、setProgress で設定した値が >= max の場合に自動的に発生しますが、処理が早く終了した場合は、それより早く呼び出されることもあります。


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)

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.