JavaTM 2 Platform
Standard Ed. 5.0

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

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

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

進捗バーの作成例を次に示します。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 プロパティをリセットします。
 
クラス javax.swing.JComponent から継承されたメソッド
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, 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, 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 以外の値に設定しても、必ずしも文字列が表示されるわけではありません。

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

paintString

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

関連項目:
setStringPainted(boolean)

changeEvent

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


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)
指定された方向を持つ進捗バーを作成します。方向は、JProgressBar.VERTICAL または JProgressBar.HORIZONTAL です。デフォルトでは、ボーダはペイントされ、進捗文字列はペイントされません。初期値および最小値は 0、最大値は 100 です。

パラメータ:
orient - 進捗バーの目的の方向
関連項目:
setOrientation(int), setBorderPainted(boolean), setStringPainted(boolean), setString(java.lang.String), setIndeterminate(boolean)

JProgressBar

public JProgressBar(int min,
                    int max)
水平方向の進捗バーを作成します。指定された最小値および最大値を使います。進捗バーの初期値を、指定された最小値に設定します。デフォルトでは、ボーダはペイントされ、進捗文字列はペイントされません。進捗バーの最小値、初期値、および最大値として設定された値が適切でないために問題が発生した場合は、進捗バーのデータを保持する 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 がその問題を処理します。

パラメータ:
orient - 進捗バーの目的の方向
min - 進捗バーの最小値
max - 進捗バーの最大値
関連項目:
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()
進捗バーの方向に応じて、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()
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()
進捗文字列の現在の値を返します。このメソッドをオーバーライドして独自の進捗文字列を提供する場合は、super.getString よりも先に setString を呼び出さなければなりません。

戻り値:
パーセント表示の文字列の値
関連項目:
setString(java.lang.String)

setString

public void setString(String s)
進捗文字列の値を設定します。デフォルトでは、この文字列は null に設定されます。独自の進捗文字列を指定したあとで、組み込みの動作に戻すには、文字列を null に設定し直します。 このメソッドをオーバーライドして独自の進捗文字列を指定する場合は、確実に getString よりも先に setString を呼び出すようにしなければなりません。進捗文字列は、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)
borderPainted プロパティを設定します。進捗バーがボーダをペイントするようにするには 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, 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()
ChangeEvent で登録したすべてのリスナーに通知します。イベントのインスタンスは必要に応じて生成されます。

関連項目:
EventListenerList

getModel

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

戻り値:
現在使用している BoundedRangeModel
関連項目:
BoundedRangeModel

setModel

public void setModel(BoundedRangeModel newModel)
JProgressBar が使用するデータモデルを設定します。

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

getValue

public int getValue()
進捗バーの現在の値を返します。この値は、進捗バーの BoundedRangeModel に格納されます。この値は常に、最小値以上、最大値以下の範囲に収まります。デフォルトでは、この値は初期化され、最小値と等しくなります。

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

getMinimum

public int getMinimum()
進捗バーの最小値を返します。この値は、進捗バーの BoundedRangeModel に格納されます。デフォルトでは、最小値は 0 です。

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

getMaximum

public int getMaximum()
進捗バーの最大値を返します。この値は、進捗バーの BoundedRangeModel に格納されます。デフォルトでは、最大値は 100 です。

戻り値:
進捗バーの最大値
関連項目:
setMaximum(int), BoundedRangeModel.getMaximum()

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.setMinimum(int)

setMaximum

public void setMaximum(int n)
進捗バーの最大値 (進捗バーのデータモデルに格納) を n に設定します。不適切な値を割り当てたことにより発生する数学的な問題は、基本となる 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 2 Platform
Standard Ed. 5.0

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

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