|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.awt.Component java.awt.Container javax.swing.JComponent javax.swing.JProgressBar
public class 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 に適しています。JDK バージョン 1.4 以降は、java.beans
パッケージですべての JavaBeans™ の長期記憶がサポートされます。XMLEncoder
を参照してください。
BasicProgressBarUI
入れ子のクラスの概要 | |
---|---|
protected class |
JProgressBar.AccessibleJProgressBar
このクラスは JProgressBar クラス用のユーザ補助機能のサポートを実装しています。 |
クラス javax.swing.JComponent から継承された入れ子のクラス/インタフェース |
---|
JComponent.AccessibleJComponent |
クラス java.awt.Container から継承された入れ子のクラス/インタフェース |
---|
Container.AccessibleAWTContainer |
クラス java.awt.Component から継承された入れ子のクラス/インタフェース |
---|
Component.AccessibleAWTComponent, 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
または VERTICAL
setOrientation(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
- 進捗バーに文字列を描画する場合は true
isStringPainted()
,
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
、そうでない場合は false
isBorderPainted()
protected void paintBorder(Graphics g)
borderPainted
プロパティが true
である場合に、進捗バーにボーダをペイントします。
JComponent
内の paintBorder
g
- ボーダをペイントする 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
内の updateUI
JComponent.updateUI()
public String getUIClassID()
JComponent
内の getUIClassID
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
protected ChangeListener createChangeListener()
ChangeListener
の実装のインスタンスを返すことができます。
changeListener
,
ChangeListener
,
BoundedRangeModel
public void addChangeListener(ChangeListener l)
ChangeListener
を進捗バーに追加します。
l
- 追加する ChangeListener
public void removeChangeListener(ChangeListener l)
ChangeListener
を削除します。
l
- 削除する ChangeListener
public ChangeListener[] getChangeListeners()
addChangeListener
で追加されたすべての ChangeListener
の配列を返します。
ChangeListener
、またはリスナーが追加されていない場合は空の配列protected void fireStateChanged()
ChangeEvent
で登録したすべてのリスナーに通知します。イベントのインスタンスは必要に応じて生成されます。
EventListenerList
public BoundedRangeModel getModel()
BoundedRangeModel
BoundedRangeModel
public void setModel(BoundedRangeModel newModel)
JProgressBar
が使用するデータモデルを設定します。
newModel
- 使用する BoundedRangeModel
public 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
に設定されます。不確定モードの進捗バーをサポートしない Look & Feel もあり、その場合このプロパティは無視されます。
不確定モードの進捗バーの使用例については、「How to Monitor Progress」を参照してください。
newValue
- 進捗バーが不確定モードに変更される場合は true
、通常のモードに戻る場合は false
isIndeterminate()
,
BasicProgressBarUI
public boolean isIndeterminate()
indeterminate
プロパティの値を返します。
indeterminate
プロパティの値setIndeterminate(boolean)
protected String paramString()
JProgressBar
の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null
にはなりません。
JComponent
内の paramString
JProgressBar
の文字列表現public AccessibleContext getAccessibleContext()
JProgressBar
に関連した AccessibleContext
を返します。進捗バーの場合、AccessibleContext
は AccessibleJProgressBar
の形式を取ります。必要に応じて新規の AccessibleJProgressBar
インスタンスが作成されます。
Accessible
内の getAccessibleContext
JComponent
内の getAccessibleContext
JProgressBar
の AccessibleContext
として機能する AccessibleJProgressBar
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。