java.awt
クラス ScrollPane

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.ScrollPane

すべての実装インタフェース:

Accessible, ImageObserver, MenuContainer, Serializable

public class ScrollPane

extends Container

implements Accessible

1 つの子コンポーネントに対して、自動水平または垂直スクロールあるいはその両方を実装するコンテナクラスです。スクロールバーの表示ポリシーは、次のどれかに設定することができます。

1. as needed: スクロールバーはスクロールペインが必要としたときにだけ作成され表示されます。
2. always: スクロールバーは作成され、常にスクロールペインによって表示されます。
3. never: スクロールバーは作成されることも、スクロールペインによって表示されることもありません。

水平スクロールバーおよび垂直スクロールバーの状態は、Adjustable インタフェースを実装する 2 つのオブジェクト (次元ごとに 1 つずつ) によって表されます。API は Adjustable オブジェクトの属性 (unitIncrement や value など) を操作できるように、これらのオブジェクトにアクセスするメソッドを提供します。

一部の調節可能なプロパティ (minimum、maximum、blockIncrement、visibleAmount) は、スクロールペインおよびその子のジオメトリに従ってスクロールペインによって内部的に設定されます。これらのプロパティはスクロールペインを使ってプログラムで設定しないでください。

スクロールバーの表示ポリシーが "never" であれば、そのスクロールペインは setScrollPosition() メソッドを使用してプログラム的にスクロールすることができ、スクロールペインは移動して子の内容を適切にクリップします。このポリシーは、プログラムが独自の調節可能なコントロールを作成して管理しなければならないときに便利です。

スクロールバーの配置は、ユーザがプログラムの外で設定するプラットフォーム固有のプロパティで制御されます。

このコンテナの初期サイズは 100×100 に設定されていますが、setSize() を使用して変えることができます。

Insets はスクロールバーが使用する任意の領域およびスクロールペインが作成する任意の境界を定義するために使われます。getInsets() を使用して insets の現在値を得ることができます。scrollbarsAlwaysVisible の値が false であれば、insets の値はスクロールバーが、現在可視状態かどうかによって動的に変化します。

関連項目:

直列化された形式

内部クラスの概要

protected class

ScrollPane.AccessibleAWTScrollPane このクラスは ScrollbarPane クラス用のユーザ補助機能のサポートを実装しています。

クラス java.awt.Container から継承した内部クラス

Container.AccessibleAWTContainer

クラス java.awt.Component から継承した内部クラス

Component.AccessibleAWTComponent

フィールドの概要

static int	SCROLLBARS_ALWAYS スクロールペインと子の大きさにかかわらず、常に水平/垂直スクロールバーを表示することを示します。
static int	SCROLLBARS_AS_NEEDED 子の大きさがスクロールペインの水平/垂直方向の大きさを超えるときにだけ、水平/垂直スクロールバーを表示することを示します。
static int	SCROLLBARS_NEVER スクロールペインと子の大きさにかかわらず、常に水平/垂直スクロールバーを表示しないことを示します。

クラス 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

コンストラクタの概要

ScrollPane()
スクロールバー表示ポリシーが "as needed" である新しいスクロールペインコンテナを作成します。

ScrollPane(int scrollbarDisplayPolicy)
新しいスクロールペインコンテナを作成します。

メソッドの概要

protected void	addImpl(Component comp, Object constraints, int index) 指定されたコンポーネントを、このスクロールペインコンテナに追加します。
void	addNotify() スクロールペインのピアを作成します。
void	doLayout() 子のサイズを推奨サイズに変更してこのコンテナをレイアウトします。
AccessibleContext	getAccessibleContext() この ScrollPane に関連した AccessibleContext を返します。
Adjustable	getHAdjustable() 水平スクロールバーの状態を表す Adjustable オブジェクトを返します。
int	getHScrollbarHeight() 水平スクロールバーに占める高さを返します。
int	getScrollbarDisplayPolicy() スクロールバーの表示ポリシーを返します。
Point	getScrollPosition() スクロールしたペインのビューポートの 0, 0 位置に表示される子内の現在の x, y 位置を返します。
Adjustable	getVAdjustable() 垂直スクロールバーの状態を表す Adjustable オブジェクトを返します。
Dimension	getViewportSize() スクロールペインのビューポートの現在のサイズを返します。
int	getVScrollbarWidth() 垂直スクロールバーに占める幅を返します。
void	layout() 推奨されていません。 JDK バージョン 1.1 以降は、doLayout() に置き換えられました。
String	paramString() このコンテナの状態を表すパラメータ文字列を返します。
void	printComponents(Graphics g) このスクロールペイン内のコンポーネントを出力します。
void	setLayout(LayoutManager mgr) このコンテナのレイアウトマネージャを設定します。
void	setScrollPosition(int x, int y) 子コンポーネント内の指定された位置へスクロールします。
void	setScrollPosition(Point p) 子コンポーネント内の指定された位置へスクロールします。

クラス java.awt.Container から継承したメソッド

add, add, add, add, add, addContainerListener, countComponents, deliverEvent, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setFont, update, validate, validateTree

クラス java.awt.Component から継承したメソッド

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, isLightweight, isOpaque, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, show, size, toString, transferFocus

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

フィールドの詳細

SCROLLBARS_AS_NEEDED

public static final int SCROLLBARS_AS_NEEDED

子の大きさがスクロールペインの水平/垂直方向の大きさを超えるときにだけ、水平/垂直スクロールバーを表示することを示します。

SCROLLBARS_ALWAYS

public static final int SCROLLBARS_ALWAYS

スクロールペインと子の大きさにかかわらず、常に水平/垂直スクロールバーを表示することを示します。

SCROLLBARS_NEVER

public static final int SCROLLBARS_NEVER

スクロールペインと子の大きさにかかわらず、常に水平/垂直スクロールバーを表示しないことを示します。

コンストラクタの詳細

ScrollPane

public ScrollPane()

スクロールバー表示ポリシーが "as needed" である新しいスクロールペインコンテナを作成します。

ScrollPane

public ScrollPane(int scrollbarDisplayPolicy)

新しいスクロールペインコンテナを作成します。

パラメータ:

scrollbarDisplayPolicy - スクロールバーを表示する場合を示すポリシー

メソッドの詳細

addImpl

protected final void addImpl(Component comp,
                             Object constraints,
                             int index)

指定されたコンポーネントを、このスクロールペインコンテナに追加します。スクロールペインが既存の子コンポーネントを持つ場合、そのコンポーネントが削除され、新しいコンポーネントが追加されます。

オーバーライド:

クラス Container 内の addImpl

パラメータ:

comp - 追加されるコンポーネント

constraints - 適用外

index - 子コンポーネントの位置 (<= 0 でなければならない)

getScrollbarDisplayPolicy

public int getScrollbarDisplayPolicy()

スクロールバーの表示ポリシーを返します。

戻り値:

スクロールバーの表示ポリシー

getViewportSize

public Dimension getViewportSize()

スクロールペインのビューポートの現在のサイズを返します。

戻り値:

ピクセル単位のビューポートのサイズ

getHScrollbarHeight

public int getHScrollbarHeight()

水平スクロールバーに占める高さを返します。これは、スクロールペインが現在それを表示しているかどうかとは無関係です。

戻り値:

ピクセル単位の水平スクロールバーの高さ

getVScrollbarWidth

public int getVScrollbarWidth()

垂直スクロールバーに占める幅を返します。これは、スクロールペインが現在それを表示しているかどうかとは無関係です。

戻り値:

ピクセル単位の垂直スクロールバーの幅

getVAdjustable

public Adjustable getVAdjustable()

垂直スクロールバーの状態を表す Adjustable オブジェクトを返します。

getHAdjustable

public Adjustable getHAdjustable()

水平スクロールバーの状態を表す Adjustable オブジェクトを返します。

setScrollPosition

public void setScrollPosition(int x,
                              int y)

子コンポーネント内の指定された位置へスクロールします。このメソッドの呼び出しはスクロールペインが子を含む場合にだけ有効です。子が許されるスクロール範囲外の位置を指定した場合、もっとも近い許される位置へスクロールします。許される範囲は、矩形 x = 0、y = 0、幅 = (子の幅 - ビューポート幅)、高さ = (子の高さ - ビューポートの高さ) で定義されます。これはスクロールバーの状態を表す Adjustable オブジェクトとのインタフェースを持つ便利なメソッドです。

パラメータ:

x - スクロール先の x 位置

y - スクロール先の y 位置

setScrollPosition

public void setScrollPosition(Point p)

子コンポーネント内の指定された位置へスクロールします。このメソッドの呼び出しはスクロールペインが子を含む場合にだけ有効です。子が許されるスクロール範囲外の位置を指定した場合、もっとも近い許される位置へスクロールします。許される範囲は、矩形 x =0、y = 0、幅 = (子の幅 - ビューポート幅)、高さ = (子の高さ - ビューポートの高さ) で定義されます。これはスクロールバーの状態を表す Adjustable オブジェクトとのインタフェースを持つ便利なメソッドです。

パラメータ:

p - スクロール先の位置を表す点

getScrollPosition

public Point getScrollPosition()

スクロールしたペインのビューポートの 0, 0 位置に表示される子内の現在の x, y 位置を返します。これはスクロールバーの状態を表す Adjustable オブジェクトとのインタフェースを持つ便利なメソッドです。

戻り値:

現在のスクロール位置の座標位置

setLayout

public final void setLayout(LayoutManager mgr)

このコンテナのレイアウトマネージャを設定します。レイアウトマネージャが設定されるのを防ぐにはこのメソッドをオーバーライドします。

オーバーライド:

クラス Container 内の setLayout

パラメータ:

mgr - 指定されたレイアウトマネージャ

doLayout

public void doLayout()

子のサイズを推奨サイズに変更してこのコンテナをレイアウトします。子の新しい推奨サイズでは現在のスクロール位置が不正になる場合、スクロール位置はもっとも近い許される位置に設定されます。

オーバーライド:

クラス Container 内の doLayout

関連項目:

Component.validate()

layout

public void layout()

推奨されていません。 JDK バージョン 1.1 以降は、doLayout() に置き換えられました。

オーバーライド:

クラス Container 内の layout

printComponents

public void printComponents(Graphics g)

このスクロールペイン内のコンポーネントを出力します。

オーバーライド:

クラス Container 内の printComponents

パラメータ:

g - 指定された Graphics ウィンドウ

関連項目:

Component.print(java.awt.Graphics), Component.printAll(java.awt.Graphics)

addNotify

public void addNotify()

スクロールペインのピアを作成します。

オーバーライド:

クラス Container 内の addNotify

クラス java.awt.Container からコピーされたタグ:

関連項目:

Component.isDisplayable(), Container.removeNotify()

paramString

public String paramString()

クラス Container の記述:

このコンテナの状態を表すパラメータ文字列を返します。この文字列はデバッグの際に便利です。

オーバーライド:

クラス Container 内の paramString

クラス java.awt.Container からコピーされたタグ:

戻り値:

このコンテナのパラメータ文字列

getAccessibleContext

public AccessibleContext getAccessibleContext()

この ScrollPane に関連した AccessibleContext を返します。スクロールペインの場合、AccessibleContext は AccessibleAWTScrollPane の形式を取ります。必要に応じて新しい AccessibleAWTScrollPane インスタンスを作成します。

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス Component 内の getAccessibleContext

戻り値:

この ScrollPane の AccessibleContext として機能する AccessibleAWTScrollPane