javax.swing
クラス JProgressBar

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.JProgressBar

すべての実装インタフェース:

Accessible, ImageObserver, MenuContainer, Serializable, SwingConstants

public class JProgressBar

extends JComponent

implements SwingConstants, Accessible

ある区間内 (最小値、および最大値で区切られた区間内) で、整数値を表示するコンポーネントです。通常、進捗バーは、全体の何パーセントまでが終了したかを数値で示し、イベントとして伝えます。またテクスチャー表示を使用することも可能です。

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

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:

直列化された形式

内部クラスの概要

protected class

JProgressBar.AccessibleJProgressBar このクラスは JProgressBar クラス用のユーザ補助機能のサポートを実装しています。

クラス javax.swing.JComponent から継承した内部クラス

JComponent.AccessibleJComponent

クラス java.awt.Container から継承した内部クラス

Container.AccessibleAWTContainer

クラス java.awt.Component から継承した内部クラス

Component.AccessibleAWTComponent

フィールドの概要

protected ChangeEvent	changeEvent ChangeEvent は、インスタンスごとに 1 つだけ必要です。
protected ChangeListener	changeListener
protected BoundedRangeModel	model 進捗バーのさまざまな値を保持するデータ構造体です。
protected int	orientation 進捗バーを表示する方向です。
protected boolean	paintBorder 進捗バーの周囲に境界線を表示するかどうかを示します。
protected boolean	paintString 進捗バーに String を表示するかどうかを設定します。
protected String	progressString 進捗バーに表示できる任意指定の String です。

クラス 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, NORTH, NORTH_EAST, NORTH_WEST, 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.VERTICAL または JProgressBar.HORIZONTAL) の進捗バーを作成します。

JProgressBar(int min, int max)
水平方向 (デフォルト) の進捗バーを作成します。

JProgressBar(int orient, int min, int max)
進捗バーを作成します。

メソッドの概要

void	addChangeListener(ChangeListener l) ボタンに ChangeListener を追加します。
protected ChangeListener	createChangeListener()
protected void	fireStateChanged() このイベントタイプの通知を受けるように登録されたすべてのリスナーに通知します。
AccessibleContext	getAccessibleContext() この JProgressBar に関連した AccessibleContext を返します。
int	getMaximum() モデルの最大値を返します。
int	getMinimum() モデルの最小値を返します。
BoundedRangeModel	getModel() JProgressBar が使っているデータモデルを返します。
int	getOrientation() 進捗バーの方向に応じて、JProgressBar.VERTICAL または JProgressBar.HORIZONTAL を返します。
double	getPercentComplete() 進捗バーの完了したパーセントを返します。
String	getString() 進捗文字列の現在の値を返します。
ProgressBarUI	getUI() このコンポーネントを描画する L&F オブジェクトを返します。
String	getUIClassID() このコンポーネントを描画する L&F クラスの名前を返します。
int	getValue() モデルの現在の値を返します。
boolean	isBorderPainted() 進捗バーに境界線がある場合に true、そうでない場合に false を返します。
boolean	isStringPainted() 進捗バーの表示に文字列が描画される場合に true を返します。
protected void	paintBorder(Graphics g) BorderPainted プロパティが true である場合に、進捗バーに境界線をペイントします。
protected String	paramString() この JProgressBar の文字列表現を返します。
void	removeChangeListener(ChangeListener l) ボタンから ChangeListener を削除します。
void	setBorderPainted(boolean b) 進捗バーに境界線をペイントするかどうかを設定します。
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) 進捗バーに文字列を描画するかどうかを設定します。
void	setUI(ProgressBarUI ui) このコンポーネントを描画する L&F オブジェクトを設定します。
void	setValue(int n) モデルの現在の値を n に設定します。
void	updateUI() L&F が変更されたことを示す UIFactory からの通知です。

クラス javax.swing.JComponent から継承したメソッド

addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getVerifyInputWhenFocusTarget, getVisibleRect, getWidth, getX, getY, grabFocus, hasFocus, hide, isDoubleBuffered, isFocusCycleRoot, isFocusTraversable, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processFocusEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDoubleBuffered, setEnabled, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

クラス java.awt.Container から継承したメソッド

add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getLayout, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree

クラス java.awt.Component から継承したメソッド

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, imageUpdate, inside, isDisplayable, isEnabled, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus

クラス java.lang.Object から継承したメソッド

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

フィールドの詳細

orientation

protected int orientation

進捗バーを表示する方向です。デフォルトは HORIZONTAL です。

paintBorder

protected boolean paintBorder

進捗バーの周囲に境界線を表示するかどうかを示します。デフォルトは true です。

model

protected BoundedRangeModel model

進捗バーのさまざまな値を保持するデータ構造体です。

progressString

protected String progressString

進捗バーに表示できる任意指定の String です。デフォルトは null です。null 以外の値に設定しても、必ずしも String が表示されるわけではありません。

paintString

protected boolean paintString

進捗バーに String を表示するかどうかを設定します。デフォルトは false です。true に設定すると、進捗状況のテキスト表示が進捗バーに描画されます。progressString が null の場合、進捗の割合が進捗バーに表示されます。progressString が null でない場合、進捗状況が進捗バーに描画されます。

changeEvent

protected transient ChangeEvent changeEvent

ChangeEvent は、インスタンスごとに 1 つだけ必要です。これは、このイベントの扱うプロパティのソースが、進捗バーのまま変わらないからです。

changeListener

protected ChangeListener changeListener

コンストラクタの詳細

JProgressBar

public JProgressBar()

水平方向の進捗バーを作成します。進捗バーのデフォルトの方向は JProgressBar.HORIZONTAL です。デフォルトでは、String は null に設定され、StringPainted はペイントされません。境界線はデフォルトでペイントされます。defaultMinimum (0) および defaultMaximum (100) を使います。defaultMinimum を進捗バーの初期値に使います。

JProgressBar

public JProgressBar(int orient)

指定された方向 (JProgressBar.VERTICAL または JProgressBar.HORIZONTAL) の進捗バーを作成します。デフォルトでは、String は null に設定され、StringPainted はペイントされません。境界線はデフォルトでペイントされます。defaultMinimum (0) および defaultMaximum (100) を使います。defaultMinimum を進捗バーの初期値に使います。

JProgressBar

public JProgressBar(int min,
                    int max)

水平方向 (デフォルト) の進捗バーを作成します。デフォルトでは、String は null に設定され、StringPainted はペイントされません。境界線はデフォルトでペイントされます。指定された最小値および最大値を使います。指定された最小値を進捗バーの初期値に使います。

JProgressBar

public JProgressBar(int orient,
                    int min,
                    int max)

進捗バーを作成します。指定された方向、最小値、および最大値を使います。デフォルトでは、String は null に設定され、StringPainted はペイントされません。境界線はデフォルトでペイントされます。進捗バーの初期値を、指定された最小値に設定します。進捗バーの最小値、値、および最大値として設定された値が適切でないために問題が発生した場合は、進捗バーの背後にある BoundedRangeModel がその問題を処理します。

関連項目:

BoundedRangeModel, setOrientation(int), setBorderPainted(boolean), setStringPainted(boolean), setString(java.lang.String)

JProgressBar

public JProgressBar(BoundedRangeModel newModel)

水平方向 (デフォルト) の進捗バーを作成します。デフォルトでは、String は null に設定され、StringPainted はペイントされません。境界線はデフォルトでペイントされます。最小値、値、および最大値を保持している、指定された BoundedRangeModel を使います。

関連項目:

BoundedRangeModel, setOrientation(int), setBorderPainted(boolean), setStringPainted(boolean), setString(java.lang.String)

メソッドの詳細

getOrientation

public int getOrientation()

進捗バーの方向に応じて、JProgressBar.VERTICAL または JProgressBar.HORIZONTAL を返します。デフォルトの方向は HORIZONTAL です。

戻り値:

HORIZONTAL または VERTICAL

関連項目:

setOrientation(int)

setOrientation

public void setOrientation(int newOrientation)

進捗バーの方向を newOrientation に従って設定します。newOrientation は、JProgressBar.VERTICAL または JProgressBar.HORIZONTAL のどちらかです。デフォルトの方向は HORIZONTAL です。

パラメータ:

newOrientation - HORIZONTAL または VERTICAL

例外:

IllegalArgumentException - newOrientation が不正な値の場合

関連項目:

getOrientation()

isStringPainted

public boolean isStringPainted()

進捗バーの表示に文字列が描画される場合に true を返します。描画されない場合は false を返します。デフォルトは false です。つまり、デフォルトでは、進捗バーに文字列は描画されません。

戻り値:

進捗バーに文字列を描画するかどうか

関連項目:

setStringPainted(boolean), setString(java.lang.String)

setStringPainted

public void setStringPainted(boolean b)

進捗バーに文字列を描画するかどうかを設定します。

パラメータ:

b - 進捗バーに文字列を描画する場合は true

関連項目:

isStringPainted()

getString

public String getString()

進捗文字列の現在の値を返します。このメソッドで独自の進捗文字列を提供する場合は、getString() よりも先に setString() を呼び出さなければなりません。

戻り値:

パーセント表示の文字列の値

関連項目:

setString(java.lang.String)

setString

public void setString(String s)

進捗文字列の値を設定します。デフォルトでは、この String は null に設定されます。このメソッドで独自の進捗文字列を指定する場合は、確実に getString() よりも先に setString() を呼び出すようにしなければなりません。独自の文字列を指定したあとで、組み込みの動作に戻すには、文字列を null に設定し直します。

パラメータ:

s - パーセント表示の文字列の値

関連項目:

getString()

getPercentComplete

public double getPercentComplete()

進捗バーの完了したパーセントを返します。値は倍精度で、0.00 〜 1.00 の範囲であることに注意してください。

戻り値:

進捗バーの完了したパーセント

isBorderPainted

public boolean isBorderPainted()

進捗バーに境界線がある場合に true、そうでない場合に false を返します。デフォルトは true であり、進捗バーに境界線がペイントされます。

戻り値:

進捗バーに境界線をペイントするかどうか

関連項目:

setBorderPainted(boolean)

setBorderPainted

public void setBorderPainted(boolean b)

進捗バーに境界線をペイントするかどうかを設定します。デフォルトは true であり、境界線をペイントします。

パラメータ:

b - 進捗バーに境界線をペイントする場合は true

関連項目:

isBorderPainted()

paintBorder

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)

getUI

public ProgressBarUI getUI()

このコンポーネントを描画する L&F オブジェクトを返します。

戻り値:

このコンポーネントを描画する ProgressBarUI オブジェクト

setUI

public void setUI(ProgressBarUI ui)

このコンポーネントを描画する L&F オブジェクトを設定します。

パラメータ:

ui - ProgressBarUI の L&F オブジェクト

関連項目:

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

L&F が変更されたことを示す UIFactory からの通知です。UI をデフォルトの UIFactory からの最新バージョンに置き換えるために呼び出されます。

オーバーライド:

クラス JComponent 内の updateUI

関連項目:

JComponent.updateUI()

getUIClassID

public String getUIClassID()

このコンポーネントを描画する L&F クラスの名前を返します。

オーバーライド:

クラス JComponent 内の getUIClassID

戻り値:

"ProgressBarUI"

関連項目:

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

createChangeListener

protected ChangeListener createChangeListener()

addChangeListener

public void addChangeListener(ChangeListener l)

ボタンに ChangeListener を追加します。

パラメータ:

l - 追加する ChangeListener

removeChangeListener

public void removeChangeListener(ChangeListener l)

ボタンから ChangeListener を削除します。

パラメータ:

l - 削除する ChangeListener

fireStateChanged

protected void fireStateChanged()

このイベントタイプの通知を受けるように登録されたすべてのリスナーに通知します。イベントのインスタンスは、このトリガーメソッドに渡されたパラメータを使用して遅れて作成されます。

関連項目:

EventListenerList

getModel

public BoundedRangeModel getModel()

JProgressBar が使っているデータモデルを返します。

戻り値:

現在使用している BoundedRangeModel

関連項目:

BoundedRangeModel

setModel

public void setModel(BoundedRangeModel newModel)

JProgressBar が使用するデータモデルを設定します。

パラメータ:

newModel - 使用する BoundedRangeModel

関連項目:

BoundedRangeModel

getValue

public int getValue()

モデルの現在の値を返します。この値は常に、モデルの最小値以上、最大値以下の範囲に収まります。デフォルトでは、この値は最小値と等しくなります。

戻り値:

値

関連項目:

setValue(int), BoundedRangeModel

getMinimum

public int getMinimum()

モデルの最小値を返します。デフォルトは 0 です。

戻り値:

モデルの最小値である int

関連項目:

setMinimum(int), BoundedRangeModel

getMaximum

public int getMaximum()

モデルの最大値を返します。デフォルトは 100 です。

戻り値:

モデルの最大値である int

関連項目:

setMaximum(int), BoundedRangeModel

setValue

public void setValue(int n)

モデルの現在の値を n に設定します。不適切な値を割り当てたことにより発生する数学的な問題は、背後の BoundedRangeModel が処理します。

パラメータ:

n - 新しい値

関連項目:

getValue(), BoundedRangeModel.setValue(int)

setMinimum

public void setMinimum(int n)

モデルの最小値を n に設定します。不適切な値を割り当てたことにより発生する数学的な問題は、背後の BoundedRangeModel が処理します。

データが変更された場合、任意のリスナーに通知します。

パラメータ:

n - 新しい最小値

関連項目:

getMinimum(), addChangeListener(javax.swing.event.ChangeListener), BoundedRangeModel

setMaximum

public void setMaximum(int n)

モデルの最大値を n に設定します。不適切な値を割り当てたことにより発生する数学的な問題は、背後の BoundedRangeModel が処理します。

データが変更された場合、任意のリスナーに通知します。

パラメータ:

n - 新しい最大値

関連項目:

getMaximum(), addChangeListener(javax.swing.event.ChangeListener), BoundedRangeModel

paramString

protected String paramString()

この JProgressBar の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

オーバーライド:

クラス JComponent 内の paramString

戻り値:

この JProgressBar の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()

この JProgressBar に関連した AccessibleContext を返します。進捗バーの場合、AccessibleContext は AccessibleJProgressBar の形式を取ります。必要に応じて新規の AccessibleJProgressBar インスタンスが作成されます。

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス JComponent 内の getAccessibleContext

戻り値:

この JProgressBar の AccessibleContext として機能する AccessibleJProgressBar