javax.swing
類別 DefaultBoundedRangeModel

java.lang.Object
  javax.swing.DefaultBoundedRangeModel

所有已實作的介面：

Serializable, BoundedRangeModel

public class DefaultBoundedRangeModel
extends Object
implements BoundedRangeModel, Serializable

BoundedRangeModel 的一般實作。

警告：此類別的序列化物件將與以後的 Swing 版本不相容。當前的序列化支持適用於短期存儲或運行相同 Swing 版本的應用程序之間的 RMI。從 1.4 版本開始，已在 java.beans 套件中添加了支持所有 JavaBeans^TM 長期存儲的功能。請參見 XMLEncoder。

另請參見：

BoundedRangeModel

欄位摘要

protected ChangeEvent	changeEvent 由於事件的惟一狀態（只讀）為源屬性，所以每個模型實例只需要一個 ChangeEvent。
protected EventListenerList	listenerList 等待模型更改的偵聽器。

建構子摘要

DefaultBoundedRangeModel()
使用預設值初始化所有屬性。

DefaultBoundedRangeModel(int value, int extent, int min, int max)
初始化 value、extent、minimum 和 maximum。

方法摘要

void	addChangeListener(ChangeListener l) 添加一個 ChangeListener。
protected void	fireStateChanged() 運行每個 ChangeListener 的 stateChanged 方法。
ChangeListener[]	getChangeListeners() 返回此 DefaultBoundedRangeModel 上所有已註冊的更改偵聽器組成的陣列。
int	getExtent() 返回模型的 extent。
<T extends EventListener> T[]	getListeners(Class<T> listenerType) 返回當前已在此模型上註冊為 FooListener 的所有物件組成的陣列。
int	getMaximum() 返回模型的 maximum。
int	getMinimum() 返回模型的 minimum。
int	getValue() 返回模型的當前值。
boolean	getValueIsAdjusting() 如果該值由於使用者正執行操作而處於更改過程中，則返回 true。
void	removeChangeListener(ChangeListener l) 移除一個 ChangeListener。
void	setExtent(int n) 在確保 n 大於或等於零，且落在以下模型約束範圍內之後，將 extent 設置為 n：
void	setMaximum(int n) 在確保 n 以及其他三個屬性滿足以下模型約束條件之後，將 maximum 設置為 n：
void	setMinimum(int n) 在確保 n 以及其他三個屬性滿足以下模型約束條件之後，將 minimum 設置為 n：
void	setRangeProperties(int newValue, int newExtent, int newMin, int newMax, boolean adjusting) 在強行使參數滿足以下常規約束條件之後，設置所有的 BoundedRangeModel 屬性： minimum <= value <= value+extent <= maximum 至多產生一個 ChangeEvent。
void	setValue(int n) 設置模型的當前值。
void	setValueIsAdjusting(boolean b) 設置 valueIsAdjusting 屬性。
String	toString() 返回顯示所有 BoundedRangeModel 屬性的字元串。

從類別 java.lang.Object 繼承的方法

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

欄位詳細資訊

changeEvent

protected transient ChangeEvent changeEvent

由於事件的惟一狀態（只讀）為源屬性，所以每個模型實例只需要一個 ChangeEvent。這裡產生的事件源總是“this”。

listenerList

protected EventListenerList listenerList

等待模型更改的偵聽器。

建構子詳細資訊

DefaultBoundedRangeModel

public DefaultBoundedRangeModel()

使用預設值初始化所有屬性。這些值是：

• value = 0
• extent = 0
• minimum = 0
• maximum = 100
• adjusting = false

DefaultBoundedRangeModel

public DefaultBoundedRangeModel(int value,
                                int extent,
                                int min,
                                int max)

初始化 value、extent、minimum 和 maximum。調整是錯誤的。如果不滿足以下約束條件，則拋出 IllegalArgumentException：

 min <= value <= value+extent <= max
 

方法詳細資訊

getValue

public int getValue()

返回模型的當前值。

指定者：

介面 BoundedRangeModel 中的 getValue

返回：

模型的當前值

另請參見：

setValue(int), BoundedRangeModel.getValue()

getExtent

public int getExtent()

返回模型的 extent。

指定者：

介面 BoundedRangeModel 中的 getExtent

返回：

模型的 extent

另請參見：

setExtent(int), BoundedRangeModel.getExtent()

getMinimum

public int getMinimum()

返回模型的 minimum。

指定者：

介面 BoundedRangeModel 中的 getMinimum

返回：

模型的 minimum

另請參見：

setMinimum(int), BoundedRangeModel.getMinimum()

getMaximum

public int getMaximum()

返回模型的 maximum。

指定者：

介面 BoundedRangeModel 中的 getMaximum

返回：

模型的 maximum

另請參見：

setMaximum(int), BoundedRangeModel.getMaximum()

setValue

public void setValue(int n)

設置模型的當前值。對於滑塊，該值確定調節器出現的位置。確保新值 n 落在以下模型約束範圍內：

     minimum <= value <= value+extent <= maximum
 

指定者：

介面 BoundedRangeModel 中的 setValue

參數：

n - 模型的新值

另請參見：

BoundedRangeModel.setValue(int)

setExtent

public void setExtent(int n)

在確保 n 大於或等於零，且落在以下模型約束範圍內之後，將 extent 設置為 n：

     minimum <= value <= value+extent <= maximum
 

指定者：

介面 BoundedRangeModel 中的 setExtent

參數：

n - 模型的新 extent

另請參見：

BoundedRangeModel.setExtent(int)

setMinimum

public void setMinimum(int n)

在確保 n 以及其他三個屬性滿足以下模型約束條件之後，將 minimum 設置為 n：

     minimum <= value <= value+extent <= maximum
 

指定者：

介面 BoundedRangeModel 中的 setMinimum

參數：

n - 模型的新 minimum

另請參見：

getMinimum(), BoundedRangeModel.setMinimum(int)

setMaximum

public void setMaximum(int n)

在確保 n 以及其他三個屬性滿足以下模型約束條件之後，將 maximum 設置為 n：

     minimum <= value <= value+extent <= maximum
 

指定者：

介面 BoundedRangeModel 中的 setMaximum

參數：

n - 模型的新 maximum

另請參見：

BoundedRangeModel.setMaximum(int)

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)

設置 valueIsAdjusting 屬性。

指定者：

介面 BoundedRangeModel 中的 setValueIsAdjusting

參數：

b - 如果即將進行的 value 屬性更改是一系列更改的一部分，則該參數為 true

另請參見：

getValueIsAdjusting(), setValue(int), BoundedRangeModel.setValueIsAdjusting(boolean)

getValueIsAdjusting

public boolean getValueIsAdjusting()

如果該值由於使用者正執行操作而處於更改過程中，則返回 true。

指定者：

介面 BoundedRangeModel 中的 getValueIsAdjusting

返回：

valueIsAdjusting 屬性的值

另請參見：

setValue(int), BoundedRangeModel.getValueIsAdjusting()

setRangeProperties

public void setRangeProperties(int newValue,
                               int newExtent,
                               int newMin,
                               int newMax,
                               boolean adjusting)

在強行使參數滿足以下常規約束條件之後，設置所有的 BoundedRangeModel 屬性：

     minimum <= value <= value+extent <= maximum
 

至多產生一個 ChangeEvent。

指定者：

介面 BoundedRangeModel 中的 setRangeProperties

參數：

newValue - 給出當前值的一個 int 值

newExtent - 給出 value 可以“跳躍”的量的 int 值

newMin - 給出 minimum 值的 int 值

newMax - 給出 maximum 值的 int 值

adjusting - 一個 boolean 值，如果正在進行一系列的更改，則該參數為 true

另請參見：

BoundedRangeModel.setRangeProperties(int, int, int, int, boolean), setValue(int), setExtent(int), setMinimum(int), setMaximum(int), setValueIsAdjusting(boolean)

addChangeListener

public void addChangeListener(ChangeListener l)

添加一個 ChangeListener。每當任何一個 Bounded Range 模型屬性發生更改時，更改偵聽器都會運行。

指定者：

介面 BoundedRangeModel 中的 addChangeListener

參數：

l - 要添加的 ChangeListener

另請參見：

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

removeChangeListener

public void removeChangeListener(ChangeListener l)

移除一個 ChangeListener。

指定者：

介面 BoundedRangeModel 中的 removeChangeListener

參數：

l - 要移除的 ChangeListener

另請參見：

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

getChangeListeners

public ChangeListener[] getChangeListeners()

返回此 DefaultBoundedRangeModel 上所有已註冊的更改偵聽器組成的陣列。

返回：

此模型的所有 ChangeListener，如果當前沒有已註冊的更改偵聽器，則返回一個空陣列。

從以下版本開始：

1.4

另請參見：

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

fireStateChanged

protected void fireStateChanged()

運行每個 ChangeListener 的 stateChanged 方法。

另請參見：

setRangeProperties(int, int, int, int, boolean), EventListenerList

toString

public String toString()

返回顯示所有 BoundedRangeModel 屬性的字元串。

覆寫：

類別 Object 中的 toString

返回：

該物件的字元串表示形式。

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

返回當前已在此模型上註冊為 FooListener 的所有物件組成的陣列。FooListener 是用 addFooListener 方法註冊的。

可以使用 class 文字值來指定 listenerType 參數，如 FooListener.class。例如，可以使用下面的程式碼查詢 DefaultBoundedRangeModel 實例 m 的更改偵聽器：

ChangeListener[] cls = (ChangeListener[])(m.getListeners(ChangeListener.class));

如果不存在這樣的偵聽器，則此方法將返回一個空陣列。

參數：

listenerType - 所請求偵聽器的型別；此參數應該指定一個從 java.util.EventListener 遺傳下來的介面

返回：

在此模型上註冊為 FooListener 的所有物件組成的陣列，如果沒有添加這樣的偵聽器，則返回一個空陣列

拋出：

ClassCastException - 如果 listenerType 沒有指定實作 java.util.EventListener 的類別或介面

從以下版本開始：

1.3

另請參見：

getChangeListeners()