|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.JScrollBar
スクロールバーの実装です。ユーザはスクロールバーのノブを移動して表示するコンテンツ領域を決めます。プログラムは、通常、スクロールバーの終端が表示可能コンテンツの終端または 100% になるように表示を調整します。スクロールバーの先端は表示可能コンテンツの先端または 0% になります。そのような境界内でのノブの位置は対応する表示可能コンテンツのパーセンテージに変換されます。
通常、スクロールバー内でのノブの位置が変更されると、基になるビュー内での JViewPort の位置に対して変更が行われ、JViewPort のコンテンツが変更されます。
警告:
このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK バージョン 1.4 以降、すべての JavaBeansTM の長期間の運用サポートは、java.beans
パッケージに追加されています。詳細は、XMLEncoder
を参照してください。
JScrollPane
入れ子クラスの概要 | |
protected class |
JScrollBar.AccessibleJScrollBar
このクラスは JScrollBar クラス用のユーザ補助機能のサポートを実装しています。 |
クラス javax.swing.JComponent から継承した入れ子クラス |
|
クラス java.awt.Container から継承した入れ子クラス |
|
クラス java.awt.Component から継承した入れ子クラス |
Component.BltBufferStrategy, Component.FlipBufferStrategy |
フィールドの概要 | |
protected int |
blockIncrement
|
protected BoundedRangeModel |
model
スクロールバーの最小値、最大値、長さ (可視量とも呼ぶ)、および現在値を表すモデルです。 |
protected int |
orientation
|
protected int |
unitIncrement
|
クラス javax.swing.JComponent から継承したフィールド |
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW |
クラス java.awt.Component から継承したフィールド |
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
インタフェース java.awt.Adjustable から継承したフィールド |
HORIZONTAL, NO_ORIENTATION, VERTICAL |
インタフェース java.awt.image.ImageObserver から継承したフィールド |
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
コンストラクタの概要 | |
JScrollBar()
以下の初期値を指定して垂直スクロールバーを作成します。 |
|
JScrollBar(int orientation)
方向と以下の初期値を指定してスクロールバーを作成します。 |
|
JScrollBar(int orientation,
int value,
int extent,
int min,
int max)
方向、値、長さ、最小値、最大値を指定してスクロールバーを作成します。 |
メソッドの概要 | |
void |
addAdjustmentListener(AdjustmentListener l)
AdjustmentListener を追加します。 |
protected void |
fireAdjustmentValueChanged(int id,
int type,
int value)
|
AccessibleContext |
getAccessibleContext()
この JScrollBar に関連した AccessibleContext を返します。 |
AdjustmentListener[] |
getAdjustmentListeners()
addAdjustmentListener() を使用してこの JScrollBar に追加されるすべての AdjustmentListener の配列を返します。 |
int |
getBlockIncrement()
java.awt.Scrollbar との下位互換性のために提供されるメソッドです。 |
int |
getBlockIncrement(int direction)
ブロック (通常は「ページ」) アップ/ダウン要求に対応する、スクロールバーの値を変更する量を返します。 |
int |
getMaximum()
スクロールバーの最大値は、最大値 - 長さになります。 |
Dimension |
getMaximumSize()
スクロールバーはスクロール軸に沿った方向では自由にサイズ変更できますが、もう一方の軸の方向のサイズは固定になります。 |
int |
getMinimum()
スクロールバーによってサポートされている最小値を返します (通常は 0)。 |
Dimension |
getMinimumSize()
スクロールバーはスクロール軸に沿った方向では自由にサイズ変更できますが、もう一方の軸の方向のサイズは固定になります。 |
BoundedRangeModel |
getModel()
最小値、最大値、値、長さという、スクロールバーの 4 つの基本プロパティを処理するデータモデルを返します。 |
int |
getOrientation()
コンポーネントの方向 (水平または垂直) を返します。 |
ScrollBarUI |
getUI()
このコンポーネントの Look & Feel を実装する委譲オブジェクトを返します。 |
String |
getUIClassID()
このコンポーネントの LookAndFeel クラスの名前を返します。 |
int |
getUnitIncrement()
java.awt.Scrollbar との下位互換性のために提供されるメソッドです。 |
int |
getUnitIncrement(int direction)
ユニットアップ/ダウン要求に対応するスクロールバーの値を変更する量を返します。 |
int |
getValue()
スクロールバーの値を返します。 |
boolean |
getValueIsAdjusting()
スクロールバーのノブがドラッグされている場合に true を返します。 |
int |
getVisibleAmount()
スクロールバーの長さ、つまり 「visibleAmount」を返します。 |
protected String |
paramString()
この JScrollBar の文字列表現を返します。 |
void |
removeAdjustmentListener(AdjustmentListener l)
AdjustmentEvent リスナーを削除します。 |
void |
setBlockIncrement(int blockIncrement)
blockIncrement プロパティを設定します。 |
void |
setEnabled(boolean x)
コンポーネントを使用可能にして、ノブの位置が変更できるようにします。 |
void |
setMaximum(int maximum)
モデルの最大値プロパティを設定します。 |
void |
setMinimum(int minimum)
モデルの最小値プロパティを設定します。 |
void |
setModel(BoundedRangeModel newModel)
最小値、最大値、値、長さという、スクロールバーの 4 つの基本プロパティを処理するデータモデルを設定します。 |
void |
setOrientation(int orientation)
スクロールバーの方向を水平または垂直に設定します。 |
void |
setUI(ScrollBarUI ui)
このコンポーネントを描画する L&F オブジェクトを設定します。 |
void |
setUnitIncrement(int unitIncrement)
unitIncrement プロパティを設定します。 |
void |
setValue(int value)
スクロールバーの値を設定します。 |
void |
setValueIsAdjusting(boolean b)
モデルの valueIsAdjusting プロパティを設定します。 |
void |
setValues(int newValue,
int newExtent,
int newMin,
int newMax)
引数が次の通常の制約に従うように強制したあとで、4 つの BoundedRangeModel プロパティを設定します。 |
void |
setVisibleAmount(int extent)
モデルの長さプロパティを設定します。 |
void |
updateUI()
JComponent.updateUI をオーバーライドします。 |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
フィールドの詳細 |
protected BoundedRangeModel model
setModel(javax.swing.BoundedRangeModel)
protected int orientation
setOrientation(int)
protected int unitIncrement
setUnitIncrement(int)
protected int blockIncrement
setBlockIncrement(int)
コンストラクタの詳細 |
public JScrollBar(int orientation, int value, int extent, int min, int max)
注: setBlockIncrement
を使うと、「ブロック」増分値をビューの長さより少し小さいサイズに設定できます。その場合、ユーザがノブを隣の位置に移動すると、元のコンテンツの 1 行または 2 行がビューに残ります。
IllegalArgumentException
- 方向が VERTICAL、HORIZONTAL のどちらでもない場合setOrientation(int)
,
setValue(int)
,
setVisibleAmount(int)
,
setMinimum(int)
,
setMaximum(int)
public JScrollBar(int orientation)
minimum = 0 maximum = 100 value = 0 extent = 10
public JScrollBar()
minimum = 0 maximum = 100 value = 0 extent = 10
メソッドの詳細 |
public void setUI(ScrollBarUI ui)
ui
- ScrollBarUI
の L&F オブジェクトUIDefaults.getUI(javax.swing.JComponent)
public ScrollBarUI getUI()
JComponent.setUI(javax.swing.plaf.ComponentUI)
public void updateUI()
JComponent.updateUI
をオーバーライドします。
JComponent
内の updateUI
JComponent.updateUI()
public String getUIClassID()
JComponent
内の getUIClassID
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public int getOrientation()
Adjustable
内の getOrientation
setOrientation(int)
,
Adjustable.getOrientation()
public void setOrientation(int orientation)
IllegalArgumentException
- 方向が VERTICAL、HORIZONTAL のどちらでもない場合getOrientation()
public BoundedRangeModel getModel()
setModel(javax.swing.BoundedRangeModel)
public void setModel(BoundedRangeModel newModel)
getModel()
public int getUnitIncrement(int direction)
JScrollPane コンポーネントは、このメソッドをオーバーライドし、ビューポートの Scrollable ビューがあればそれに委譲するスクロールバーを作成します (デフォルト)。Scrollable インタフェースは、このメソッドのより特殊なバージョンを提供します。
direction
- アップの場合は -1、ダウンの場合は 1
setUnitIncrement(int)
,
setValue(int)
,
Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int)
public void setUnitIncrement(int unitIncrement)
Adjustable
内の setUnitIncrement
unitIncrement
- ユニット増分値getUnitIncrement(int)
public int getBlockIncrement(int direction)
JScrollPane コンポーネントは、このメソッドをオーバーライドし、ビューポートの Scrollable ビューがあればそれに委譲するスクロールバーを作成します (デフォルト)。Scrollable インタフェースは、このメソッドのより特殊なバージョンを提供します。
direction
- アップの場合は -1、ダウンの場合は 1
setBlockIncrement(int)
,
setValue(int)
,
Scrollable.getScrollableBlockIncrement(java.awt.Rectangle, int, int)
public void setBlockIncrement(int blockIncrement)
Adjustable
内の setBlockIncrement
blockIncrement
- ブロック増分値getBlockIncrement()
public int getUnitIncrement()
Adjustable
内の getUnitIncrement
Adjustable.getUnitIncrement()
,
getUnitIncrement(int)
public int getBlockIncrement()
Adjustable
内の getBlockIncrement
Adjustable.getBlockIncrement()
,
getBlockIncrement(int)
public int getValue()
Adjustable
内の getValue
setValue(int)
public void setValue(int value)
Adjustable
内の setValue
value
- 現在の値getValue()
,
BoundedRangeModel.setValue(int)
public int getVisibleAmount()
Adjustable
内の getVisibleAmount
setVisibleAmount(int)
public void setVisibleAmount(int extent)
Adjustable
内の setVisibleAmount
extent
- インジケータの長さgetVisibleAmount()
,
BoundedRangeModel.setExtent(int)
public int getMinimum()
Adjustable
内の getMinimum
setMinimum(int)
public void setMinimum(int minimum)
Adjustable
内の setMinimum
minimum
- 最小値getMinimum()
,
BoundedRangeModel.setMinimum(int)
public int getMaximum()
Adjustable
内の getMaximum
setMaximum(int)
public void setMaximum(int maximum)
Adjustable
内の setMaximum
maximum
- 最大値getMaximum()
,
BoundedRangeModel.setMaximum(int)
public boolean getValueIsAdjusting()
setValueIsAdjusting(boolean)
public void setValueIsAdjusting(boolean b)
getValueIsAdjusting()
,
BoundedRangeModel.setValueIsAdjusting(boolean)
public void setValues(int newValue, int newExtent, int newMin, int newMax)
minimum <= value <= value+extent <= maximum
BoundedRangeModel.setRangeProperties(int, int, int, int, boolean)
,
setValue(int)
,
setVisibleAmount(int)
,
setMinimum(int)
,
setMaximum(int)
public void addAdjustmentListener(AdjustmentListener l)
AdjustmentEvent タイプのプロパティは、常に AdjustmentEvent.TRACK のプレースホルダ値を持つことに注意してください。これは BoundedRangeModel 値に対する変更はすべて等価と見なされるためです。BoundedRangeModel の値を変更するには、値プロパティ、つまり model.setValue(123) を設定するだけです。たとえばブロックデクリメントであるなど、変更の原因についての情報は提供されません。ここで変更の原因を作り出すこともしません。
Adjustable
内の addAdjustmentListener
l
- 追加する AdjustmentListerremoveAdjustmentListener(java.awt.event.AdjustmentListener)
,
BoundedRangeModel.addChangeListener(javax.swing.event.ChangeListener)
public void removeAdjustmentListener(AdjustmentListener l)
Adjustable
内の removeAdjustmentListener
l
- 削除する AdjustmentListeraddAdjustmentListener(java.awt.event.AdjustmentListener)
public AdjustmentListener[] getAdjustmentListeners()
AdjustmentListener
の配列を返します。
AdjustmentListener
、またはリスナーが追加されていない場合は空の配列protected void fireAdjustmentValueChanged(int id, int type, int value)
public Dimension getMinimumSize()
JComponent
内の getMinimumSize
minimumSize
プロパティの値JComponent.setMinimumSize(java.awt.Dimension)
,
ComponentUI
public Dimension getMaximumSize()
JComponent
内の getMaximumSize
maximumSize
プロパティの値JComponent.setMaximumSize(java.awt.Dimension)
,
ComponentUI
public void setEnabled(boolean x)
JComponent
内の setEnabled
x
- このコンポーネントを有効化する場合は true、そうでない場合は falseComponent.isEnabled()
,
Component.isLightweight()
protected String paramString()
null
にはなりません。
JComponent
内の paramString
public AccessibleContext getAccessibleContext()
Accessible
内の getAccessibleContext
JComponent
内の getAccessibleContext
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.