ScrollPaneLayout (Java Platform SE 8 )

java.lang.Object
- javax.swing.ScrollPaneLayout

All Implemented Interfaces:

LayoutManager ， Serializable ， ScrollPaneConstants

已知直接子类：

ScrollPaneLayout.UIResource
```
public class ScrollPaneLayout
extends Object
implements LayoutManager, ScrollPaneConstants, Serializable
```
JScrollPane使用的布局管理器。 JScrollPaneLayout负责九个组件：视口，两个滚动条，行标题，列标题和四个“角”组件。
警告：此类的序列化对象与将来的Swing版本不兼容。当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。从1.4版本开始，支持所有JavaBeans的长期存储已添加到java.beans软件包中。请参阅XMLEncoder 。

另请参见：

JScrollPane ， JViewport

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`ScrollPaneLayout.UIResource` UI资源版本为 `ScrollPaneLayout` 。

Field Summary

Fields
Modifier and Type	Field and Description
`protected JViewport`	`colHead` 列标题子。
`protected JScrollBar`	`hsb` 滚动盘的水平滚动条小孩。
`protected int`	`hsbPolicy` 水平滚动条的显示策略。
`protected Component`	`lowerLeft` 要显示在左下角的组件。
`protected Component`	`lowerRight` 要显示在右下角的组件。
`protected JViewport`	`rowHead` 行标题子。
`protected Component`	`upperLeft` 组件显示在左上角。
`protected Component`	`upperRight` 组件显示在右上角。
`protected JViewport`	`viewport` 滚动窗口的视口小孩。
`protected JScrollBar`	`vsb` 滚动盘的垂直滚动条小孩。
`protected int`	`vsbPolicy` 垂直滚动条的显示策略。

构造方法摘要

构造方法
Constructor and Description
`ScrollPaneLayout()`

方法摘要

所有方法接口方法具体的方法弃用的方法
Modifier and Type	Method and Description
`void`	`addLayoutComponent(String s, Component c)` 将指定的组件添加到布局。
`protected Component`	`addSingletonComponent(Component oldC, Component newC)` 删除现有组件。
`JViewport`	`getColumnHeader()` 返回作为列标题的 `JViewport`对象。
`Component`	`getCorner(String key)` 返回 `Component`在指定的角落。
`JScrollBar`	`getHorizontalScrollBar()` 返回处理水平滚动的 `JScrollBar`对象。
`int`	`getHorizontalScrollBarPolicy()` 返回水平滚动条显示策略。
`JViewport`	`getRowHeader()` 返回行标题的 `JViewport`对象。
`JScrollBar`	`getVerticalScrollBar()` 返回执行垂直滚动的 `JScrollBar`对象。
`int`	`getVerticalScrollBarPolicy()` 返回垂直滚动条显示策略。
`JViewport`	`getViewport()` 返回显示可滚动内容的 `JViewport`对象。
`Rectangle`	`getViewportBorderBounds(JScrollPane scrollpane)` 已弃用截至JDK版本的Swing1.1由`JScrollPane.getViewportBorderBounds()`替换。
`void`	`layoutContainer(Container parent)` 吹出滚屏。
`Dimension`	`minimumLayoutSize(Container parent)` `ScrollPane`的最小大小是 `ScrollPane`大小加视口的最小大小，加上滚动窗口的viewportBorder插入，加上可见标题的最小大小，加上displayPolicy不是永远不会滚动条的最小大小。
`Dimension`	`preferredLayoutSize(Container parent)` 一的优选尺寸 `ScrollPane`是insets的大小，加上视口的优选大小，加上可见标题的优选大小，再加上它按照给定的当前视图和当前滚动条策略显示滚动条的优选大小。
`void`	`removeLayoutComponent(Component c)` 从布局中删除指定的组件。
`void`	`setHorizontalScrollBarPolicy(int x)` 设置水平滚动条显示策略。
`void`	`setVerticalScrollBarPolicy(int x)` 设置垂直滚动条显示策略。
`void`	`syncWithScrollPane(JScrollPane sp)` 将ScrollPaneLayout设置为JScrollPane的 `JScrollPane`后调用此方法。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细信息
  - viewport
```
protected JViewport viewport
```
    滚动窗口的视口小孩。默认为空JViewport 。
    
    另请参见：
    
    JScrollPane.setViewport(javax.swing.JViewport)
  - vsb
```
protected JScrollBar vsb
```
    滚动盘的垂直滚动条小孩。默认是JScrollBar 。
    
    另请参见：
    
    JScrollPane.setVerticalScrollBar(javax.swing.JScrollBar)
  - hsb
```
protected JScrollBar hsb
```
    滚动盘的水平滚动条小孩。默认是JScrollBar 。
    
    另请参见：
    
    JScrollPane.setHorizontalScrollBar(javax.swing.JScrollBar)
  - rowHead
```
protected JViewport rowHead
```
    行标题子。默认值为null 。
    
    另请参见：
    
    JScrollPane.setRowHeader(javax.swing.JViewport)
  - colHead
```
protected JViewport colHead
```
    列标题子。默认值为null 。
    
    另请参见：
    
    JScrollPane.setColumnHeader(javax.swing.JViewport)
  - lowerLeft
```
protected Component lowerLeft
```
    要显示在左下角的组件。默认值为null 。
    
    另请参见：
    
    JScrollPane.setCorner(java.lang.String, java.awt.Component)
  - lowerRight
```
protected Component lowerRight
```
    要显示在右下角的组件。默认值为null 。
    
    另请参见：
    
    JScrollPane.setCorner(java.lang.String, java.awt.Component)
  - upperLeft
```
protected Component upperLeft
```
    组件显示在左上角。默认值为null 。
    
    另请参见：
    
    JScrollPane.setCorner(java.lang.String, java.awt.Component)
  - upperRight
```
protected Component upperRight
```
    组件显示在右上角。默认值为null 。
    
    另请参见：
    
    JScrollPane.setCorner(java.lang.String, java.awt.Component)
  - vsbPolicy
```
protected int vsbPolicy
```
    垂直滚动条的显示策略。默认值为ScrollPaneConstants.VERTICAL_SCROLLBAR_AS_NEEDED 。
    该字段已过时，请改用JScrollPane字段。
    
    另请参见：
    
    JScrollPane.setVerticalScrollBarPolicy(int)
  - hsbPolicy
```
protected int hsbPolicy
```
    水平滚动条的显示策略。默认值为ScrollPaneConstants.HORIZONTAL_SCROLLBAR_AS_NEEDED 。
    此字段已过时，请改用JScrollPane字段。
    
    另请参见：
    
    JScrollPane.setHorizontalScrollBarPolicy(int)
- 构造方法详细信息
  - ScrollPaneLayout
```
public ScrollPaneLayout()
```
- 方法详细信息
  - syncWithScrollPane
```
public void syncWithScrollPane(JScrollPane sp)
```
    将ScrollPaneLayout设置为JScrollPane的JScrollPane后调用此方法。它初始化通常由addLayoutComponent设置的所有内部字段。例如：
```
  ScrollPaneLayout mySPLayout = new ScrollPanelLayout() {
     public void layoutContainer(Container p) {
         super.layoutContainer(p);
         // do some extra work here ...
     }
 };
 scrollpane.setLayout(mySPLayout): 
```
  - addSingletonComponent
```
protected Component addSingletonComponent(Component oldC,
                                          Component newC)
```
    删除现有组件。当添加新的组件（如左角或垂直滚动条）时，必须删除旧组件（如果存在）。
    此方法返回newC 。如果oldC不等于newC ，并且不是null ，它将从其父代中删除。
    
    参数
    
    oldC - 要更换的 Component
    
    newC - 要添加的 Component
    
    结果
    
    newC
  - addLayoutComponent
```
public void addLayoutComponent(String s,
                               Component c)
```
    将指定的组件添加到布局。布局使用以下之一来识别：
    - ScrollPaneConstants.VIEWPORT
    - ScrollPaneConstants.VERTICAL_SCROLLBAR
    - ScrollPaneConstants.HORIZONTAL_SCROLLBAR
    - ScrollPaneConstants.ROW_HEADER
    - ScrollPaneConstants.COLUMN_HEADER
    - ScrollPaneConstants.LOWER_LEFT_CORNER
    - ScrollPaneConstants.LOWER_RIGHT_CORNER
    - ScrollPaneConstants.UPPER_LEFT_CORNER
    - ScrollPaneConstants.UPPER_RIGHT_CORNER
    Specified by:
    
    addLayoutComponent在接口 LayoutManager
    
    参数
    
    s - 组件标识符
    
    c - 要添加的组件
    
    异常
    
    IllegalArgumentException - 如果 s是无效的密钥
  - removeLayoutComponent
```
public void removeLayoutComponent(Component c)
```
    从布局中删除指定的组件。
    
    Specified by:
    
    removeLayoutComponent在接口 LayoutManager
    
    参数
    
    c - 要删除的组件
  - getVerticalScrollBarPolicy
```
public int getVerticalScrollBarPolicy()
```
    返回垂直滚动条显示策略。
    
    结果
    
    一个给出显示策略的整数
    
    另请参见：
    
    setVerticalScrollBarPolicy(int)
  - setVerticalScrollBarPolicy
```
public void setVerticalScrollBarPolicy(int x)
```
    设置垂直滚动条显示策略。选项是：
    - ScrollPaneConstants.VERTICAL_SCROLLBAR_AS_NEEDED
    - ScrollPaneConstants.VERTICAL_SCROLLBAR_NEVER
    - ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS
    注意：应用程序应使用此方法的JScrollPane版本。它仅存在于与此类的Swing 1.0.2（及更早版本）版本的向后兼容性。
    参数
    
    x - 给出显示策略的整数
    
    异常
    
    IllegalArgumentException - 如果 x是无效的垂直滚动条策略，如上所列
  - getHorizontalScrollBarPolicy
```
public int getHorizontalScrollBarPolicy()
```
    返回水平滚动条显示策略。
    
    结果
    
    一个给出显示策略的整数
    
    另请参见：
    
    setHorizontalScrollBarPolicy(int)
  - setHorizontalScrollBarPolicy
```
public void setHorizontalScrollBarPolicy(int x)
```
    设置水平滚动条显示策略。选项是：
    - ScrollPaneConstants.HORIZONTAL_SCROLLBAR_AS_NEEDED
    - ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER
    - ScrollPaneConstants.HORIZONTAL_SCROLLBAR_ALWAYS
    注意：应用程序应使用此方法的JScrollPane版本。它仅存在于与此类的Swing 1.0.2（及更早版本）版本的向后兼容性。
    参数
    
    x - 提供显示策略的int
    
    异常
    
    IllegalArgumentException - 如果 x不是有效的水平滚动条政策，如上所列
  - getViewport
```
public JViewport getViewport()
```
    返回显示可滚动内容的 JViewport对象。
    
    结果
    
    显示可滚动内容的 JViewport对象
    
    另请参见：
    
    JScrollPane.getViewport()
  - getHorizontalScrollBar
```
public JScrollBar getHorizontalScrollBar()
```
    返回处理水平滚动的 JScrollBar对象。
    
    结果
    
    处理水平滚动的 JScrollBar对象
    
    另请参见：
    
    JScrollPane.getHorizontalScrollBar()
  - getVerticalScrollBar
```
public JScrollBar getVerticalScrollBar()
```
    返回处理垂直滚动的 JScrollBar对象。
    
    结果
    
    处理垂直滚动的 JScrollBar对象
    
    另请参见：
    
    JScrollPane.getVerticalScrollBar()
  - getRowHeader
```
public JViewport getRowHeader()
```
    返回行标题的 JViewport对象。
    
    结果
    
    JViewport对象是行头
    
    另请参见：
    
    JScrollPane.getRowHeader()
  - getColumnHeader
```
public JViewport getColumnHeader()
```
    返回作为列标题的 JViewport对象。
    
    结果
    
    JViewport对象是列标题
    
    另请参见：
    
    JScrollPane.getColumnHeader()
  - getCorner
```
public Component getCorner(String key)
```
    返回 Component在指定的角落。
    
    参数
    
    key - 指定 String String
    
    结果
    
    Component在指定的角落，如ScrollPaneConstants所定义; 如果key不是四角之一，则返回null
    
    另请参见：
    
    JScrollPane.getCorner(java.lang.String)
  - preferredLayoutSize
```
public Dimension preferredLayoutSize(Container parent)
```
    一的优选尺寸ScrollPane是insets的大小，加上视口的优选大小，加上可见标题的优选大小，再加上它按照给定的当前视图和当前滚动条策略显示滚动条的优选大小。
    请注意，rowHeader是作为首选宽度的一部分计算的，而colHeader是作为首选大小的一部分计算的。
    
    Specified by:
    
    preferredLayoutSize在接口 LayoutManager
    
    参数
    
    parent - 将布局的 Container
    
    结果
    
    一个 Dimension对象，指定视口和任何滚动条的首选大小
    
    另请参见：
    
    ViewportLayout ， LayoutManager
  - minimumLayoutSize
```
public Dimension minimumLayoutSize(Container parent)
```
    ScrollPane的最小大小是 ScrollPane的大小加上视口的最小大小，加上滚动窗口的viewportBorder插入，加上可见标题的最小大小，以及displayPolicy不是永远不会滚动条的最小大小。
    
    Specified by:
    
    minimumLayoutSize在接口 LayoutManager
    
    参数
    
    parent - 将布局的 Container
    
    结果
    
    一个 Dimension最小大小的 Dimension对象
    
    另请参见：
    
    LayoutManager.preferredLayoutSize(java.awt.Container)
  - layoutContainer
```
public void layoutContainer(Container parent)
```
    吹出滚屏。组件的定位取决于以下约束：
    - 行标题（如果存在和可见）获取其首选宽度和视口的高度。
    - 列标题（如果存在和可见）获取其首选高度和视口宽度。
    - 如果需要垂直滚动条，即如果视口的范围高度小于其视图高度，或者如果displayPolicy ，则将其视为相对于其维度的行标题，并使其可见。
    - 如果需要一个水平滚动条，它将被视为列标题（请参阅上面关于垂直滚动条的段落）。
    - 如果滚动盘有一个非null viewportBorder ，则分配空间。
    - 视口在计算先前的约束之后获得可用空间。
    - 角部件（如果提供）与滚动条和标题的末端对齐。如果有垂直滚动条，则出现右边角; 如果有水平滚动条，则出现下角; 一个行标题左拐角，一个列标题变成上角。
    Specified by:
    
    layoutContainer在接口 LayoutManager
    
    参数
    
    parent - Container布局
  - getViewportBorderBounds
```
@Deprecated
public Rectangle getViewportBorderBounds(JScrollPane scrollpane)
```
    已弃用截至JDK版本的Swing1.1由JScrollPane.getViewportBorderBounds() 。
    
    返回指定滚动窗格视口周围边框的边界。
    
    结果
    
    视口边框的大小和位置

Class ScrollPaneLayout

Nested Class Summary

Field Summary

Fields inherited from interface javax.swing.ScrollPaneConstants

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

viewport

vsb

hsb

rowHead

colHead

lowerLeft

lowerRight

upperLeft

upperRight

vsbPolicy

hsbPolicy

构造方法详细信息

ScrollPaneLayout

方法详细信息

syncWithScrollPane

addSingletonComponent

addLayoutComponent

removeLayoutComponent

getVerticalScrollBarPolicy

setVerticalScrollBarPolicy

getHorizontalScrollBarPolicy

setHorizontalScrollBarPolicy

getViewport

getHorizontalScrollBar

getVerticalScrollBar

getRowHeader

getColumnHeader

getCorner

preferredLayoutSize

minimumLayoutSize

layoutContainer

getViewportBorderBounds