模块 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

方法摘要

变量和类型	方法	描述
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的首选 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。