ScrollPane (Java Platform SE 8 )

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - java.awt.ScrollPane

All Implemented Interfaces:

ImageObserver， MenuContainer， Serializable， Accessible
```
public class ScrollPane
extends Container
implements Accessible
```
一个容器类，它实现了一个单独的子组件的自动水平和/或垂直滚动。为滚动条的显示策略可以设置为：
1. 需要：创建和显示只有当需要滚动条的滚动窗格
2. 总：滚动条的滚动窗格始终显示了
3. 从来从来没有创建或显示的滚动条滚动窗格
的水平和垂直滚动条是由两ScrollPaneAdjustable对象代表的状态（一个维度），实现Adjustable接口。该API提供了访问这些对象，对调整对象的属性的方法（如unitincrement，价值，等等）可以被操纵。

一定的调节性能（最小，最大，blockincrement，和下可见大量）的几何形状的滚动窗格和孩子，这些不能用滚动窗格程序按照滚动窗格内部设置。

如果滚动条显示政策定义为“永远”，然后滚动窗格仍然可以通过编程方式滚动使用的setscrollposition()法和滚动窗格将把孩子的内容适当。这个策略是有用的，如果程序需要创建和管理自己的可调控制。

在滚动条的位置由特定平台的性能方案设定的外部用户控制。

这个容器的初始大小设置为100x100，但可以使用setsize()复位。

默认情况下，配备有轮子的鼠标滚动功能的鼠标。这可以被禁用，以setWheelScrollingEnabled。车轮滚动，可以通过设置块的水平和垂直adjustables单位增量定制。关于如何，鼠标滚轮事件都出动了，看到MouseWheelEvent类的描述。

小图是用来定义的滚动条和滚动窗格中创建的任何边界的任何空间。getinsets()可以用来得到当前值的插图。如果scrollbarsalwaysvisible的值为假，则间隔值将取决于滚动条目前可见或不可见的变化。
另请参见：

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected class`	`ScrollPane.AccessibleAWTScrollPane` 这个类实现了对 `ScrollPane`类可访问性支持。

Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`SCROLLBARS_ALWAYS` 指定水平/垂直滚动条应该显示的滚动窗格和孩子各自的大小。
`static int`	`SCROLLBARS_AS_NEEDED` 指定水平/垂直滚动条可以显示只有当孩子的大小超过了滚动窗格的大小在水平/垂直尺寸。
`static int`	`SCROLLBARS_NEVER` 指定水平/垂直滚动条不能显示的滚动窗格和孩子各自的大小。

Fields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

构造方法
Constructor and Description
`ScrollPane()` 创建一个新的容器和一个滚动条滚动窗格显示政策“需要”。
`ScrollPane(int scrollbarDisplayPolicy)` 创建一个新的滚动窗格容器。

方法摘要

所有方法接口方法具体的方法弃用的方法
Modifier and Type	Method and Description
`protected void`	`addImpl(Component comp, Object constraints, int index)` 将指定的组件添加到这个滚动窗格容器中。
`void`	`addNotify()` 创建滚动窗格的对等点。
`void`	`doLayout()` 勾画出这个容器的大小调整其孩子理想的大小。
`protected boolean`	`eventTypeEnabled(int type)` 如果车轮滚动的启用，我们还真为mousewheelevents
`AccessibleContext`	`getAccessibleContext()` 获取与此相关的accessiblecontext滚动窗格。
`Adjustable`	`getHAdjustable()` 返回代表水平滚动条的状态 `ScrollPaneAdjustable`对象。
`int`	`getHScrollbarHeight()` 返回的高度，将由一个水平滚动条的占领，这是独立的无论是目前由滚动窗格或不显示。
`int`	`getScrollbarDisplayPolicy()` 返回滚动条的显示策略。
`Point`	`getScrollPosition()` 返回当前的X，Y位置的孩子是在滚动面板查看端口0,0位置显示在。
`Adjustable`	`getVAdjustable()` 返回 `ScrollPaneAdjustable`对象代表了垂直滚动条的状态。
`Dimension`	`getViewportSize()` 返回滚动窗格的视图端口的当前大小。
`int`	`getVScrollbarWidth()` 返回的宽度，将由一个垂直滚动条，占领，这是独立的无论是目前由滚动窗格或不显示。
`boolean`	`isWheelScrollingEnabled()` 指示是否滚动将发生响应鼠标滚轮。
`void`	`layout()` 过时的。作为JDK 1.1版本，取而代之的`doLayout()`。
`String`	`paramString()` 返回一个字符串，表示此 `ScrollPane`状态。
`void`	`printComponents(Graphics g)` 在这个滚动窗格中打印组件。
`protected void`	`processMouseWheelEvent(MouseWheelEvent e)` 过程中，通过滚动鼠标滚轮事件给这个 `ScrollPane`适量。
`void`	`setLayout(LayoutManager mgr)` 设置此容器的布局管理器。
`void`	`setScrollPosition(int x, int y)` 将滚动到子组件中的指定位置。
`void`	`setScrollPosition(Point p)` 将滚动到子组件中的指定位置。
`void`	`setWheelScrollingEnabled(boolean handleWheel)` 启用/禁用滚动响应鼠标滚轮的移动。

Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, isValidateRoot, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, update, validate, validateTree

Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

- Field Detail
  - SCROLLBARS_AS_NEEDED
```
public static final int SCROLLBARS_AS_NEEDED
```
    指定水平/垂直滚动条可以显示只有当孩子的大小超过了滚动窗格的大小在水平/垂直尺寸。
    
    另请参见：
    
    Constant Field Values
  - SCROLLBARS_ALWAYS
```
public static final int SCROLLBARS_ALWAYS
```
    指定水平/垂直滚动条应该显示的滚动窗格和孩子各自的大小。
    
    另请参见：
    
    Constant Field Values
  - SCROLLBARS_NEVER
```
public static final int SCROLLBARS_NEVER
```
    指定水平/垂直滚动条不能显示的滚动窗格和孩子各自的大小。
    
    另请参见：
    
    Constant Field Values
- Constructor Detail
  - ScrollPane
```
public ScrollPane()
           throws HeadlessException
```
    创建一个新的容器和一个滚动条滚动窗格显示政策“需要”。
    
    异常
    
    HeadlessException -如果graphicsenvironment isheadless()返回true。
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - ScrollPane
```
@ConstructorProperties(value="scrollbarDisplayPolicy")
public ScrollPane(int scrollbarDisplayPolicy)
                                                                  throws HeadlessException
```
    创建一个新的滚动窗格容器。
    
    参数
    
    scrollbarDisplayPolicy政策时应该显示滚动条
    
    异常
    
    IllegalArgumentException -如果指定滚动条显示政策是无效的
    
    HeadlessException -如果graphicsenvironment isheadless()返回true。
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
- 方法详细信息
  - addImpl
```
protected final void addImpl(Component comp,
                             Object constraints,
                             int index)
```
    将指定的组件添加到这个滚动窗格容器中。如果滚动窗格有一个现有的子组件，则该组件将被删除，并且添加了新的组件。
    
    重写：
    
    addImpl 方法重写，继承类 Container
    
    参数
    
    comp -要添加的组件
    
    constraints -不适用
    
    index -子组件的位置（必须是< = 0）
    
    另请参见：
    
    Container.add(Component)， Container.add(Component, int)， Container.add(Component, java.lang.Object)， Container.invalidate()， LayoutManager， LayoutManager2
  - getScrollbarDisplayPolicy
```
public int getScrollbarDisplayPolicy()
```
    返回滚动条的显示策略。
    
    结果
    
    为滚动条的显示策略
  - getViewportSize
```
public Dimension getViewportSize()
```
    返回滚动窗格的视图端口的当前大小。
    
    结果
    
    像素中的视图端口的大小
  - getHScrollbarHeight
```
public int getHScrollbarHeight()
```
    返回的高度，将由一个水平滚动条的占领，这是独立的无论是目前由滚动窗格或不显示。
    
    结果
    
    在像素水平滚动条的高度
  - getVScrollbarWidth
```
public int getVScrollbarWidth()
```
    返回的宽度，将由一个垂直滚动条，占领，这是独立的无论是目前由滚动窗格或不显示。
    
    结果
    
    在像素的垂直滚动条的宽度
  - getVAdjustable
```
public Adjustable getVAdjustable()
```
    返回代表垂直滚动条的状态 ScrollPaneAdjustable对象。该声明的返回类型，这种方法是 Adjustable保持向后兼容性。
    
    另请参见：
    
    ScrollPaneAdjustable
  - getHAdjustable
```
public Adjustable getHAdjustable()
```
    返回代表水平滚动条的状态 ScrollPaneAdjustable对象。该声明的返回类型，这种方法是 Adjustable保持向后兼容性。
    
    另请参见：
    
    ScrollPaneAdjustable
  - setScrollPosition
```
public void setScrollPosition(int x,
                              int y)
```
    将滚动到子组件中的指定位置。如果滚动窗格包含一个子，则此方法的调用是唯一有效的。指定一个在孩子的法律滚动边界以外的位置将滚动到最接近的法律位置。法律界定义为矩形：x = 0，Y = 0，宽度=（孩子宽度-视图端口宽度），身高=（孩子身高-查看端口高度）。这是一个方便的方法，它代表了滚动条调节对象接口的状态。
    
    参数
    
    x - X位置滚动
    
    y - Y位置滚动
    
    异常
    
    NullPointerException如果滚动窗格中不包含一个孩子
  - setScrollPosition
```
public void setScrollPosition(Point p)
```
    将滚动到子组件中的指定位置。此方法的调用是唯一有效的，如果滚动窗格包含一个孩子，指定的位置是在法律的滚动边界的孩子。指定一个在孩子的法律滚动边界以外的位置将滚动到最接近的法律位置。法律界定义为矩形：x = 0，Y = 0，宽度=（孩子宽度-视图端口宽度），身高=（孩子身高-查看端口高度）。这是一个方便的方法，它代表了滚动条调节对象接口的状态。
    
    参数
    
    p -点表示位置的卷轴
    
    异常
    
    如果是 null p NullPointerException
  - getScrollPosition
```
public Point getScrollPosition()
```
    返回当前的X，Y位置的孩子是在滚动面板查看端口0,0位置显示在。这是一个方便的方法，它代表了滚动条调节对象接口的状态。
    
    结果
    
    当前滚动位置的坐标位置
    
    异常
    
    NullPointerException如果滚动窗格中不包含一个孩子
  - setLayout
```
public final void setLayout(LayoutManager mgr)
```
    设置此容器的布局管理器。重写此方法以防止布局经理被设置。
    
    重写：
    
    setLayout 方法重写，继承类 Container
    
    参数
    
    mgr -指定的布局管理器
    
    另请参见：
    
    Container.doLayout()， Container.getLayout()， Container.invalidate()
  - doLayout
```
public void doLayout()
```
    勾画出这个容器的大小调整其孩子理想的大小。如果子的新首选大小导致当前的滚动位置无效，则将滚动位置设置为最接近的有效位置。
    
    重写：
    
    doLayout 方法重写，继承类 Container
    
    另请参见：
    
    Component.validate()
  - layout
```
@Deprecated
public void layout()
```
    过时的。作为JDK 1.1版本，取而代之的doLayout()。
    
    重写：
    
    layout 方法重写，继承类 Container
  - printComponents
```
public void printComponents(Graphics g)
```
    在这个滚动窗格中打印组件。
    
    重写：
    
    printComponents 方法重写，继承类 Container
    
    参数
    
    g -指定的图形窗口
    
    另请参见：
    
    Component.print(java.awt.Graphics)， Component.printAll(java.awt.Graphics)
  - addNotify
```
public void addNotify()
```
    创建滚动窗格的对等点。
    
    重写：
    
    addNotify 方法重写，继承类 Container
    
    另请参见：
    
    Component.isDisplayable()， Container.removeNotify()
  - paramString
```
public String paramString()
```
    返回一个字符串，表示此 ScrollPane状态。这种方法的目的是用于调试目的，其含量和返回的字符串格式不同的实现可能会有所不同。返回的字符串是空的但可能不 null。
    
    重写：
    
    paramString 方法重写，继承类 Container
    
    结果
    
    此滚动窗格的参数字符串
  - processMouseWheelEvent
```
protected void processMouseWheelEvent(MouseWheelEvent e)
```
    过程中，通过滚动鼠标滚轮事件给这个 ScrollPane适量。
    注意，如果参数是null行为是不可能导致异常。
    
    重写：
    
    processMouseWheelEvent 方法重写，继承类 Component
    
    参数
    
    e -鼠标滚轮事件
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    MouseWheelEvent， MouseWheelListener， Component.addMouseWheelListener(java.awt.event.MouseWheelListener)， Component.enableEvents(long)
  - eventTypeEnabled
```
protected boolean eventTypeEnabled(int type)
```
    如果车轮滚动的启用，我们还真为mousewheelevents
    
    从以下版本开始：
    
    一点四
  - setWheelScrollingEnabled
```
public void setWheelScrollingEnabled(boolean handleWheel)
```
    启用/禁用滚动响应鼠标滚轮的移动。默认情况下启用滚动滚动。
    
    参数
    
    handleWheel - true如果滚动应该是一mousewheelevent自动完成的， false否则。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    isWheelScrollingEnabled()， MouseWheelEvent， MouseWheelListener
  - isWheelScrollingEnabled
```
public boolean isWheelScrollingEnabled()
```
    指示是否滚动将发生响应鼠标滚轮。默认情况下启用滚动滚动。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    setWheelScrollingEnabled(boolean)
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    获取与此相关的accessiblecontext滚动窗格。滚动窗格的accessiblecontext以一个accessibleawtscrollpane形式。一个新的accessibleawtscrollpane实例被创建时。
    
    Specified by:
    
    getAccessibleContext 接口 Accessible
    
    重写：
    
    getAccessibleContext 方法重写，继承类 Component
    
    结果
    
    一个accessibleawtscrollpane作为这种滚动窗格的accessiblecontext
    
    从以下版本开始：
    
    一点三

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class ScrollPane

Nested Class Summary

Nested classes/interfaces inherited from class java.awt.Container

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class java.awt.Component

Fields inherited from interface java.awt.image.ImageObserver

构造方法摘要

方法摘要

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

Field Detail

SCROLLBARS_AS_NEEDED

SCROLLBARS_ALWAYS

SCROLLBARS_NEVER

Constructor Detail

ScrollPane

ScrollPane

方法详细信息

addImpl

getScrollbarDisplayPolicy

getViewportSize

getHScrollbarHeight

getVScrollbarWidth

getVAdjustable

getHAdjustable

setScrollPosition

setScrollPosition

getScrollPosition

setLayout

doLayout

layout

printComponents

addNotify

paramString

processMouseWheelEvent

eventTypeEnabled

setWheelScrollingEnabled

isWheelScrollingEnabled

getAccessibleContext