BoundedRangeModel (Java Platform SE 8)

既知のすべての実装クラス:

DefaultBoundedRangeModel
```
public interface BoundedRangeModel
```
SliderやProgressBarなどのコンポーネントが使用するデータ・モデルを定義します。 4つの相互に関連した整数型のプロパティminimum、maximum、extent、およびvalueを定義します。これらの整数は、ネストされた2つの範囲を次のようにして定義します。
```
 minimum <= value <= value+extent <= maximum
 
```
外側の範囲はminimum,maximumで、内側の範囲はvalue,value+extentです。内側の範囲は、外側の範囲内にある必要があります。つまり、valueはmaximum以下、value+extentはminimum以上、maximumはminimum以上である必要があります。このモデルには、いくつかのやや意外な機能があります。これらの意外性は、SliderやScrollBarなどのSwing BoundedRangeModelクライアントの利便性のために存在しています。
- minimumおよびmaximum設定メソッドは、ほかの3つのプロパティを、新しい値の引数に合わせます。たとえば、モデルのminimumを設定すると、maximum、value、およびextentプロパティが設定された順に変更され、前述した条件を維持します。
- valueおよびextent設定メソッドは、ほかの3つのプロパティによって定義された制限に引数を合わせます。たとえば、value == maximumの場合、setExtent(10)はextentをゼロに戻します。
- BoundedRangeModelの4つの値はJava Beansのプロパティとして定義されていますが、SwingのChangeEventは、PropertyChangeEventよりも変更をクライアントに通知する用途によく使われます。これによって、BoundedRangeModelを監視するオーバーヘッドを低く保つことができます。変更は、しばしばMouseDraggedのレートの形でレポートされます。
スライダが使用する、カスタム・バインディングされた範囲モデルの指定の例については、Swingアーキテクチャの概要の分離可能なモデル・アーキテクチャの説明を参照してください。
関連項目:

DefaultBoundedRangeModel

メソッドのサマリー

すべてのメソッドインスタンス・メソッド抽象メソッド
修飾子と型	メソッド	説明
`void`	`addChangeListener(ChangeListener x)`	モデルのリスナー・リストにChangeListenerを追加します。
`int`	`getExtent()`	モデルのextentの値、すなわち、モデルのvalueから始まる内側の範囲の長さを返します。
`int`	`getMaximum()`	モデルのmaximumを返します。
`int`	`getMinimum()`	minimumに使用できる値を返します。
`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)`	1回のメソッドの呼出しで、モデルのデータをすべて設定できるメソッドです。
`void`	`setValue(int newValue)`	`newValue`がモデルの条件式を満たす場合は、モデルの現在の値を`newValue`に設定します。
`void`	`setValueIsAdjusting(boolean b)`	モデルの値に対する変更を単一のイベントとして扱うことを示す属性です。

- メソッドの詳細
  - getMinimum
```
int getMinimum()
```
    minimumに使用できる値を返します。
    
    戻り値:
    
    minimumプロパティの値
    
    関連項目:
    
    setMinimum(int)
  - setMinimum
```
void setMinimum(int newMinimum)
```
    モデルのminimumをnewMinimumに設定します。それに応じてほかの3つのプロパティも次の条件式を満たすように変更されます。
```
 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に設定します。それに応じてほかの3つのプロパティも次の条件式を満たすように変更されます。
```
 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モデルがスクロール・バーに使用されているとき、この値は「つまみ」または「スライダ」とも呼ばれるスクロール・バーのノブの原点を指定します。通常この値は、スクロールされるオブジェクトの可視部分の原点を示します。
    モデルが変更された場合、すべてのリスナーに通知されます。
    パラメータ:
    
    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モデルをスクロールバーで使用する場合、エクステントは「つまみ」または「スライダ」とも呼ばれるスクロールバーのノブの長さを定義します。エクステントは、通常、スクロールされているオブジェクトの表示可能な量を表します。スライダで使用する場合、エクステントは、ユーザーが[PgUp]または[PgDn]を押した場合などに、値が「ジャンプ」できる量を指定します。
    モデルが変更された場合、すべてのリスナーに通知されます。
    
    パラメータ:
    
    newExtent - モデルの新しいextent
    
    関連項目:
    
    getExtent(), setValue(int)
  - setRangeProperties
```
void setRangeProperties(int value,
                        int extent,
                        int min,
                        int max,
                        boolean adjusting)
```
    1回のメソッドの呼出しで、モデルのデータをすべて設定できるメソッドです。その結果、単一の変更イベントが生成されます。個々の変更イベントを発生させずに、モデルのデータをすべて同時に調整するのに便利です。
    
    パラメータ:
    
    value - 現在の値を指定する整数値
    
    extent - 値が「ジャンプ」できる量を指定する整数値
    
    min - 最小値を指定する整数値
    
    max - 最大値を指定する整数値
    
    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)

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

インタフェースBoundedRangeModel

メソッドのサマリー

メソッドの詳細

getMinimum

setMinimum

getMaximum

setMaximum

getValue

setValue

setValueIsAdjusting

getValueIsAdjusting

getExtent

setExtent

setRangeProperties

addChangeListener

removeChangeListener