モジュール java.desktop
パッケージ 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の値はスクロール・バーが、現在可視状態かどうかによって動的に変化します。

    関連項目:
    直列化された形式

    • フィールドの詳細

      • 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
        スクロール・ペインと子の大きさにかかわらず、常に水平/垂直スクロール・バーを表示しないことを示します。
        関連項目:
        定数フィールド値

    • コンストラクタの詳細

    • メソッドの詳細

      • 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

      • paramString

        public String paramString()
        このScrollPaneの状態を表す文字列を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる場合があります。 返される文字列は空の場合がありますが、nullにはなりません。
        オーバーライド:
        paramString、クラスContainer
        戻り値:
        このスクロール・ペインのパラメータ文字列

      • 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()
        マウス・ホイールに応答してスクロールが行われるかどうかを示します。 ホイール・スクロールはデフォルトで有効です。
        戻り値:
        ホイールのスクロールが有効になっている場合はtrue;そうでなければfalse
        導入されたバージョン:
        1.4
        関連項目:
        setWheelScrollingEnabled(boolean)

      • getAccessibleContext

        public AccessibleContext getAccessibleContext()
        このScrollPaneに関連付けられたAccessibleContextを取得します。 スクロール・ペインの場合、AccessibleContextはAccessibleAWTScrollPaneの形式を取ります。 必要に応じて新規のAccessibleAWTScrollPaneインスタンスが作成されます。
        定義:
        getAccessibleContext、インタフェースAccessible
        オーバーライド:
        getAccessibleContext、クラスComponent
        戻り値:
        このScrollPaneのAccessibleContextとして機能するAccessibleAWTScrollPane
        導入されたバージョン:
        1.3