Java プラットフォーム 1.2 API 仕様: クラス JProgressBar

概要

パッケージ

クラス

使用

階層ツリー

推奨されない

インデックス

ヘルプ

Java プラットフォーム 1.2

前のクラス 次のクラス

フレームあり フレームなし

概要: 内部クラス | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

javax.swing
クラス JProgressBar

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

public class JProgressBar
extends JComponent
implements SwingConstants, Accessible

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

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

関連項目:: 直列化された形式

内部クラスの概要
`protected class`	`JProgressBar.AccessibleJProgressBar` オブジェクトのユーザ補助機能を取得するために使用されるクラスです。

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

JComponent.AccessibleJComponent

フィールドの概要
`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

コンストラクタの概要
`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()` JComponent に関連付けられている 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 が変更されたことを示す UIFacotry からの通知です。

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

addAncestorListener, 
addNotify, 
addPropertyChangeListener, 
addVetoableChangeListener, 
computeVisibleRect, 
contains, 
createToolTip, 
firePropertyChange, 
firePropertyChange, 
firePropertyChange, 
firePropertyChange, 
firePropertyChange, 
firePropertyChange, 
firePropertyChange, 
firePropertyChange, 
firePropertyChange, 
fireVetoableChange, 
getActionForKeyStroke, 
getAlignmentX, 
getAlignmentY, 
getAutoscrolls, 
getBorder, 
getBounds, 
getClientProperty, 
getComponentGraphics, 
getConditionForKeyStroke, 
getDebugGraphicsOptions, 
getGraphics, 
getHeight, 
getInsets, 
getInsets, 
getLocation, 
getMaximumSize, 
getMinimumSize, 
getNextFocusableComponent, 
getPreferredSize, 
getRegisteredKeyStrokes, 
getRootPane, 
getSize, 
getToolTipLocation, 
getToolTipText, 
getToolTipText, 
getTopLevelAncestor, 
getVisibleRect, 
getWidth, 
getX, 
getY, 
grabFocus, 
hasFocus, 
isDoubleBuffered, 
isFocusCycleRoot, 
isFocusTraversable, 
isLightweightComponent, 
isManagingFocus, 
isOpaque, 
isOptimizedDrawingEnabled, 
isPaintingTile, 
isRequestFocusEnabled, 
isValidateRoot, 
paint, 
paintChildren, 
paintComponent, 
paintImmediately, 
paintImmediately, 
processComponentKeyEvent, 
processFocusEvent, 
processKeyEvent, 
processMouseMotionEvent, 
putClientProperty, 
registerKeyboardAction, 
registerKeyboardAction, 
removeAncestorListener, 
removeNotify, 
removePropertyChangeListener, 
removeVetoableChangeListener, 
repaint, 
repaint, 
requestDefaultFocus, 
requestFocus, 
resetKeyboardActions, 
reshape, 
revalidate, 
scrollRectToVisible, 
setAlignmentX, 
setAlignmentY, 
setAutoscrolls, 
setBackground, 
setBorder, 
setDebugGraphicsOptions, 
setDoubleBuffered, 
setEnabled, 
setFont, 
setForeground, 
setMaximumSize, 
setMinimumSize, 
setNextFocusableComponent, 
setOpaque, 
setPreferredSize, 
setRequestFocusEnabled, 
setToolTipText, 
setUI, 
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, 
print, 
printComponents, 
processContainerEvent, 
processEvent, 
remove, 
remove, 
removeAll, 
removeContainerListener, 
setLayout, 
validate, 
validateTree

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

action, 
add, 
addComponentListener, 
addFocusListener, 
addInputMethodListener, 
addKeyListener, 
addMouseListener, 
addMouseMotionListener, 
addPropertyChangeListener, 
bounds, 
checkImage, 
checkImage, 
coalesceEvents, 
contains, 
createImage, 
createImage, 
disable, 
disableEvents, 
dispatchEvent, 
enable, 
enable, 
enableEvents, 
enableInputMethods, 
getBackground, 
getBounds, 
getColorModel, 
getComponentOrientation, 
getCursor, 
getDropTarget, 
getFont, 
getFontMetrics, 
getForeground, 
getInputContext, 
getInputMethodRequests, 
getLocale, 
getLocation, 
getLocationOnScreen, 
getName, 
getParent, 
getPeer, 
getSize, 
getToolkit, 
getTreeLock, 
gotFocus, 
handleEvent, 
hide, 
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, 
printAll, 
processComponentEvent, 
processInputMethodEvent, 
processMouseEvent, 
remove, 
removeComponentListener, 
removeFocusListener, 
removeInputMethodListener, 
removeKeyListener, 
removeMouseListener, 
removeMouseMotionListener, 
removePropertyChangeListener, 
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 である場合に、進捗バーに境界線をペイントします。

パラメータ:: g - 境界線をペイントするグラフィックスコンテキスト
オーバーライド:: クラス JComponent 内の paintBorder
関連項目:: 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 が変更されたことを示す UIFacotry からの通知です。UI をUIFactory からの最新バージョンに置き換えるために呼び出されます。

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

getUIClassID

public String getUIClassID()

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

戻り値:: "ProgressBarUI"
オーバーライド:: クラス JComponent 内の getUIClassID
関連項目:: 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 にはなりません。

JFC コンポーネントの新しい側面についての情報を返すには、paramString() をオーバーライドします。

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

JComponent に関連付けられている AccessibleContext を取得します。

定義:: インタフェース Accessible 内の getAccessibleContext
戻り値:: JComponent の AccessibleContext
オーバーライド:: クラス JComponent 内の getAccessibleContext

概要

パッケージ

クラス

使用

階層ツリー

推奨されない

インデックス

ヘルプ

Java プラットフォーム 1.2

前のクラス 次のクラス

フレームあり フレームなし

概要: 内部クラス | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

バグや機能要求の報告
新しい javadoc の表示についてのコメントやご提案
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.

javax.swing クラス JProgressBar

orientation

paintBorder

model

progressString

paintString

changeEvent

changeListener

JProgressBar

JProgressBar

JProgressBar

JProgressBar

JProgressBar

getOrientation

setOrientation

isStringPainted

setStringPainted

getString

setString

getPercentComplete

isBorderPainted

setBorderPainted

paintBorder

getUI

setUI

updateUI

getUIClassID

createChangeListener

addChangeListener

removeChangeListener

fireStateChanged

getModel

setModel

getValue

getMinimum

getMaximum

setValue

setMinimum

setMaximum

paramString

getAccessibleContext

javax.swing
クラス JProgressBar