Module java.desktop

软件包 javax.swing

Interface Scrollable

所有已知实现类：

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

public interface Scrollable

向JScrollPane等滚动容器提供信息的界面。 可能用作查看JScrollPane视口（或其他滚动容器）的复杂组件应实现此接口。

从以下版本开始：

1.2

另请参见：

JViewport ， JScrollPane ， JScrollBar

方法摘要

Modifier and Type	方法	描述
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 。

结果

一个 JViewport的视图是这个 Scrollable

另请参见：

JComponent.getPreferredSize()

getScrollableUnitIncrement

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

显示逻辑行或列的组件应计算将根据取向值完全暴露一个新行或列的滚动增量。 理想情况下，组件应通过返回完全暴露项目所需的距离来处理部分暴露的行或列。

滚动容器（如JScrollPane）将在用户请求单位滚动时使用此方法。

参数

visibleRect - 在视口内可见的视图区域

orientation - SwingConstants.VERTICAL或SwingConstants.HORIZONTAL。

direction - 向上/向左滚动小于零，向下/向右大于零。

结果

在指定方向滚动的“单位”增量。 该值应始终为正。

另请参见：

JScrollBar.setUnitIncrement(int)

getScrollableBlockIncrement

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

显示逻辑行或列的组件应计算将根据取向值完全暴露一行行或列的滚动增量。

滚动容器（如JScrollPane）将在每次用户请求块滚动时使用此方法。

参数

visibleRect - 在视口内可见的视图区域

orientation - SwingConstants.VERTICAL或SwingConstants.HORIZONTAL。

direction - 向上/向左滚动小于零，向下/向右大于零。

结果

在指定方向滚动的“块”增量。 该值应始终为正。

另请参见：

JScrollBar.setBlockIncrement(int)

getScrollableTracksViewportWidth

boolean getScrollableTracksViewportWidth()

如果视口应始终强制此宽度与匹配视口宽度的Scrollable返回true。 例如，支持换行的常规文本视图在此处将返回true，因为包装线条不会超出视口右边缘消失。 请注意，对于其祖先是JScrollPane的Scrollable，返回true会有效地禁用水平滚动。

滚动容器（如JViewport）将在每次验证时使用此方法。

结果

如果视口应强制Scrollables宽度与其自身匹配，则为True。

getScrollableTracksViewportHeight

boolean getScrollableTracksViewportHeight()

如果视口总是强制此Scrollable的高度与视口的高度相匹配，则返回true。 例如，从左到右列流动文本的柱状文本视图可以通过在此返回true来有效地禁用垂直滚动。

滚动容器（如JViewport）将在每次验证时使用此方法。

结果

如果视口应强制Scrollables高度与其自身匹配，则为true。