|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
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 1.1 で導入された 5 つのタイプの調整イベントは、以前のバージョンのプラットフォームでスクロールバーに関連している 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
, 直列化された形式内部クラスの概要 | |
protected class |
Scrollbar.AccessibleAWTScrollBar
このクラスは Scrollbar クラス用のユーザ補助機能のサポートを実装しています。 |
クラス java.awt.Component から継承した内部クラス |
Component.AccessibleAWTComponent |
フィールドの概要 | |
static int |
HORIZONTAL
水平スクロールバーを示す定数です。 |
static int |
VERTICAL
垂直スクロールバーを示す定数です。 |
クラス java.awt.Component から継承したフィールド |
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
インタフェース java.awt.image.ImageObserver から継承したフィールド |
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
コンストラクタの概要 | |
Scrollbar()
新しい垂直スクロールバーを構築します。 |
|
Scrollbar(int orientation)
指定された方向の新しいスクロールバーを構築します。 |
|
Scrollbar(int orientation,
int value,
int visible,
int minimum,
int maximum)
指定された方向、初期値、ページサイズ、最小値、および最大値を持つ新しいスクロールバーを構築します。 |
メソッドの概要 | |
void |
addAdjustmentListener(AdjustmentListener l)
このスクロールバーから AdjustmentEvent のインスタンスを受け取るために、指定された調整リスナーを追加します。 |
void |
addNotify()
スクロールバーのピアを作成します。 |
AccessibleContext |
getAccessibleContext()
この Scrollbar に関連した AccessibleContext を返します。 |
int |
getBlockIncrement()
このスクロールバーの「ブロック」増分値を返します。 |
int |
getLineIncrement()
推奨されていません。 JDK バージョン 1.1 以降は、 getUnitIncrement() に置き換えられました。 |
EventListener[] |
getListeners(Class listenerType)
addXXXListener() によって Scrollbar に追加された全リスナーの配列を返します。 |
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 | Page Up キーまたは Page Down キーが 押されたとき、またはスクロールバー の末尾の矢印がクリックされた場合に 値が変化する量 | 1 |
block increment | Page Up キーまたは Page Down キーが 押されたとき、スクロールバーの トラックがバブルの片側でクリック された場合に値が変化する量 | 10 |
public Scrollbar(int orientation)
orientation
引数は、水平スクロールバーを示す値である Scrollbar.HORIZONTAL
または垂直スクロールバーを示す値である Scrollbar.VERTICAL
のどちらかでなければなりません。
orientation
- スクロールバーの方向を示すIllegalArgumentException
- 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()
Component
内の addNotify
java.awt.Component
からコピーされたタグ:Component.isDisplayable()
,
Component.removeNotify()
public int getOrientation()
Adjustable
内の getOrientation
Scrollbar.HORIZONTAL
または Scrollbar.VERTICAL
setOrientation(int)
public void setOrientation(int orientation)
orientation
- このスクロールバーの方向。Scrollbar.HORIZONTAL
または Scrollbar.VERTICAL
IllegalArgumentException
- orientation
に指定された値が不正な値である場合getOrientation()
public int getValue()
Adjustable
内の getValue
getMinimum()
,
getMaximum()
public void setValue(int newValue)
指定された値が現在の最小値より小さい場合、この値は現在の最小値に置き換えられます。また、指定された値が現在の最大値より大きい場合、この値は現在の最大値に置き換えられます。
通常、プログラムは setValues
を呼び出すことによってのみ、スクロールバーの値を変更します。setValues
メソッドは、スクロールバーの最小値、最大値、可視量、および値プロパティを、互いに矛盾しないように同時に、同期的に設定します。
Adjustable
内の setValue
newValue
- スクロールバーの新しい値setValues(int, int, int, int)
,
getValue()
,
getMinimum()
,
getMaximum()
public int getMinimum()
Adjustable
内の getMinimum
getValue()
,
getMaximum()
public void setMinimum(int newMinimum)
通常、プログラムは setValues
を呼び出すことによってのみ、スクロールバーの最小値を変更します。setValues
メソッドは、スクロールバーの最小値、最大値、可視量、および値プロパティを、互いに矛盾しないように同時に、同期的に設定します。
Adjustable
内の setMinimum
newMinimum
- このスクロールバーの新しい最小値setValues(int, int, int, int)
,
setMaximum(int)
public int getMaximum()
Adjustable
内の getMaximum
getValue()
,
getMinimum()
public void setMaximum(int newMaximum)
通常、プログラムは setValues
を呼び出すことによってのみ、スクロールバーの最大値を変更します。setValues
メソッドは、スクロールバーの最小値、最大値、可視量、および値プロパティを、互いに矛盾しないように同時に、同期的に設定します。
Adjustable
内の setMaximum
newMaximum
- このスクロールバーの新しい最大値setValues(int, int, int, int)
,
setMinimum(int)
public int getVisibleAmount()
スクロールバーの可視量は、スクロールバーのバブルの幅によって表される値の範囲です。これはスクロールバーの「ブロック」増分値を判定するために使用されます。
Adjustable
内の getVisibleAmount
setVisibleAmount(int)
public int getVisible()
getVisibleAmount()
に置き換えられました。
public void setVisibleAmount(int newAmount)
スクロールバーの可視量は、スクロールバーのバブルの幅によって表される値の範囲です。これはスクロールバーの「ブロック」増分値を判定するために使用されます。
通常、プログラムは setValues
を呼び出すことによってのみ、スクロールバーの値を変更します。setValues
メソッドは、スクロールバーの最小値、最大値、可視量、および値プロパティを、互いに矛盾しないように同時に、同期的に設定します。
Adjustable
内の setVisibleAmount
newAmount
- 1 ページ当りの表示量getVisibleAmount()
,
setValues(int, int, int, int)
public void setUnitIncrement(int v)
「ユニット」増分値は、ユーザがスクロールバーの「ユニット」増分値領域をアクティブ化したときに加算または減算される値です。これは通常、スクロールバーが調整イベントとして受け取るマウスジェスチャーまたはキーボードジェスチャーを通じて行われます。
Adjustable
内の setUnitIncrement
v
- スクロールバーの値を増分または減分する量getUnitIncrement()
public void setLineIncrement(int v)
setUnitIncrement(int)
に置き換えられました。
public int getUnitIncrement()
「ユニット」増分値は、ユーザがスクロールバーの「ユニット」増分値領域をアクティブ化したときに加算または減算される値です。これは通常、スクロールバーが調整イベントとして受け取るマウスジェスチャーまたはキーボードジェスチャーを通じて行われます。
Adjustable
内の getUnitIncrement
setUnitIncrement(int)
public int getLineIncrement()
getUnitIncrement()
に置き換えられました。
public void setBlockIncrement(int v)
「ブロック」増分値は、ユーザがスクロールバーの「ブロック」増分値領域をアクティブ化したときに加算または減算される値です。これは通常、スクロールバーが調整イベントとして受け取るマウスジェスチャーまたはキーボードジェスチャーを通じて行われます。
Adjustable
内の setBlockIncrement
v
- スクロールバーの値を増分または減分する量getBlockIncrement()
public void setPageIncrement(int v)
setBlockIncrement()
に置き換えられました。
public int getBlockIncrement()
「ブロック」増分値は、ユーザがスクロールバーの「ブロック」増分値領域をアクティブ化したときに加算または減算される値です。これは通常、スクロールバーが調整イベントとして受け取るマウスジェスチャーまたはキーボードジェスチャーを通じて行われます。
Adjustable
内の getBlockIncrement
setBlockIncrement(int)
public int getPageIncrement()
getBlockIncrement()
に置き換えられました。
public void setValues(int value, int visible, int minimum, int maximum)
このメソッドは、これらのプロパティの値が互いに矛盾しないことが保証されるように、スクロールバーの 4 つのプロパティ値を同時に、同期的に設定します。このメソッドは、最大値を最小値より小さくすることはできず、値を最小値より小さくしたり、最大値より大きくしたりできないという制約を適用します。
value
- 現在のウィンドウ内の位置visible
- 1 ページ当りの表示量minimum
- スクロールバーの最小値maximum
- スクロールバーの最大値public void addAdjustmentListener(AdjustmentListener l)
AdjustmentEvent
のインスタンスを受け取るために、指定された調整リスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。Adjustable
内の addAdjustmentListener
l
- 調整リスナーAdjustmentEvent
,
AdjustmentListener
,
removeAdjustmentListener(java.awt.event.AdjustmentListener)
public void removeAdjustmentListener(AdjustmentListener l)
AdjustmentEvent
のインスタンスを受け取らないように、指定された調整リスナーを削除します。l が null の場合、例外はスローされず、処理も実行されません。Adjustable
内の removeAdjustmentListener
l
- 調整リスナーAdjustmentEvent
,
AdjustmentListener
,
addAdjustmentListener(java.awt.event.AdjustmentListener)
public EventListener[] getListeners(Class listenerType)
listenerType
の引数の名前です。たとえば、指定された Scrollbar s
の AdjustmentListener(s) をすべて取得するには、次のように記述します。
AdjustmentListener[] als = (AdjustmentListener[])(s.getListeners(AdjustmentListener.class))該当するリスナーリストが存在しない場合は、空の配列が返されます。
Component
内の getListeners
listenerType
- 要求されたリスナーのタイプprotected void processEvent(AWTEvent e)
AdjustmentEvent
のインスタンスである場合は、processAdjustmentEvent
メソッドを呼び出します。そうでない場合は、スーパークラスの processEvent
メソッドを呼び出します。Component
内の 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()
Component
内の paramString
public AccessibleContext getAccessibleContext()
Accessible
内の getAccessibleContext
Component
内の getAccessibleContext
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.