Module java.desktop
Package javax.swing

Interface Scrollable

所有已知的实现类:
DefaultTreeCellEditor.DefaultTextField, JEditorPane, JFormattedTextField, JLayer, JList, JPasswordField, JTable, JTextArea, JTextComponent, JTextField, JTextPane, JTree

public interface Scrollable
提供信息给像JScrollPane这样的滚动容器的接口。一个复杂的组件,很可能被用作查看JScrollPane视口(或其他滚动容器)的组件应该实现这个接口。
自从:
1.2
参见:
  • Method Details

    • getPreferredScrollableViewportSize

      Dimension getPreferredScrollableViewportSize()
      返回视图组件的视口的首选大小。例如,JList组件的首选大小是容纳其列表中所有单元格所需的大小。然而,preferredScrollableViewportSize的值是JList.getVisibleRowCount行所需的大小。没有任何影响视口大小的属性的组件应该在这里返回getPreferredSize。
      返回:
      此Scrollable的视图是JViewport的首选大小
      参见:
    • getScrollableUnitIncrement

      int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
      显示逻辑行或列的组件应计算滚动增量,以完全显示一个新行或列,具体取决于方向的值。理想情况下,组件应通过返回完全显示该项所需的距离来处理部分显示的行或列。

      像JScrollPane这样的滚动容器每次用户请求单位滚动时都会使用此方法。

      参数:
      visibleRect - 视口内可见的视图区域
      orientation - SwingConstants.VERTICAL或SwingConstants.HORIZONTAL。
      direction - 小于零向上/向左滚动,大于零向下/向右滚动。
      返回:
      指定方向上滚动的“单位”增量。此值应始终为正值。
      参见:
    • getScrollableBlockIncrement

      int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
      显示逻辑行或列的组件应计算滚动增量,以完全显示一块行或列,具体取决于方向的值。

      像JScrollPane这样的滚动容器每次用户请求块滚动时都会使用此方法。

      参数:
      visibleRect - 视口内可见的视图区域
      orientation - SwingConstants.VERTICAL或SwingConstants.HORIZONTAL。
      direction - 小于零向上/向左滚动,大于零向下/向右滚动。
      返回:
      指定方向上滚动的“块”增量。此值应始终为正值。
      参见:
    • getScrollableTracksViewportWidth

      boolean getScrollableTracksViewportWidth()
      如果视口应始终强制此Scrollable的宽度与视口的宽度匹配,则返回true。例如,支持换行的普通文本视图应在此处返回true,因为不希望换行的行超出视口的右边缘。请注意,对于祖先为JScrollPane的Scrollable返回true实际上会禁用水平滚动。

      像JViewport这样的滚动容器每次验证时都会使用此方法。

      返回:
      如果视口应强制Scrollable的宽度与其自身匹配,则为True。
    • getScrollableTracksViewportHeight

      boolean getScrollableTracksViewportHeight()
      如果视口应始终强制此Scrollable的高度与视口的高度匹配,则返回true。例如,从左到右列中流动文本的列文本视图可以通过在此处返回true有效地禁用垂直滚动。

      像JViewport这样的滚动容器每次验证时都会使用此方法。

      返回:
      如果视口应强制Scrollable的高度与其自身匹配,则为True。