javax.swing

クラス JProgressBar

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JProgressBar

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

ImageObserver, MenuContainer, Serializable, Accessible, SwingConstants

public class JProgressBar
extends JComponent
implements SwingConstants, Accessible

一部のタスクの進捗状況を視覚的に表示するコンポーネントです。タスクの処理の進行に合わせて、進捗バーに、処理の完了のパーセンテージが表示されます。このパーセンテージは、通常、棒状のインジケータで表されます。最初、このインジケータの内部は空ですが、タスクの進行とともに塗りつぶされていきます。進捗バーには、このパーセンテージをテキストで表示することもできます。

JProgressBar は、BoundedRangeModel をデータモデルとし、タスクの「現在の」状態を表す value プロパティー、タスクの開始点を表す minimum プロパティー、およびタスクの終了点を表す maximum プロパティーを指定して使用します。

不明な長さのタスクが実行されていることを示すには、進捗バーを不確定モードにすることができます。バーが不確定モードの間は、常に処理が行われていることが動画で表示されます。タスクの長さが判定されるとすぐに、進捗バーの値を更新して確定モードに戻します。

進捗バーの作成例を次に示します。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's Threading Policy」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。1.4 以降、すべての JavaBeans^TM 用の長期間の格納サポートが java.beans パッケージに追加されています。XMLEncoder を参照してください。

関連項目:

BasicProgressBarUI, BoundedRangeModel, SwingWorker

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
protected class	JProgressBar.AccessibleJProgressBar このクラスは JProgressBar クラスのアクセシビリティーサポートを実装しています。

クラス javax.swing.JComponent から継承されたネストされたクラス/インタフェース

JComponent.AccessibleJComponent

クラス java.awt.Container から継承されたネストされたクラス/インタフェース

Container.AccessibleAWTContainer

クラス java.awt.Component から継承されたネストされたクラス/インタフェース

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, 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) 指定した方向 (SwingConstants.VERTICAL または SwingConstants.HORIZONTAL) で進捗バーを作成します。
JProgressBar(int min, int max) 水平方向の進捗バーを作成します。指定された最小値および最大値を使います。
JProgressBar(int orient, int min, int max) 進捗バーを作成します。指定された方向、最小値、および最大値を使います。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	addChangeListener(ChangeListener l) 指定された ChangeListener を進捗バーに追加します。
protected ChangeListener	createChangeListener() サブクラスが別の方法でモデルからの変更イベントを処理する場合は、このメソッドをオーバーライドして ChangeListener のカスタム実装のインスタンスを返すことができます。
protected void	fireStateChanged() この JProgressBar をソースとする ChangeEvent を、ChangeEvent の通知を受ける登録をしているすべての ChangeListener に送信します。
AccessibleContext	getAccessibleContext() この JProgressBar に関連付けられている AccessibleContext を取得します。
ChangeListener[]	getChangeListeners() addChangeListener を使用してこの進捗バーに追加されたすべての ChangeListener の配列を返します。
int	getMaximum() BoundedRangeModel から進捗バーの maximum 値を返します。
int	getMinimum() BoundedRangeModel から進捗バーの minimum 値を返します。
BoundedRangeModel	getModel() この進捗バーが使っているデータモデルを返します。
int	getOrientation() 進捗バーの方向に応じて、SwingConstants.VERTICAL または SwingConstants.HORIZONTAL を返します。
double	getPercentComplete() 進捗バーの完了したパーセントを返します。
String	getString() 現在の進捗状況を表す String 表現を返します。
ProgressBarUI	getUI() このコンポーネントをレンダリングする Look & Feel オブジェクトを返します。
String	getUIClassID() このコンポーネントをレンダリングする Look & Feel クラスの名前を返します。
int	getValue() BoundedRangeModel の進捗バーの現在の value を返します。
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 プロパティーを設定します。進捗バーがボーダーをペイントするようにするには true に設定します。
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 (SwingConstants.VERTICAL または SwingConstants.HORIZONTAL) に設定します。
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 プロパティーをリセットします。

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

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

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

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

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

フィールドの詳細

orientation

protected int orientation

進捗バーが水平であるか垂直であるかを示します。デフォルトは HORIZONTAL です。

関連項目:

setOrientation(int)

paintBorder

protected boolean paintBorder

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

関連項目:

setBorderPainted(boolean)

model

protected BoundedRangeModel model

進捗バーの値を保持するオブジェクトです。

関連項目:

setModel(javax.swing.BoundedRangeModel)

progressString

protected String progressString

進捗バーに表示できるオプションの文字列です。デフォルトは null です。null 以外の値に設定しても、必ずしも文字列が表示されるわけではありません。文字列を表示する場合は、paintString を true にしてください。

関連項目:

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

paintString

protected boolean paintString

進捗バーに文字列を表示するかどうかを設定します。デフォルトは false です。true に設定すると、進捗状況のテキスト表示が進捗バーにレンダリングされます。progressString が null の場合、完了した割合が進捗バーに表示されます。そうでない場合は、progressString が進捗バーにレンダリングされます。

関連項目:

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

changeEvent

protected transient ChangeEvent changeEvent

ChangeEvent は、インスタンスごとに 1 つだけ必要です。これは、このイベントの扱うプロパティーのソースが進捗バーだけであり、それ以外に変更されないためです。はじめてイベント通知がトリガーされたときに、イベントは遅れて作成されます。

関連項目:

fireStateChanged()

changeListener

protected ChangeListener changeListener

進捗バーのモデルから送られた変更イベントを待機し、この進捗バーに登録された変更イベントリスナーにふたたびディスパッチします。

関連項目:

createChangeListener()

コンストラクタの詳細

JProgressBar

public JProgressBar()

ボーダーを表示し、進捗文字列を表示しない、水平方向の進捗バーを作成します。初期値および最小値は 0、最大値は 100 です。

関連項目:

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

JProgressBar

public JProgressBar(int orient)

指定した方向 (SwingConstants.VERTICAL または SwingConstants.HORIZONTAL) で進捗バーを作成します。デフォルトでは、ボーダーはペイントされ、進捗文字列はペイントされません。初期値および最小値は 0、最大値は 100 です。

パラメータ:

orient - 進捗バーの目的の方向

例外:

IllegalArgumentException - orient の値が無効な場合

関連項目:

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

JProgressBar

public JProgressBar(int min,
            int max)

水平方向の進捗バーを作成します。指定された最小値および最大値を使います。進捗バーの初期値を、指定された最小値に設定します。デフォルトでは、ボーダーはペイントされ、進捗文字列はペイントされません。

進捗バーの最小値、初期値、および最大値として設定された値が適切でないために問題が発生した場合は、進捗バーのデータを保持する BoundedRangeModel がその問題を処理します。詳細は、BoundedRangeModel のドキュメントを参照してください。

パラメータ:

min - 進捗バーの最小値

max - 進捗バーの最大値

関連項目:

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

JProgressBar

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

進捗バーを作成します。指定された方向、最小値、および最大値を使います。デフォルトでは、ボーダーはペイントされ、進捗文字列はペイントされません。進捗バーの初期値を、指定された最小値に設定します。

進捗バーの最小値、初期値、および最大値として設定された値が適切でないために問題が発生した場合は、進捗バーのデータを保持する BoundedRangeModel がその問題を処理します。詳細は、BoundedRangeModel のドキュメントを参照してください。

パラメータ:

orient - 進捗バーの目的の方向

min - 進捗バーの最小値

max - 進捗バーの最大値

例外:

IllegalArgumentException - orient の値が無効な場合

関連項目:

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

JProgressBar

public JProgressBar(BoundedRangeModel newModel)

水平方向の進捗バーを作成します。進捗バーのデータの保持には指定されたモデルを使用します。デフォルトでは、ボーダーはペイントされ、進捗文字列はペイントされません。

パラメータ:

newModel - 進捗バーのデータモデル

関連項目:

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

メソッドの詳細

getOrientation

public int getOrientation()

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

戻り値:

HORIZONTAL またはVERTICAL

関連項目:

setOrientation(int)

setOrientation

public void setOrientation(int newOrientation)

進捗バーの方向を newOrientation (SwingConstants.VERTICAL または SwingConstants.HORIZONTAL) に設定します。デフォルトの方向は SwingConstants.HORIZONTAL です。

パラメータ:

newOrientation - HORIZONTAL または VERTICAL

例外:

IllegalArgumentException - newOrientation の値が無効な場合

関連項目:

getOrientation()

isStringPainted

public boolean isStringPainted()

stringPainted プロパティーの値を返します。

戻り値:

stringPainted プロパティーの値

関連項目:

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

setStringPainted

public void setStringPainted(boolean b)

stringPainted プロパティーの値を設定します。このプロパティーは、進捗バーが進捗文字列をレンダリングするかどうかを指定します。デフォルトでは false に設定され、文字列はペイントされません。進捗文字列をサポートしない、または進捗バーが不確定モードのときだけサポートする Look & Feel もあります。

パラメータ:

b - 進捗バーに文字列をレンダリングする場合は true

関連項目:

isStringPainted(), setString(java.lang.String)

getString

public String getString()

現在の進捗状況を表す String 表現を返します。デフォルトでは、getPercentComplete の戻り値に基づいて、単純なパーセンテージを表す String が返されます。たとえば、「42%」のような文字列になります。この設定は、setString を呼び出すことで変更できます。

戻り値:

進捗文字列の値。進捗文字列が null の場合、単純なパーセンテージを示す文字列

関連項目:

setString(java.lang.String)

setString

public void setString(String s)

進捗文字列の値を設定します。デフォルトでは、この文字列は null で、単純なパーセンテージを表す文字列が返されます (組み込みの動作)。独自の進捗文字列を指定したあとで、組み込みの動作に戻すには、文字列を null に設定し直します。

進捗文字列は、isStringPainted が true を返す場合にだけペイントされます。

パラメータ:

s - 進捗文字列の値

関連項目:

getString(), setStringPainted(boolean), isStringPainted()

getPercentComplete

public double getPercentComplete()

進捗バーの完了したパーセントを返します。値は 0.0 から 1.0 の範囲にあります。

戻り値:

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

isBorderPainted

public boolean isBorderPainted()

borderPainted プロパティーを返します。

戻り値:

borderPainted プロパティーの値

関連項目:

setBorderPainted(boolean)

setBorderPainted

public void setBorderPainted(boolean b)

borderPainted プロパティーを設定します。進捗バーがボーダーをペイントするようにするには true に設定します。このプロパティーのデフォルト値は true です。一部の Look & Feel ではボーダーのペイントが実装されていない可能性があります。実装されていない場合、このプロパティーは無視されます。

パラメータ:

b - 進捗バーにボーダーをペイントする場合は true、そうでない場合は false

関連項目:

isBorderPainted()

paintBorder

protected void paintBorder(Graphics g)

borderPainted プロパティーが true である場合に、進捗バーのボーダーをペイントします。

オーバーライド:

paintBorder 、クラス: JComponent

パラメータ:

g - ボーダーをペイントする Graphics コンテキスト

関連項目:

JComponent.paint(java.awt.Graphics), JComponent.setBorder(javax.swing.border.Border), isBorderPainted(), setBorderPainted(boolean)

getUI

public ProgressBarUI getUI()

このコンポーネントをレンダリングする Look & Feel オブジェクトを返します。

戻り値:

このコンポーネントをレンダリングする ProgressBarUI オブジェクト

setUI

public void setUI(ProgressBarUI ui)

このコンポーネントをレンダリングする Look & Feel オブジェクトを設定します。

パラメータ:

ui - ProgressBarUI オブジェクト

関連項目:

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

現在の Look & Feel からの値に UI プロパティーをリセットします。

オーバーライド:

updateUI 、クラス: JComponent

関連項目:

JComponent.updateUI()

getUIClassID

public String getUIClassID()

このコンポーネントをレンダリングする Look & Feel クラスの名前を返します。

オーバーライド:

getUIClassID 、クラス: JComponent

戻り値:

文字列「ProgressBarUI」

関連項目:

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

createChangeListener

protected ChangeListener createChangeListener()

サブクラスが別の方法でモデルからの変更イベントを処理する場合は、このメソッドをオーバーライドして ChangeListener のカスタム実装のインスタンスを返すことができます。デフォルトの ChangeListener は、単純に fireStateChanged メソッドを呼び出すことにより、ChangeEvent を、進捗バーに直接追加された ChangeListener に転送します。

関連項目:

changeListener, fireStateChanged(), ChangeListener, BoundedRangeModel

addChangeListener

public void addChangeListener(ChangeListener l)

指定された ChangeListener を進捗バーに追加します。

パラメータ:

l - 追加する ChangeListener

removeChangeListener

public void removeChangeListener(ChangeListener l)

進捗バーから ChangeListener を削除します。

パラメータ:

l - 削除する ChangeListener

getChangeListeners

public ChangeListener[] getChangeListeners()

addChangeListener を使用してこの進捗バーに追加されたすべての ChangeListener の配列を返します。

戻り値:

追加されたすべての ChangeListener。リスナーが追加されていない場合は空の配列

導入されたバージョン:

1.4

fireStateChanged

protected void fireStateChanged()

この JProgressBar をソースとする ChangeEvent を、ChangeEvent の通知を受ける登録をしているすべての ChangeListener に送信します。このメソッドは、モデルから ChangeEvent を受信するたびに呼び出されます。

必要に応じてイベントインスタンスが作成され、changeEvent に格納されます。

関連項目:

addChangeListener(javax.swing.event.ChangeListener), EventListenerList

getModel

public BoundedRangeModel getModel()

この進捗バーが使っているデータモデルを返します。

戻り値:

現在使用されている BoundedRangeModel

関連項目:

setModel(javax.swing.BoundedRangeModel), BoundedRangeModel

setModel

public void setModel(BoundedRangeModel newModel)

JProgressBar が使用するデータモデルを設定します。BoundedRangeModel の extent は使用しないため、0 に設定されます。

パラメータ:

newModel - 使用する BoundedRangeModel

getValue

public int getValue()

BoundedRangeModel の進捗バーの現在の value を返します。この値は常に、最小値以上、最大値以下の範囲に収まります。

戻り値:

進捗バーの現在の値

関連項目:

setValue(int), BoundedRangeModel.getValue()

getMinimum

public int getMinimum()

BoundedRangeModel から進捗バーの minimum 値を返します。

戻り値:

進捗バーの最小値

関連項目:

setMinimum(int), BoundedRangeModel.getMinimum()

getMaximum

public int getMaximum()

BoundedRangeModel から進捗バーの maximum 値を返します。

戻り値:

進捗バーの最大値

関連項目:

setMaximum(int), BoundedRangeModel.getMaximum()

setValue

public void setValue(int n)

進捗バーの現在の値を n に設定します。このメソッドはモデルに新しい値を転送します。

不適切な値を割り当てたことにより発生する数学的な問題は、データモデル (BoundedRangeModel インスタンス) が処理します。詳細は、BoundedRangeModel のドキュメントを参照してください。

新しい値が以前の値と異なる場合は、すべての変更リスナーが通知されます。

パラメータ:

n - 新しい値

関連項目:

getValue(), addChangeListener(javax.swing.event.ChangeListener), BoundedRangeModel.setValue(int)

setMinimum

public void setMinimum(int n)

進捗バーの最小値 (進捗バーのデータモデルに格納) を n に設定します。

不適切な値を割り当てたことにより発生する数学的な問題は、データモデル (BoundedRangeModel インスタンス) が処理します。詳細は、BoundedRangeModel のドキュメントを参照してください。

最小値が以前の最小値と異なる場合は、すべての変更リスナーが通知されます。

パラメータ:

n - 新しい最小値

関連項目:

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

setMaximum

public void setMaximum(int n)

進捗バーの最大値 (進捗バーのデータモデルに格納) を n に設定します。

不適切な値を割り当てたことにより発生する数学的な問題は、ベースとなる BoundedRangeModel が処理します。詳細は、BoundedRangeModel のドキュメントを参照してください。

最大値が以前の最大値と異なる場合は、すべての変更リスナーが通知されます。

パラメータ:

n - 新しい最大値

関連項目:

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

setIndeterminate

public void setIndeterminate(boolean newValue)

進捗バーの indeterminate プロパティーを設定します。このプロパティーは、進捗バーが確定モードであるか不確定モードであるかを指定します。不確定モードの進捗バーは連続的にアニメーションを表示して、不明な長さの処理が行われていることを示します。デフォルトでは、このプロパティーは false に設定されます。一部の Look & Feel では、不確定モードの進捗バーがサポートされていない可能性があります。その場合、このプロパティーは無視されます。

不確定モードの進捗バーの使用例については、「How to Monitor Progress」を参照してください。

パラメータ:

newValue - 進捗バーを不確定モードに切り替える場合は true、通常モードに戻す場合は false。

導入されたバージョン:

1.4

関連項目:

isIndeterminate(), BasicProgressBarUI

isIndeterminate

public boolean isIndeterminate()

indeterminate プロパティーの値を返します。

戻り値:

indeterminate プロパティーの値

導入されたバージョン:

1.4

関連項目:

setIndeterminate(boolean)

paramString

protected String paramString()

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

オーバーライド:

paramString 、クラス: JComponent

戻り値:

この JProgressBar の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

定義:

getAccessibleContext 、インタフェース: Accessible

オーバーライド:

getAccessibleContext 、クラス: JComponent

戻り値:

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