JavaTM Platform
Standard Ed. 6

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 に適しています。JDK Version 1.4 以降、すべての JavaBeans の長期間の運用サポートは、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 の進捗バーの現在の 最大 値を返します。
 int getMinimum()
          BoundedRangeModel の進捗バーの現在の 最小 値を返します。
 BoundedRangeModel getModel()
          この進捗バーが使っているデータモデルを返します。
 int getOrientation()
          進捗バーの方向に応じて、SwingConstants.VERTICALSwingConstants.HORIZONTAL を返します。
 double getPercentComplete()
          進捗バーの完了したパーセントを返します。
 String getString()
          現在の進捗状況を表す String 表現を返します。
 ProgressBarUI getUI()
          このコンポーネントを描画する Look & Feel オブジェクトを返します。
 String getUIClassID()
          このコンポーネントを描画する Look & Feel クラスの名前を返します。
 int getValue()
          BoundedRangeModel の進捗バーの現在の を返します。
 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)
          進捗バーがボーダーをペイントするようにするには 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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, 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, transferFocusBackward, 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, hide, 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, 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 以外の値に設定しても、必ずしも文字列が表示されるわけではありません。文字列を表示する場合は、paintStringtrue にしてください。

関連項目:
setString(java.lang.String), setStringPainted(boolean)

paintString

protected boolean paintString
進捗バーに文字列を表示するかどうかを設定します。デフォルトは false です。true に設定すると、進捗状況のテキスト表示が進捗バーに描画されます。progressStringnull の場合、完了した割合が進捗バーに表示されます。そうでない場合は、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.VERTICALSwingConstants.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 に設定し直します。  

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

パラメータ:
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)
進捗バーがボーダーをペイントするようにするには true にする必要があります。このプロパティーのデフォルト値は true です。一部の Look & Feel ではボーダーのペイントが実装されていない可能性があります。 実装されていない場合、このプロパティーは無視されます。

パラメータ:
b - 進捗バーにボーダーをペイントする場合は true、そうでない場合は false
関連項目:
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()
このコンポーネントを描画する 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 プロパティーをリセットします。

オーバーライド:
クラス JComponent 内の updateUI
関連項目:
JComponent.updateUI()

getUIClassID

public String getUIClassID()
このコンポーネントを描画する Look & Feel クラスの名前を返します。

オーバーライド:
クラス JComponent 内の getUIClassID
戻り値:
文字列「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 が使用するデータモデルを設定します。BoundedRangeModelextent は使用しないため、0 に設定することに注意してください。

パラメータ:
newModel - 使用する BoundedRangeModel

getValue

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

戻り値:
進捗バーの現在の値
関連項目:
setValue(int), BoundedRangeModel.getValue()

getMinimum

public int getMinimum()
BoundedRangeModel の進捗バーの現在の 最小 値を返します。

戻り値:
進捗バーの最小値
関連項目:
setMinimum(int), BoundedRangeModel.getMinimum()

getMaximum

public int getMaximum()
BoundedRangeModel の進捗バーの現在の 最大 値を返します。

戻り値:
進捗バーの最大値
関連項目:
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 にはなりません。

オーバーライド:
クラス JComponent 内の paramString
戻り値:
このJProgressBar の文字列表現

getAccessibleContext

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

定義:
インタフェース Accessible 内の getAccessibleContext
オーバーライド:
クラス JComponent 内の getAccessibleContext
戻り値:
この JProgressBarAccessibleContext として機能する AccessibleJProgressBar

JavaTM Platform
Standard Ed. 6

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

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。