java.awt

クラス ScrollPane

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.ScrollPane

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

ImageObserver, MenuContainer, Serializable, Accessible

public class ScrollPane
extends Container
implements Accessible

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

1. as needed:スクロールバーはスクロールペインが必要としたときにだけ作成および表示される
2. always:スクロールバーは作成され、常にスクロールペインによって表示される
3. never:スクロールバーは作成されることも、スクロールペインによって表示されることもない

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

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

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

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

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

ホイールマウスのホイールによるスクロールはデフォルトで使用可能です。これは setWheelScrollingEnabled を使って使用不可にできます。ホイールスクロールは水平および垂直方向の Adjustables のブロックおよびユニット増分値の設定によりカスタマイズできます。マウスホイールイベントがディスパッチされる方法については、MouseWheelEvent のクラスの説明を参照してください。

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

関連項目:

直列化された形式

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
protected class	ScrollPane.AccessibleAWTScrollPane このクラスは ScrollPane クラスのアクセシビリティーサポートを実装しています。

クラス java.awt.Container から継承されたネストされたクラス/インタフェース

Container.AccessibleAWTContainer

クラス java.awt.Component から継承されたネストされたクラス/インタフェース

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
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() 子のサイズを推奨サイズに変更してこのコンテナをレイアウトします。
protected boolean	eventTypeEnabled(int type) ホイールスクロールが有効な場合、MouseWheelEvents に対して true を返します。
AccessibleContext	getAccessibleContext() この ScrollPane に関連付けられた AccessibleContext を取得します。
Adjustable	getHAdjustable() 水平スクロールバーの状態を表す ScrollPaneAdjustable オブジェクトを返します。
int	getHScrollbarHeight() 水平スクロールバーに占める高さを返します。これは、スクロールペインが現在それを表示しているかどうかとは無関係です。
int	getScrollbarDisplayPolicy() スクロールバーの表示ポリシーを返します。
Point	getScrollPosition() スクロールしたペインのビューポートの 0, 0 位置に表示される子内の現在の x, y 位置を返します。
Adjustable	getVAdjustable() 垂直スクロールバーの状態を表す ScrollPaneAdjustable オブジェクトを返します。
Dimension	getViewportSize() スクロールペインのビューポートの現在のサイズを返します。
int	getVScrollbarWidth() 垂直スクロールバーに占める幅を返します。これは、スクロールペインが現在それを表示しているかどうかとは無関係です。
boolean	isWheelScrollingEnabled() マウスホイールに応答してスクロールが行われるかどうかを示します。
void	layout() 非推奨。 JDK version 1.1 以降は、doLayout() に置き換えられています。
String	paramString() この ScrollPane の状態を表す文字列を返します。
void	printComponents(Graphics g) このスクロールペイン内のコンポーネントを出力します。
protected void	processMouseWheelEvent(MouseWheelEvent e) この ScrollPane に配信されるマウスホイールイベントを、適切な量だけスクロールすることによって処理します。
void	setLayout(LayoutManager mgr) このコンテナのレイアウトマネージャーを設定します。
void	setScrollPosition(int x, int y) 子コンポーネント内の指定された位置へスクロールします。
void	setScrollPosition(Point p) 子コンポーネント内の指定された位置へスクロールします。
void	setWheelScrollingEnabled(boolean handleWheel) マウスホイールの移動に応答してスクロールを有効または無効にします。

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

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, isValidateRoot, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, update, validate, validateTree

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, 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, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

クラス 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()
           throws HeadlessException

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

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless()

ScrollPane

@ConstructorProperties(value="scrollbarDisplayPolicy")
public ScrollPane(int scrollbarDisplayPolicy)
           throws HeadlessException

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

パラメータ:

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

例外:

IllegalArgumentException - 指定されたスクロールバーの表示ポリシーが無効な場合

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless()

メソッドの詳細

addImpl

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

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

オーバーライド:

addImpl、クラス: Container

パラメータ:

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

constraints - 適用外

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

関連項目:

Container.add(Component), Container.add(Component, int), Container.add(Component, java.lang.Object), Container.invalidate(), LayoutManager, LayoutManager2

getScrollbarDisplayPolicy

public int getScrollbarDisplayPolicy()

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

戻り値:

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

getViewportSize

public Dimension getViewportSize()

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

戻り値:

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

getHScrollbarHeight

public int getHScrollbarHeight()

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

戻り値:

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

getVScrollbarWidth

public int getVScrollbarWidth()

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

戻り値:

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

getVAdjustable

public Adjustable getVAdjustable()

垂直スクロールバーの状態を表す ScrollPaneAdjustable オブジェクトを返します。このメソッドの宣言された戻り値の型は、下位互換性を維持するために Adjustable になっています。

関連項目:

ScrollPaneAdjustable

getHAdjustable

public Adjustable getHAdjustable()

水平スクロールバーの状態を表す ScrollPaneAdjustable オブジェクトを返します。このメソッドの宣言された戻り値の型は、下位互換性を維持するために Adjustable になっています。

関連項目:

ScrollPaneAdjustable

setScrollPosition

public void setScrollPosition(int x,
                     int y)

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

パラメータ:

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

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

例外:

NullPointerException - スクロールペインに子が含まれていない場合

setScrollPosition

public void setScrollPosition(Point p)

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

パラメータ:

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

例外:

NullPointerException - p が null である場合

getScrollPosition

public Point getScrollPosition()

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

戻り値:

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

例外:

NullPointerException - スクロールペインに子が含まれていない場合

setLayout

public final void setLayout(LayoutManager mgr)

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

オーバーライド:

setLayout、クラス: Container

パラメータ:

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

関連項目:

Container.doLayout(), Container.getLayout(), Container.invalidate()

doLayout

public void doLayout()

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

オーバーライド:

doLayout、クラス: Container

関連項目:

Component.validate()

layout

@Deprecated
public void layout()

非推奨。 JDK Version 1.1 以降は、doLayout() に置き換えられています。

オーバーライド:

layout、クラス: Container

printComponents

public void printComponents(Graphics g)

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

オーバーライド:

printComponents、クラス: Container

パラメータ:

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

関連項目:

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

addNotify

public void addNotify()

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

オーバーライド:

addNotify、クラス: Container

関連項目:

Component.isDisplayable(), Container.removeNotify()

paramString

public String paramString()

この ScrollPane の状態を表す文字列を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

オーバーライド:

paramString、クラス: Container

戻り値:

このスクロールペインのパラメータ文字列

processMouseWheelEvent

protected void processMouseWheelEvent(MouseWheelEvent e)

この ScrollPane に配信されるマウスホイールイベントを、適切な量だけスクロールすることによって処理します。

イベントパラメータが null である場合は、動作が未指定のため、例外が発生する可能性があります。

オーバーライド:

processMouseWheelEvent、クラス: Component

パラメータ:

e - マウスホイールイベント

導入されたバージョン:

1.4

関連項目:

MouseWheelEvent, MouseWheelListener, Component.addMouseWheelListener(java.awt.event.MouseWheelListener), Component.enableEvents(long)

eventTypeEnabled

protected boolean eventTypeEnabled(int type)

ホイールスクロールが有効な場合、MouseWheelEvents に対して true を返します。

導入されたバージョン:

1.4

setWheelScrollingEnabled

public void setWheelScrollingEnabled(boolean handleWheel)

マウスホイールの移動に応答してスクロールを有効または無効にします。ホイールスクロールはデフォルトで有効です。

パラメータ:

handleWheel - MouseWheelEvent に対してスクロールが自動的に行われる場合は true、そうでない場合は false。

導入されたバージョン:

1.4

関連項目:

isWheelScrollingEnabled(), MouseWheelEvent, MouseWheelListener

isWheelScrollingEnabled

public boolean isWheelScrollingEnabled()

マウスホイールに応答してスクロールが行われるかどうかを示します。ホイールスクロールはデフォルトで有効です。

導入されたバージョン:

1.4

関連項目:

setWheelScrollingEnabled(boolean)

getAccessibleContext

public AccessibleContext getAccessibleContext()

この ScrollPane に関連付けられた AccessibleContext を取得します。スクロールペインの場合、AccessibleContext は AccessibleAWTScrollPane の形式を取ります。必要に応じて新規の AccessibleAWTScrollPane インスタンスが作成されます。

定義:

getAccessibleContext、インタフェース: Accessible

オーバーライド:

getAccessibleContext、クラス: Component

戻り値:

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

導入されたバージョン:

1.3