|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.Scrollbar
Scrollbar
クラスは、よく使用されるユーザインタフェースオブジェクトであるスクロールバーを実現します。スクロールバーは、ユーザが値の範囲から値を選択できるようにするための便利な手段を提供します。次の 3 つの垂直スクロールバーは、赤、緑、青の色成分を選択するためのスライダコントロールとして使用できます。
この例のスクロールバーは、それぞれ次のようなコードを使って作成できます。
redSlider=new Scrollbar(Scrollbar.VERTICAL, 0, 1, 0, 255); add(redSlider);
また、スクロールバーは一定の値の範囲を表すことができます。たとえば、スクロールバーがテキストをスクロールするために使用される場合は、「バブル」または「サム」の幅は可視のテキストの量を表すことができます。範囲を表すスクロールバーの例を次に示します。
バブルによって表される値の範囲は、スクロールバーの可視範囲になります。この例の水平スクロールバーは次のようなコードで作成できます。
ranger = new Scrollbar(Scrollbar.HORIZONTAL, 0, 60, 0, 300); add(ranger);
スクロールバーの実際の最大値は、maximum
から visible
を引いた値です。上記の例では、maximum
が 300 で、visible
が 60 なので、実際の最大値は 240 です。スクロールバーのトラックの範囲は、0 〜 300 です。バブルの左端は、スクロールバーの値を示します。
通常、ユーザは、マウスを使ったジェスチャーを行うことによりスクロールバーの値を変更します。たとえば、ユーザはスクロールバーのバブルを上下にドラッグしたり、スクロールバーの「ユニット」増分値領域または「ブロック」増分値領域をクリックしたりすることができます。また、キーボードジェスチャーをスクロールバーにマッピングすることもできます。通常、Page Up キーおよび Page Down キーは、スクロールバーの「ブロック」増分値領域および「ブロック」減分値領域のクリックに相当します。
ユーザがスクロールバーの値を変更すると、スクロールバーは AdjustmentEvent
のインスタンスを受け取ります。スクロールバーはこのイベントを処理し、登録されているすべてのリスナーに渡します。
スクロールバーの値が変更されたときに通知を必要とするオブジェクトは、java.awt.event
パッケージで定義されるインタフェース AdjustmentListener
を実装する必要があります。addAdjustmentListener
メソッドおよび removeAdjustmentListener
メソッドを呼び出すことによって動的にリスナーを追加したり削除したりすることができます。
AdjustmentEvent
クラスは、次に示す 5 つの型の調整イベントを定義します。
AdjustmentEvent.TRACK
。この調整イベントは、ユーザがスクロールバーのバブルをドラッグしたときに送出される
AdjustmentEvent.UNIT_INCREMENT
。この調整イベントは、ユーザが水平スクロールバーの左矢印または垂直スクロールバーの上矢印をクリックするか、キーボードからそれに相当するジェスチャーを行なったときに送出される
AdjustmentEvent.UNIT_DECREMENT
。この調整イベントは、ユーザが水平スクロールバーの右矢印または垂直スクロールバーの下矢印をクリックするか、キーボードからそれに相当するジェスチャーを行なったときに送出される
AdjustmentEvent.BLOCK_INCREMENT
。この調整イベントは、ユーザがトラック上で水平スクロールバーのバブルの左側または垂直スクロールバーのバブルの上側をクリックしたときに送出される。Page Up キーが定義されているキーボードをユーザが使用している場合は、通常、Page Up キーがこれに相当する
AdjustmentEvent.BLOCK_DECREMENT
。この調整イベントは、ユーザがトラック上で水平スクロールバーのバブルの右側または垂直スクロールバーのバブルの下側をクリックしたときに送出される。Page Down キーが定義されているキーボードをユーザが使用している場合は、通常、Page Down キーがこれに相当する
JDK 1.0 のイベントシステムは、下位互換性のためにサポートされていますが、新しいバージョンの JDK では使用しないでください。JDK 1.1 で導入された 5 つの型の調整イベントは、以前のバージョンの JDK でスクロールバーに関連付けられている 5 つのイベント型に対応しています。次のリストに、調整イベント型と、それらによって置き換えられた対応する JDK 1.0 イベント型を示します。
AdjustmentEvent.TRACK
が Event.SCROLL_ABSOLUTE
の代わりに使用される
AdjustmentEvent.UNIT_INCREMENT
が Event.SCROLL_LINE_UP
の代わりに使用される
AdjustmentEvent.UNIT_DECREMENT
が Event.SCROLL_LINE_DOWN
の代わりに使用される
AdjustmentEvent.BLOCK_INCREMENT
が Event.SCROLL_PAGE_UP
の代わりに使用される
AdjustmentEvent.BLOCK_DECREMENT
が Event.SCROLL_PAGE_DOWN
の代わりに使用される
AdjustmentEvent
,
AdjustmentListener
, 直列化された形式フィールドの概要 | |
static int |
HORIZONTAL
水平スクロールバーを示す定数です。 |
static int |
VERTICAL
垂直スクロールバーを示す定数です。 |
クラス java.awt.Component から継承したフィールド |
BOTTOM_ALIGNMENT,
CENTER_ALIGNMENT,
LEFT_ALIGNMENT,
RIGHT_ALIGNMENT,
TOP_ALIGNMENT |
コンストラクタの概要 | |
Scrollbar()
新しい垂直スクロールバーを構築します。 |
|
Scrollbar(int orientation)
指定された方向の新しいスクロールバーを構築します。 |
|
Scrollbar(int orientation,
int value,
int visible,
int minimum,
int maximum)
指定された方向、初期値、ページサイズ、最小値、および最大値を持つ新しいスクロールバーを構築します。 |
メソッドの概要 | |
void |
addAdjustmentListener(AdjustmentListener l)
このスクロールバーから AdjustmentEvent のインスタンスを受け取るために、指定された調整リスナーを追加します。 |
void |
addNotify()
スクロールバーのピアを作成します。 |
int |
getBlockIncrement()
このスクロールバーの「ブロック」増分値を取得します。 |
int |
getLineIncrement()
推奨されません。 JDK バージョン 1.1 以降は、 getUnitIncrement() に置き換えられました。 |
int |
getMaximum()
このスクロールバーの最大値を取得します。 |
int |
getMinimum()
このスクロールバーの最小値を取得します。 |
int |
getOrientation()
このスクロールバーの方向を判定します。 |
int |
getPageIncrement()
推奨されません。 JDK バージョン 1.1 以降は、 getBlockIncrement() に置き換えられました。 |
int |
getUnitIncrement()
このスクロールバーの「ユニット」増分値を取得します。 |
int |
getValue()
このスクロールバーの現在値を取得します。 |
int |
getVisible()
推奨されません。 JDK バージョン 1.1 以降は、 getVisibleAmount() に置き換えられました。 |
int |
getVisibleAmount()
このスクロールバーの可視量を取得します。 |
protected String |
paramString()
このスクロールバーの状態を表すパラメータ文字列を返します。 |
protected void |
processAdjustmentEvent(AdjustmentEvent e)
このスクロールバーで発生する調整イベントを、登録されている AdjustmentListener オブジェクトにディスパッチすることにより、調整イベントを処理します。
|
protected void |
processEvent(AWTEvent e)
このスクロールバーのイベントを処理します。 |
void |
removeAdjustmentListener(AdjustmentListener l)
このスクロールバーから AdjustmentEvent のインスタンスを受け取らないように、指定された調整リスナーを削除します。 |
void |
setBlockIncrement(int v)
このスクロールバーの「ブロック」増分値を設定します。 |
void |
setLineIncrement(int v)
推奨されません。 JDK バージョン 1.1 以降は、 setUnitIncrement(int) に置き換えられました。 |
void |
setMaximum(int newMaximum)
このスクロールバーの最大値を設定します。 |
void |
setMinimum(int newMinimum)
このスクロールバーの最小値を設定します。 |
void |
setOrientation(int orientation)
このスクロールバーの方向を設定します。 |
void |
setPageIncrement(int v)
推奨されません。 JDK バージョン 1.1 以降は、 setBlockIncrement() に置き換えられました。 |
void |
setUnitIncrement(int v)
このスクロールバーの「ユニット」増分値を設定します。 |
void |
setValue(int newValue)
このスクロールバーの値を、指定された値に設定します。 |
void |
setValues(int value,
int visible,
int minimum,
int maximum)
このスクロールバーの 4 つのプロパティの値を設定します。 |
void |
setVisibleAmount(int newAmount)
このスクロールバーの可視量を設定します。 |
クラス java.lang.Object から継承したメソッド |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
フィールドの詳細 |
public static final int HORIZONTAL
public static final int VERTICAL
コンストラクタの詳細 |
public Scrollbar()
プロパティ | 説明 | 既定値 |
---|---|---|
orientation | スクロールバーが垂直か水平かを示す | Scrollbar.VERTICAL |
value | スクロールバーのバブルの位置
を制御する値 |
0 |
minimum | スクロールバーの最小値 | 0 |
maximum | スクロールバーの最大値 | 100 |
unit increment | Line Up キーまたは Line Down キーが
押されたとき、またはスクロールバー の末尾の矢印がクリックされたときに 値が変化する量 |
1 |
block increment | Page Up キーまたは Page Down キーが
押されたとき、スクロールバーの トラックがバブルの片側でクリック されたときに値が変化する量 |
10 |
public Scrollbar(int orientation)
orientation
引数は、水平スクロールバーを示す値 Scrollbar.HORIZONTAL
、または垂直スクロールバーを示す値 Scrollbar.VERTICAL
のどちらかでなければなりません。
orientation
- スクロールバーの方向を示すorientation
引数に不正な値が指定された場合public Scrollbar(int orientation, int value, int visible, int minimum, int maximum)
orientation
引数は、水平スクロールバーを示す値である Scrollbar.HORIZONTAL
または垂直スクロールバーを示す値である Scrollbar.VERTICAL
のどちらかでなければなりません。
指定された最大値が最小値より小さい場合、最大値は最小値と同じ値に変更されます。初期値が最小値より小さい場合、初期値は最小値と同じ値に変更されます。初期値が最大値より大きい場合、初期値は最大値と同じ値に変更されます。
orientation
- スクロールバーの方向を示すvalue
- スクロールバーの初期値visible
- 可視部分を表すスクロールバーのバブルのサイズ。スクロールバーはページ単位でスクロールするときにこの値を使用するminimum
- スクロールバーの最小値maximum
- スクロールバーの最大値メソッドの詳細 |
public void addNotify()
public int getOrientation()
Scrollbar.HORIZONTAL
または Scrollbar.VERTICAL
setOrientation(int)
public void setOrientation(int orientation)
orientation
- このスクロールバーの方向。Scrollbar.HORIZONTAL
または Scrollbar.VERTICAL
orientation
に指定された値が不正な値である場合getOrientation()
public int getValue()
getMinimum()
,
getMaximum()
public void setValue(int newValue)
指定された値が現在の最小値より小さい場合、この値は現在の最小値に置き換えられます。また、指定された値が現在の最大値より大きい場合、この値は現在の最大値に置き換えられます。
通常、プログラムは setValues
を呼び出すことによってのみ、スクロールバーの値を変更します。setValues
メソッドは、スクロールバーの最小値、最大値、可視量、および値プロパティを、互いに矛盾しないように同時に、同期的に設定します。
newValue
- スクロールバーの新しい値setValues(int, int, int, int)
,
getValue()
,
getMinimum()
,
getMaximum()
public int getMinimum()
getValue()
,
getMaximum()
public void setMinimum(int newMinimum)
通常、プログラムは setValues
を呼び出すことによってのみ、スクロールバーの最小値を変更します。setValues
メソッドは、スクロールバーの最小値、最大値、可視量、および値プロパティを、互いに矛盾しないように同時に、同期的に設定します。
newMinimum
- このスクロールバーの新しい最小値setValues(int, int, int, int)
,
setMaximum(int)
public int getMaximum()
getValue()
,
getMinimum()
public void setMaximum(int newMaximum)
通常、プログラムは setValues
を呼び出すことによってのみ、スクロールバーの最大値を変更します。setValues
メソッドは、スクロールバーの最小値、最大値、可視量、および値プロパティを、互いに矛盾しないように同時に、同期的に設定します。
newMaximum
- このスクロールバーの新しい最大値java.awtScrollbar#setValues
,
java.awtScrollbar#setMinimum
public int getVisibleAmount()
スクロールバーの可視量は、スクロールバーのバブルの幅によって表される値の範囲です。これはスクロールバーの「ブロック」増分値を判定するために使用されます。
setVisibleAmount(int)
public int getVisible()
getVisibleAmount()
に置き換えられました。public void setVisibleAmount(int newAmount)
スクロールバーの可視量は、スクロールバーのバブルの幅によって表される値の範囲です。これはスクロールバーの「ブロック」増分値を判定するために使用されます。
通常、プログラムは setValues
を呼び出すことによってのみ、スクロールバーの値を変更します。setValues
メソッドは、スクロールバーの最小値、最大値、可視量、および値プロパティを、互いに矛盾しないように同時に、同期的に設定します。
newAmount
- 1 ページ当りの表示量getVisibleAmount()
,
setValues(int, int, int, int)
public void setUnitIncrement(int v)
「ユニット」増分値は、ユーザがスクロールバーの「ユニット」増分値領域をアクティブ化したときに加算または減算される値です。これは通常、スクロールバーが調整イベントとして受け取るマウスジェスチャーまたはキーボードジェスチャーを通じて行われます。
v
- スクロールバーの値の増分値または減分値getUnitIncrement()
public void setLineIncrement(int v)
setUnitIncrement(int)
に置き換えられました。public int getUnitIncrement()
「ユニット」増分値は、ユーザがスクロールバーの「ユニット」増分値領域をアクティブ化したときに加算または減算される値です。これは通常、スクロールバーが調整イベントとして受け取るマウスジェスチャーまたはキーボードジェスチャーを通じて行われます。
setUnitIncrement(int)
public int getLineIncrement()
getUnitIncrement()
に置き換えられました。public void setBlockIncrement(int v)
「ブロック」増分値は、ユーザがスクロールバーの「ブロック」増分値領域をアクティブ化したときに加算または減算される値です。これは通常、スクロールバーが調整イベントとして受け取るマウスジェスチャーまたはキーボードジェスチャーを通じて行われます。
v
- スクロールバーの値を増分または減分する量getBlockIncrement()
public void setPageIncrement(int v)
setBlockIncrement()
に置き換えられました。public int getBlockIncrement()
「ブロック」増分値は、ユーザがスクロールバーの「ブロック」増分値領域をアクティブ化したときに加算または減算される値です。これは通常、スクロールバーが調整イベントとして受け取るマウスジェスチャーまたはキーボードジェスチャーを通じて行われます。
setBlockIncrement(int)
public int getPageIncrement()
getBlockIncrement()
に置き換えられました。public void setValues(int value, int visible, int minimum, int maximum)
このメソッドは、これらのプロパティの値が互いに矛盾しないことが保証されるように、スクロールバーの 4 つのプロパティ値を同時に、同期的に設定します。このメソッドは、最大値を最小値より小さくすることはできず、値を最小値より小さくしたり、最大値より大きくしたりできないという制約を適用します。
value
- 現在のウィンドウ内の位置visible
- ページごとの可視部分の量minimum
- スクロールバーの最大値maximum
- スクロールバーの最小値public void addAdjustmentListener(AdjustmentListener l)
AdjustmentEvent
のインスタンスを受け取るために、指定された調整リスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。l
- 調整リスナーAdjustmentEvent
,
AdjustmentListener
,
removeAdjustmentListener(java.awt.event.AdjustmentListener)
public void removeAdjustmentListener(AdjustmentListener l)
AdjustmentEvent
のインスタンスを受け取らないように、指定された調整リスナーを削除します。l が null の場合、例外はスローされず、処理も実行されません。l
- 調整リスナーAdjustmentEvent
,
AdjustmentListener
,
addAdjustmentListener(java.awt.event.AdjustmentListener)
protected void processEvent(AWTEvent e)
AdjustmentEvent
のインスタンスである場合は、processAdjustmentEvent
メソッドを呼び出します。そうでない場合は、スーパークラスの processEvent
メソッドを呼び出します。e
- イベントAdjustmentEvent
,
processAdjustmentEvent(java.awt.event.AdjustmentEvent)
protected void processAdjustmentEvent(AdjustmentEvent e)
AdjustmentListener
オブジェクトにディスパッチすることにより、調整イベントを処理します。
このコンポーネントに対して調整イベントが使用可能でない限り、このメソッドは呼び出されません。調整イベントは、次のどちらかの場合に使用可能になります。
AdjustmentListener
オブジェクトが addAdjustmentListener
によって登録されている
enableEvents
によって調整イベントが使用可能になっている
e
- 調整イベントAdjustmentEvent
,
AdjustmentListener
,
addAdjustmentListener(java.awt.event.AdjustmentListener)
,
Component.enableEvents(long)
protected String paramString()
|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |