javax.swing
介面 BoundedRangeModel

所有已知實作類別：

DefaultBoundedRangeModel

public interface BoundedRangeModel

定義由 Slider 和 ProgressBar 這類別元件使用的資料模型。定義四個相關的整數屬性：minimum、maximum、extent 和 value。這四個整數定義了兩個巢狀的區域，如下所示：

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

外部區域是 minimum,maximum，內部區域是 value,value+extent。內部區域必須位於外部區域內，即 value 必須小於或等於 maximum，而 value+extent 必須大於或等於 minimum，並且 maximum 必須大於或等於 minimum。此模型有一些讓人微感吃驚的功能。這些奇特功能的存在是為了方便 Swing BoundedRangeModel 客戶端，比如 Slider 和 ScrollBar。

• minimum 和 maximum 設置方法“糾正”其他三個屬性，以適應其新 value 參數。例如，設置該模型的 minimum 屬性可能更改其 maximum、value 和 extent 屬性（以此順序），以維持上述約束。
• value 和 extent 設置方法“糾正”其參數，以符合其他三個屬性定義的限制。例如，如果 value == maximum，則 setExtent(10) 會將 extent 更改為（更改回）零。
• 這四個 BoundedRangeModel 值被定義為 Java Beans 屬性，不過，Swing ChangeEvent 被用來通知客戶端發生的更改，而不是 PropertyChangeEvent。這樣做是為了保持監視 BoundedRangeModel 有一個低開銷。更改常常根據 MouseDragged 比率進行報告。

有關指定滑塊使用的自定義有限範圍模型的範例，請參閱 The Java Tutorial 中的 The Anatomy of a Swing-Based Program 一節。

另請參見：

DefaultBoundedRangeModel

方法摘要

void	addChangeListener(ChangeListener x) 將一個 ChangeListener 添加到模型的偵聽器列表中。
int	getExtent() 返回模型的 extent，即從模型的 value 開始的內部範圍的長度。
int	getMaximum() 返回模型的 maximum。
int	getMinimum() 返回最小的可接受值。
int	getValue() 返回模型的當前值。
boolean	getValueIsAdjusting() 如果 value 屬性的當前更改是一系列更改的一部分，則返回 true。
void	removeChangeListener(ChangeListener x) 從模型的偵聽器列表中移除一個 ChangeListener。
void	setExtent(int newExtent) 設置模型的 extent。
void	setMaximum(int newMaximum) 將模型的 maximum 設置為 newMaximum。
void	setMinimum(int newMinimum) 將模型的 minimum 設置為 newMinimum。
void	setRangeProperties(int value, int extent, int min, int max, boolean adjusting) 此方法使用一個方法調用設置模型的所有資料。
void	setValue(int newValue) 如果 newValue 滿足模型的約束限制，則將模型的當前值設置為 newValue。
void	setValueIsAdjusting(boolean b) 此屬性指示，即將對模型值所做的任何更改都應被認為是一個單獨的事件。

方法詳細資訊

getMinimum

int getMinimum()

返回最小的可接受值。

返回：

minimum 屬性的值

另請參見：

setMinimum(int)

setMinimum

void setMinimum(int newMinimum)

將模型的 minimum 設置為 newMinimum。其他三個屬性可能也要更改，以確保：

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

如果模型發生更改，則通知所有偵聽器。

參數：

newMinimum - 模型的新 minimum

另請參見：

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

getMaximum

int getMaximum()

返回模型的 maximum。注意，模型值的上限是 (maximum - extent)。

返回：

maximum 屬性的值。

另請參見：

setMaximum(int), setExtent(int)

setMaximum

void setMaximum(int newMaximum)

將模型的 maximum 設置為 newMaximum。其他三個屬性可能也要更改，以確保

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

如果模型發生更改，則通知所有偵聽器。

參數：

newMaximum - 模型的新 maximum

另請參見：

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

getValue

int getValue()

返回模型的當前值。注意，模型值的上限是 maximum - extent，下限是 minimum。

返回：

模型的值

另請參見：

setValue(int)

setValue

void setValue(int newValue)

如果 newValue 滿足模型的約束限制，則將模型的當前值設置為 newValue。這些約束限制是：

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

否則，如果 newValue 小於 minimum，則將它設置為 minimum；如果它大於 maximum，則將它設置為 maximum；如果它大於 value+extent，則將它設置為 value+extent。

在對滾動條使用 BoundedRange 模型時，value 指定滾動條調節器（也稱為 "thumb" 或 "elevator"）的起始點。value 通常表示正被滾動物件的可見部分的起始點。

如果模型發生更改，則通知所有偵聽器。

參數：

newValue - 模型的新值

另請參見：

getValue()

setValueIsAdjusting

void setValueIsAdjusting(boolean b)

此屬性指示，即將對模型值所做的任何更改都應被認為是一個單獨的事件。在開始對該值進行一系列的更改時，此屬性將被設置為 true，在該值已經結束更改時，該值將被設置為 false。通常，此方法允許偵聽器只在提交了最終值時採取行動，而不是必須對所有中間值進行更新。

滑塊和滾動條在進行拖動時使用此屬性。

參數：

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

getValueIsAdjusting

boolean getValueIsAdjusting()

如果 value 屬性的當前更改是一系列更改的一部分，則返回 true。

返回：

valueIsAdjustingProperty。

另請參見：

setValueIsAdjusting(boolean)

getExtent

int getExtent()

返回模型的 extent，即從模型的 value 開始的內部範圍的長度。

返回：

模型的 extent 屬性的值

另請參見：

setExtent(int), setValue(int)

setExtent

void setExtent(int newExtent)

設置模型的 extent。newExtent 被迫大於或等於零，且小於等於 maximum - value。

在對滾動條使用 BoundedRange 模型時，extent 定義滾動條調節器（也稱為 "thumb" 或 "elevator"）的長度。extent 通常表示正被滾動的物件的可見量。在使用滑塊時，extent 確定 value 可以“跳躍”多少，例如當使用者按下 PgUp 或 PgDn 時跳躍的量。

如果模型發生更改，則通知所有偵聽器。

參數：

newExtent - 模型的新 extent

另請參見：

getExtent(), setValue(int)

setRangeProperties

void setRangeProperties(int value,
                        int extent,
                        int min,
                        int max,
                        boolean adjusting)

此方法使用一個方法調用設置模型的所有資料。該方法引起產生一個更改事件。在需要同時調整所有模型資料並且不想產生一些個別更改事件時，此方法很方便。

參數：

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

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

min - 給出 minimum 值的 int 值

max - 給出 maximum 值的 int 值

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

另請參見：

setValue(int), setExtent(int), setMinimum(int), setMaximum(int), setValueIsAdjusting(boolean)

addChangeListener

void addChangeListener(ChangeListener x)

將一個 ChangeListener 添加到模型的偵聽器列表中。

參數：

x - 要添加的 ChangeListener

另請參見：

removeChangeListener(javax.swing.event.ChangeListener)

removeChangeListener

void removeChangeListener(ChangeListener x)

從模型的偵聽器列表中移除一個 ChangeListener。

參數：

x - 要移除的 ChangeListener

另請參見：

addChangeListener(javax.swing.event.ChangeListener)