javax.swing
介面 Scrollable

所有已知實作類別：

DefaultTreeCellEditor.DefaultTextField, JEditorPane, JFormattedTextField, JList, JPasswordField, JTable, JTextArea, JTextComponent, JTextField, JTextPane, JTree

public interface Scrollable

為類似 JScrollPane 的滾動容器提供資訊的介面。用於查看 JScrollPane （或其他滾動容器）的視口的複雜元件應實作此介面。

另請參見：

JViewport, JScrollPane, JScrollBar

方法摘要

Dimension	getPreferredScrollableViewportSize() 返回視圖元件視口的首選大小。
int	getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction) 顯示邏輯行或列的元件應計算滾動增量，它將根據方向的值完全公開一個行塊或列塊。
boolean	getScrollableTracksViewportHeight() 如果視口總是強制此 Scrollable 的高度與視口高度比對，則返回 true。
boolean	getScrollableTracksViewportWidth() 如果視口總是強制此 Scrollable 的寬度與視口寬度比對，則返回 true。
int	getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction) 顯示邏輯行或列的元件應計算滾動增量，它將根據方向的值完全公開一個新的行或列。

方法詳細資訊

getPreferredScrollableViewportSize

Dimension getPreferredScrollableViewportSize()

返回視圖元件視口的首選大小。例如，JList 元件的首選大小為容納其列表中所有單元所需的大小。但是，preferredScrollableViewportSize 的值為 JList.getVisibleRowCount 行所需的大小。此處不帶任何影響視口大小的屬性的元件應只返回 getPreferredSize。

返回：

視圖為此 Scrollable 的 JViewport 的首選大小

另請參見：

JComponent.getPreferredSize()

getScrollableUnitIncrement

int getScrollableUnitIncrement(Rectangle visibleRect,
                               int orientation,
                               int direction)

顯示邏輯行或列的元件應計算滾動增量，它將根據方向的值完全公開一個新的行或列。理想情況下，元件應通過返回需要的距離來處理一個部分公開的行或列，以便完全公開此項。

每當使用者請求一個單位的滾動時，類似 JScrollPane 的滾動容器將使用此方法。

參數：

visibleRect - 視口內可見的視圖區域

orientation - SwingConstants.VERTICAL 或 SwingConstants.HORIZONTAL。

direction - 小於 0 為向上/左滾動，大於 0 為向下/右滾動。

返回：

沿指定方向滾動的“單位”增量。此值應該永遠為正數。

另請參見：

JScrollBar.setUnitIncrement(int)

getScrollableBlockIncrement

int getScrollableBlockIncrement(Rectangle visibleRect,
                                int orientation,
                                int direction)

顯示邏輯行或列的元件應計算滾動增量，它將根據方向的值完全公開一個行塊或列塊。

每當使用者請求一個塊的滾動時，類似 JScrollPane 的滾動容器將使用此方法。

參數：

visibleRect - 視口內可見的視圖區域

orientation - SwingConstants.VERTICAL 或 SwingConstants.HORIZONTAL。

direction - 小於 0 為向上/左滾動，大於 0 為向下/右滾動。

返回：

沿指定方向滾動的“塊”增量。此值應該永遠為正數。

另請參見：

JScrollBar.setBlockIncrement(int)

getScrollableTracksViewportWidth

boolean getScrollableTracksViewportWidth()

如果視口總是強制此 Scrollable 的寬度與視口寬度比對，則返回 true。例如，支持換行的正常文本顯示在這裡將返回 true，因為不希望讓換行內容超出視口右邊界而無法顯示。注意，祖先為 JScrollPane 的 Scrollable 返回 true 可有效地禁用水平滾動。

類似 JViewport 的滾動容器在每次進行驗證時都使用此方法。

返回：

如果視口強制 Scrollable 寬度與其自身寬度比對，則返回 True。

getScrollableTracksViewportHeight

boolean getScrollableTracksViewportHeight()

如果視口總是強制此 Scrollable 的高度與視口高度比對，則返回 true。例如，縱行文本視圖（按列從左向右串流入文本）通過在此處返回 true 可有效地禁用垂直滾動。

類似 JViewport 的滾動容器在每次進行驗證時都使用此方法。

返回：

如果視口強制 Scrollable 高度與其自身高度比對，則返回 True。