|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||
java.lang.Object
|
+--java.awt.Component
|
+--java.awt.Container
|
+--javax.swing.JComponent
|
+--javax.swing.JProgressBar
デフォルトでは、ある区間内 (最小値、および最大値で区切られた区間内) で、整数値を表示するコンポーネントです。通常、進捗バーは、全体の何パーセントまでが終了したかを数値で示し、処理の進捗を伝えます。またテクスチャー表示を使用することも可能です。
不明な長さのタスクが実行されていることを示すには、進捗バーを不確定モードにすることができます。バーが不確定モードの間は、常に処理が行われていることが動画で表示されます。タスクの長さが判定されるとすぐに、進捗バーの値を更新して確定モードに戻します。
進捗バーの作成例を次に示します。task は処理の進捗についての情報を返すオブジェクトです。
progressBar = new JProgressBar(0, task.getLengthOfTask()); progressBar.setValue(0); progressBar.setStringPainted(true);進捗バーの値を更新する例です。
progressBar.setValue(task.getCurrent());進捗バーを不確定モードにし、タスクの長さが判明したら確定モードに戻す例です。
progressBar = new JProgressBar(); ...//when the task of (initially) unknown length begins: progressBar.setIndeterminate(true); ...//do some work; get length of task... progressBar.setMaximum(newLength); progressBar.setValue(newValue); progressBar.setIndeterminate(false);
詳細な例および解説については、「The Java Tutorial」のセクション「How to Monitor Progress」を参照してください。
警告:
このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。1.4 では、すべての JavaBeansTM の長期間の運用に対するサポートが java.beans パッケージに追加されました。XMLEncoder を参照してください。
BasicProgressBarUI| 入れ子クラスの概要 | |
protected class |
JProgressBar.AccessibleJProgressBar
このクラスは JProgressBar クラス用のユーザ補助機能のサポートを実装しています。 |
| クラス javax.swing.JComponent から継承した入れ子クラス |
|
| クラス java.awt.Container から継承した入れ子クラス |
|
| クラス java.awt.Component から継承した入れ子クラス |
Component.BltBufferStrategy, Component.FlipBufferStrategy |
| フィールドの概要 | |
protected ChangeEvent |
changeEvent
ChangeEvent は、インスタンスごとに 1 つだけ必要です。 |
protected ChangeListener |
changeListener
進捗バーのモデルから送られた変更イベントを待機し、この進捗バーに登録された変更イベントリスナーにふたたびディスパッチします。 |
protected BoundedRangeModel |
model
進捗バーの値を保持するオブジェクトです。 |
protected int |
orientation
進捗バーが水平であるか垂直であるかを示します。 |
protected boolean |
paintBorder
進捗バーの周囲にボーダを表示するかどうかを示します。 |
protected boolean |
paintString
進捗バーに文字列を表示するかどうかを設定します。 |
protected String |
progressString
進捗バーに表示できる任意指定の文字列です。 |
| クラス javax.swing.JComponent から継承したフィールド |
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW |
| クラス java.awt.Component から継承したフィールド |
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
| インタフェース javax.swing.SwingConstants から継承したフィールド |
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST |
| インタフェース java.awt.image.ImageObserver から継承したフィールド |
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
| コンストラクタの概要 | |
JProgressBar()
ボーダを表示し、進捗文字列を表示しない、水平方向の進捗バーを作成します。 |
|
JProgressBar(BoundedRangeModel newModel)
水平方向の進捗バーを作成します。 |
|
JProgressBar(int orient)
指定された方向を持つ進捗バーを作成します。 |
|
JProgressBar(int min,
int max)
水平方向の進捗バーを作成します。 |
|
JProgressBar(int orient,
int min,
int max)
進捗バーを作成します。 |
|
| メソッドの概要 | |
void |
addChangeListener(ChangeListener l)
指定された ChangeListener を進捗バーに追加します。 |
protected ChangeListener |
createChangeListener()
サブクラスが別の方法で変更イベントを処理する場合は、このメソッドをオーバーライドして独自の ChangeListener の実装のインスタンスを返すことができます。 |
protected void |
fireStateChanged()
ChangeEvent で登録したすべてのリスナーに通知します。 |
AccessibleContext |
getAccessibleContext()
この JProgressBar に関連した AccessibleContext を返します。 |
ChangeListener[] |
getChangeListeners()
この進捗バーに addChangeListener で追加されたすべての ChangeListener の配列を返します。 |
int |
getMaximum()
進捗バーの最大値を返します。 |
int |
getMinimum()
進捗バーの最小値を返します。 |
BoundedRangeModel |
getModel()
この進捗バーが使っているデータモデルを返します。 |
int |
getOrientation()
進捗バーの方向に応じて、 JProgressBar.VERTICAL または JProgressBar.HORIZONTAL を返します。 |
double |
getPercentComplete()
進捗バーの完了したパーセントを返します。 |
String |
getString()
進捗文字列の現在の値を返します。 |
ProgressBarUI |
getUI()
このコンポーネントを描画する Look & Feel オブジェクトを返します。 |
String |
getUIClassID()
このコンポーネントを描画する Look & Feel クラスの名前を返します。 |
int |
getValue()
進捗バーの現在の値を返します。 |
boolean |
isBorderPainted()
borderPainted プロパティを返します。 |
boolean |
isIndeterminate()
indeterminate プロパティの値を返します。 |
boolean |
isStringPainted()
stringPainted プロパティの値を返します。 |
protected void |
paintBorder(Graphics g)
borderPainted プロパティが true である場合に、進捗バーにボーダをペイントします。 |
protected String |
paramString()
この JProgressBar の文字列表現を返します。 |
void |
removeChangeListener(ChangeListener l)
進捗バーから ChangeListener を削除します。 |
void |
setBorderPainted(boolean b)
borderPainted プロパティを設定します。 |
void |
setIndeterminate(boolean newValue)
indeterminate プロパティの値を設定します。 |
void |
setMaximum(int n)
進捗バーの最大値 (進捗バーのデータモデルに格納) を n に設定します。 |
void |
setMinimum(int n)
進捗バーの最小値 (進捗バーのデータモデルに格納) を n に設定します。 |
void |
setModel(BoundedRangeModel newModel)
JProgressBar が使用するデータモデルを設定します。 |
void |
setOrientation(int newOrientation)
進捗バーの方向を newOrientation に従って設定します。 |
void |
setString(String s)
進捗文字列の値を設定します。 |
void |
setStringPainted(boolean b)
stringPainted プロパティの値を設定します。 |
void |
setUI(ProgressBarUI ui)
このコンポーネントを描画する Look & Feel オブジェクトを設定します。 |
void |
setValue(int n)
進捗バーの現在の値 (進捗バーのデータモデルに格納) を n に設定します。 |
void |
updateUI()
現在の Look & Feel からの値に UI プロパティをリセットします。 |
| クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| フィールドの詳細 |
protected int orientation
HORIZONTAL です。
setOrientation(int)protected boolean paintBorder
true です。
setBorderPainted(boolean)protected BoundedRangeModel model
setModel(javax.swing.BoundedRangeModel)protected String progressString
null です。null 以外の値に設定しても、必ずしも文字列が表示されるわけではありません。
setString(java.lang.String)protected boolean paintString
false です。true に設定すると、進捗状況のテキスト表示が進捗バーに描画されます。progressString が null の場合、完了した割合が進捗バーに表示されます。そうでない場合は、progressString が進捗バーに描画されます。
setStringPainted(boolean)protected transient ChangeEvent changeEvent
ChangeEvent は、インスタンスごとに 1 つだけ必要です。これは、このイベントの扱うプロパティのソースが、進捗バーのまま変わらないからです。
protected ChangeListener changeListener
createChangeListener()| コンストラクタの詳細 |
public JProgressBar()
setOrientation(int),
setBorderPainted(boolean),
setStringPainted(boolean),
setString(java.lang.String),
setIndeterminate(boolean)public JProgressBar(int orient)
JProgressBar.VERTICAL または JProgressBar.HORIZONTAL です。デフォルトでは、ボーダはペイントされ、進捗文字列はペイントされません。初期値および最小値は 0、最大値は 100 です。
orient - 進捗バーの目的の方向setOrientation(int),
setBorderPainted(boolean),
setStringPainted(boolean),
setString(java.lang.String),
setIndeterminate(boolean)
public JProgressBar(int min,
int max)
BoundedRangeModel がその問題を処理します。
min - 進捗バーの最小値max - 進捗バーの最大値BoundedRangeModel,
setOrientation(int),
setBorderPainted(boolean),
setStringPainted(boolean),
setString(java.lang.String),
setIndeterminate(boolean)
public JProgressBar(int orient,
int min,
int max)
BoundedRangeModel がその問題を処理します。
orient - 進捗バーの目的の方向min - 進捗バーの最小値max - 進捗バーの最大値BoundedRangeModel,
setOrientation(int),
setBorderPainted(boolean),
setStringPainted(boolean),
setString(java.lang.String),
setIndeterminate(boolean)public JProgressBar(BoundedRangeModel newModel)
newModel - 進捗バーのデータモデルsetOrientation(int),
setBorderPainted(boolean),
setStringPainted(boolean),
setString(java.lang.String),
setIndeterminate(boolean)| メソッドの詳細 |
public int getOrientation()
JProgressBar.VERTICAL または JProgressBar.HORIZONTAL を返します。デフォルトの方向は HORIZONTAL です。
HORIZONTAL または VERTICALsetOrientation(int)public void setOrientation(int newOrientation)
newOrientation に従って設定します。newOrientation は、JProgressBar.VERTICAL または JProgressBar.HORIZONTAL のどちらかです。デフォルトの方向は HORIZONTAL です。
newOrientation - HORIZONTAL または VERTICAL
IllegalArgumentException - newOrientation が不正な値の場合getOrientation()public boolean isStringPainted()
stringPainted プロパティの値を返します。
stringPainted プロパティの値setStringPainted(boolean),
setString(java.lang.String)public void setStringPainted(boolean b)
stringPainted プロパティの値を設定します。このプロパティは、進捗バーが進捗文字列を描画するかどうかを指定します。デフォルトでは false に設定され、文字列はペイントされません。進捗文字列をサポートしない、または進捗バーが不確定モードのときだけサポートする Look & Feel もあります。
b - 進捗バーに文字列を描画する場合は trueisStringPainted(),
setString(java.lang.String)public String getString()
super.getString よりも先に setString を呼び出さなければなりません。
setString(java.lang.String)public void setString(String s)
null に設定されます。独自の進捗文字列を指定したあとで、組み込みの動作に戻すには、文字列を null に設定し直します。 このメソッドをオーバーライドして独自の進捗文字列を指定する場合は、確実に getString よりも先に setString を呼び出すようにしなければなりません。進捗文字列は、isStringPainted が true を返す場合にだけペイントされます。
s - パーセント表示の文字列の値getString(),
setStringPainted(boolean),
isStringPainted()public double getPercentComplete()
public boolean isBorderPainted()
borderPainted プロパティを返します。
borderPainted プロパティの値setBorderPainted(boolean)public void setBorderPainted(boolean b)
borderPainted プロパティを設定します。進捗バーがボーダをペイントするようにするには true にする必要があります。このプロパティのデフォルト値は true です。ペイントされたボーダを実装していない Look & Feel もあり、その場合このプロパティは無視されます。
b - 進捗バーにボーダをペイントする場合は true、そうでない場合は falseisBorderPainted()protected void paintBorder(Graphics g)
borderPainted プロパティが true である場合に、進捗バーにボーダをペイントします。
JComponent 内の paintBorderg - ボーダをペイントする Graphics コンテキストJComponent.paint(java.awt.Graphics),
JComponent.setBorder(javax.swing.border.Border),
isBorderPainted(),
setBorderPainted(boolean)public ProgressBarUI getUI()
ProgressBarUI オブジェクトpublic void setUI(ProgressBarUI ui)
ui - ProgressBarUI オブジェクトUIDefaults.getUI(javax.swing.JComponent)public void updateUI()
JComponent 内の updateUIJComponent.updateUI()public String getUIClassID()
JComponent 内の getUIClassIDJComponent.getUIClassID(),
UIDefaults.getUI(javax.swing.JComponent)protected ChangeListener createChangeListener()
ChangeListener の実装のインスタンスを返すことができます。
changeListener,
ChangeListener,
BoundedRangeModelpublic void addChangeListener(ChangeListener l)
ChangeListener を進捗バーに追加します。
l - 追加する ChangeListenerpublic void removeChangeListener(ChangeListener l)
ChangeListener を削除します。
l - 削除する ChangeListenerpublic ChangeListener[] getChangeListeners()
addChangeListener で追加されたすべての ChangeListener の配列を返します。
ChangeListener。追加されたリスナーがない場合は空の配列protected void fireStateChanged()
ChangeEvent で登録したすべてのリスナーに通知します。イベントのインスタンスは必要に応じて生成されます。
EventListenerListpublic BoundedRangeModel getModel()
BoundedRangeModelBoundedRangeModelpublic void setModel(BoundedRangeModel newModel)
JProgressBar が使用するデータモデルを設定します。
newModel - 使用する BoundedRangeModelpublic int getValue()
BoundedRangeModel に格納されます。この値は常に、最小値以上、最大値以下の範囲に収まります。デフォルトでは、この値は初期化され、最小値と等しくなります。
setValue(int),
BoundedRangeModel.getValue()public int getMinimum()
BoundedRangeModel に格納されます。デフォルトでは、最小値は 0 です。
setMinimum(int),
BoundedRangeModel.getMinimum()public int getMaximum()
BoundedRangeModel に格納されます。デフォルトでは、最大値は 100 です。
setMaximum(int),
BoundedRangeModel.getMaximum()public void setValue(int n)
n に設定します。不適切な値を割り当てたことにより発生する数学的な問題は、データモデル (BoundedRangeModel インスタンス) が処理します。
新しい値が以前の値と異なる場合は、すべての変更リスナーが通知されます。
n - 新しい値getValue(),
BoundedRangeModel.setValue(int)public void setMinimum(int n)
n に設定します。不適切な値を割り当てたことにより発生する数学的な問題は、データモデル (BoundedRangeModel インスタンス) が処理します。
最小値が以前の最小値と異なる場合は、すべての変更リスナーが通知されます。
n - 新しい最小値getMinimum(),
addChangeListener(javax.swing.event.ChangeListener),
BoundedRangeModel.setMinimum(int)public void setMaximum(int n)
n に設定します。不適切な値を割り当てたことにより発生する数学的な問題は、基本となる BoundedRangeModel が処理します。
最大値が以前の最大値と異なる場合は、すべての変更リスナーが通知されます。
n - 新しい最大値getMaximum(),
addChangeListener(javax.swing.event.ChangeListener),
BoundedRangeModel.setMaximum(int)public void setIndeterminate(boolean newValue)
indeterminate プロパティの値を設定します。このプロパティは、進捗バーが確定モードであるか不確定モードであるかを指定します。デフォルトでは、進捗バーは確定モードで、このメソッドは false を返します。不確定モードの進捗バーは連続的にアニメーションを表示して、不明な長さの処理が行われていることを示します。デフォルトでは、このプロパティは false に設定されます。不確定モードの進捗バーをサポートしない Look & Feel もあり、その場合このプロパティは無視されます。
不確定モードの進捗バーの使用例については、「How to Monitor Progress」を参照してください。
newValue - 進捗バーが不確定モードに変更される場合は true、通常のモードに戻る場合は falseisIndeterminate(),
BasicProgressBarUIpublic boolean isIndeterminate()
indeterminate プロパティの値を返します。
indeterminate プロパティの値setIndeterminate(boolean)protected String paramString()
JProgressBar の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。
JComponent 内の paramStringJProgressBar の文字列表現public AccessibleContext getAccessibleContext()
JProgressBar に関連した AccessibleContext を返します。進捗バーの場合、AccessibleContext は AccessibleJProgressBar の形式を取ります。必要に応じて新規の AccessibleJProgressBar インスタンスが作成されます。
Accessible 内の getAccessibleContextJComponent 内の getAccessibleContextJProgressBar の AccessibleContext として機能する AccessibleJProgressBar
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||
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.