JavaTM 2
Platform
Std. Ed. v1.4.0

javax.swing
インタフェース Scrollable

既知の実装クラスの一覧:
JList, JTable, JTextComponent, JTree

public interface Scrollable

JScrollPane などのスクロールコンテナに情報を提供するインタフェースです。JScrollPane ビューポート (または他のスクロールコンテナ) でビューとして使われる可能性のある複合コンポーネントは、このインタフェースを実装しなければなりません。

関連項目:
JViewport, JScrollPane, JScrollBar

メソッドの概要
 Dimension getPreferredScrollableViewportSize()
          ビューコンポーネントのビューポートの適切なサイズを返します。
 int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
          論理行または論理列を表示するコンポーネントは、orientation の値によって、1 ブロック分の行または列を完全にエクスポーズするスクロール増分値を計算します。
 boolean getScrollableTracksViewportHeight()
          ビューポートでこの Scrollable の高さを常にビューポートの高さに合わせる場合に、true を返します。
 boolean getScrollableTracksViewportWidth()
          ビューポートが、常にこの Scrollable の幅を強制的にビューポートの幅に一致させようとする場合は、true を返します。
 int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
          論理行または論理列を表示するコンポーネントは、orientation の値によって、新しい 1 行または 1 列を完全にエクスポーズするスクロール増分値を計算します。
 

メソッドの詳細

getPreferredScrollableViewportSize

public Dimension getPreferredScrollableViewportSize()
ビューコンポーネントのビューポートの適切なサイズを返します。たとえば、JList コンポーネントの preferredSize は、そのリストのセルをすべて収めるために必要なサイズですが、preferredScrollableViewportSize の値は、JList.getVisibleRowCount() 行を収めるために必要なサイズです。ビューポートのサイズを設定するプロパティがないコンポーネントは、ここで getPreferredSize() だけを返します。

戻り値:
ビューがこの Scrollable である JViewport の preferredSize
関連項目:
JComponent.getPreferredSize()

getScrollableUnitIncrement

public int getScrollableUnitIncrement(Rectangle visibleRect,
                                      int orientation,
                                      int direction)
論理行または論理列を表示するコンポーネントは、orientation の値によって、新しい 1 行または 1 列を完全にエクスポーズするスクロール増分値を計算します。理論的には、コンポーネントは項目を完全にエクスポーズするために必要な距離を返すことで、部分的にエクスポーズされている行または列を処理します。

JScrollPane などのスクロールコンテナは、ユーザがユニットスクロールを要求すると、このメソッドを使用します。

パラメータ:
visibleRect - ビューポート内の可視のビュー領域
orientation - SwingConstants.VERTICAL または SwingConstants.HORIZONTAL
direction - 上または左にスクロールする場合は 0 より小さく、下または右にスクロールする場合は 0 より大きい
戻り値:
指定された方向にスクロールするための「ユニット」増分値。常に正の値
関連項目:
JScrollBar.setUnitIncrement(int)

getScrollableBlockIncrement

public int getScrollableBlockIncrement(Rectangle visibleRect,
                                       int orientation,
                                       int direction)
論理行または論理列を表示するコンポーネントは、orientation の値によって、1 ブロック分の行または列を完全にエクスポーズするスクロール増分値を計算します。

JScrollPane などのスクロールコンテナは、ユーザがブロックスクロールを要求すると、このメソッドを使用します。

パラメータ:
visibleRect - ビューポート内の可視のビュー領域
orientation - SwingConstants.VERTICAL または SwingConstants.HORIZONTAL
direction - 上または左にスクロールする場合は 0 より小さく、下または右にスクロールする場合は 0 より大きい
戻り値:
指定された方向にスクロールするための「ブロック」増分値。常に正の値
関連項目:
JScrollBar.setBlockIncrement(int)

getScrollableTracksViewportWidth

public boolean getScrollableTracksViewportWidth()
ビューポートが、常にこの Scrollable の幅を強制的にビューポートの幅に一致させようとする場合は、true を返します。たとえば、折り返し行がビューポートの右端を越えて消えてしまうようでは不都合なので、行折り返しをサポートした通常のテキストビューはここで true を返します。上位クラスに JScrollPane を持つ Scrollable に true を返すと、水平スクロールが事実上無効になることに注意してください。

JViewport などのスクロールコンテナは、検証されるとこのメソッドを使用します。

戻り値:
ビューポートが Scrollable の幅を強制的にビューポート自体の幅に一致させる場合は true

getScrollableTracksViewportHeight

public boolean getScrollableTracksViewportHeight()
ビューポートでこの Scrollable の高さを常にビューポートの高さに合わせる場合に、true を返します。たとえば、左から右の列へテキストを表示する段組みのテキストビューの場合、このメソッドで true を返すと、垂直方向のスクロールが結果的に無効になります。

JViewport などのスクロールコンテナは、検証されるとこのメソッドを使用します。

戻り値:
ビューポートが Scrollable の高さを強制的にビューポート自体の高さに一致させる場合は true

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

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.