javax.swing
类 JScrollBar

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JScrollBar

所有已实现的接口：

Adjustable, ImageObserver, MenuContainer, Serializable, Accessible

直接已知子类：

JScrollPane.ScrollBar

public class JScrollBar
extends JComponent
implements Adjustable, Accessible

滚动条的实现。用户在滚动条内移动滑块可确定显示区域中的内容。该程序通常将显示调整为滚动条的结束代表可显示内容的结束，或内容的 100%。滚动条的开始为可显示内容的开始，或 0%。然后滑块在其边界中的位置转换为可显示内容对应的百分比。

通常，随着滑块的位置在滚动条中的变化，将在基础视图上对 JViewport 的位置进行相应的更改，这样 JViewport 的内容也随之改变。

警告：Swing 不是线程安全的。有关更多信息，请参阅 Swing's Threading Policy。

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

另请参见：

JScrollPane

model

protected BoundedRangeModel model

表示滚动条的最小、最大、跨度（也叫 "visibleAmount"）和当前值的模型。

另请参见：

setModel(javax.swing.BoundedRangeModel)

orientation

protected int orientation

另请参见：

setOrientation(int)

unitIncrement

protected int unitIncrement

另请参见：

setUnitIncrement(int)

blockIncrement

protected int blockIncrement

另请参见：

setBlockIncrement(int)

JScrollBar

public JScrollBar(int orientation,
                  int value,
                  int extent,
                  int min,
                  int max)

创建具有指定方向、值、跨度、最小值和最大值的一个滚动条。“跨度”是指可见区域的大小。它又被称为“可见量”。

注：使用 setBlockIncrement 将块增量设置为一个比视图的跨度稍小的大小。这样，当用户使滑块跳到一个相邻位置时，原有内容的一行或两行仍位于视图中。

抛出：

IllegalArgumentException - 如果 orientation 不属于 VERTICAL 或 HORIZONTAL 中的任何一个

另请参见：

setOrientation(int), setValue(int), setVisibleAmount(int), setMinimum(int), setMaximum(int)

JScrollBar

public JScrollBar(int orientation)

创建具有指定方向和下列初始值的滚动条：

 minimum = 0 
 maximum = 100 
 value = 0
 extent = 10
 

JScrollBar

public JScrollBar()

创建具有下列初始值的垂直滚动条：

 minimum = 0 
 maximum = 100 
 value = 0
 extent = 10
 

setUI

public void setUI(ScrollBarUI ui)

设置呈现此组件的 L&F 对象。

参数：

ui - ScrollBarUI L&F 对象

从以下版本开始：

1.4

另请参见：

UIDefaults.getUI(javax.swing.JComponent)

getUI

public ScrollBarUI getUI()

返回实现此组件的外观的委托。

另请参见：

JComponent.setUI(javax.swing.plaf.ComponentUI)

updateUI

public void updateUI()

重写 JComponent.updateUI。

覆盖：

类 JComponent 中的 updateUI

另请参见：

JComponent.updateUI()

getUIClassID

public String getUIClassID()

返回此组件的 LookAndFeel 类的名称。

覆盖：

类 JComponent 中的 getUIClassID

返回：

"ScrollBarUI"

另请参见：

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

getOrientation

public int getOrientation()

返回组件的方向（横向或纵向）。

指定者：

接口 Adjustable 中的 getOrientation

返回：

VERTICAL 或 HORIZONTAL

另请参见：

setOrientation(int), Adjustable.getOrientation()

setOrientation

public void setOrientation(int orientation)

将滚动条的方向设置为 VERTICAL 或 HORIZONTAL。

抛出：

IllegalArgumentException - 如果方向不属于 VERTICAL、HORIZONTAL 中的任何一个

另请参见：

getOrientation()

getModel

public BoundedRangeModel getModel()

返回处理滚动条的四个基本属性的数据模型：minimum、maximum、value 和 extent。

另请参见：

setModel(javax.swing.BoundedRangeModel)

setModel

public void setModel(BoundedRangeModel newModel)

设置处理滚动条的以下四个基本属性的模型：minimum、maximum、value 和 extent。

另请参见：

getModel()

getUnitIncrement

public int getUnitIncrement(int direction)

针对一个向上/向下滚动一个单位的请求，返回滚动条值的更改量。当用户单击滚动条向上/向下箭头时，ScrollBarUI 实现通常调用此方法，并用此方法的结果来更新滚动条的值。子类可重写此方法以便计算某个值，例如，向上或向下滚动一行文本（变量 height）或在表格中滚动一行时所需的改变值。

JScrollPane 组件创建的滚动条（默认）会重写此方法，还会将它委托给视口的 Scrollable 视图（如果有）。Scrollable 接口提供了此方法的一个更为特殊的版本。

参数：

direction - 为 -1 或 1，分别对应向上/向下

返回：

unitIncrement 属性的值

另请参见：

setUnitIncrement(int), setValue(int), Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int)

setUnitIncrement

public void setUnitIncrement(int unitIncrement)

设置 unitIncrement 属性。

注意，如果参数等于值 Integer.MIN_VALUE，大多数外观显示将不提供向右/向下滚动。

指定者：

接口 Adjustable 中的 setUnitIncrement

参数：

unitIncrement - 单位增量

另请参见：

getUnitIncrement(int)

getBlockIncrement

public int getBlockIncrement(int direction)

针对一个向上/向下滚动一个块（通常为 "page"）的请求，返回滚动条值的更改量。当用户通过在滚动条“滑块”的上面或下面单击从而将值大幅度增大或减小时，ScrollBarUI 实现通常调用此方法。子类可重写此方法以便计算某个值，例如，在一个文本文档中向上或向下滚动一个段落时所需的改变值。

JScrollPane 组件创建的滚动条（默认）会重写此方法，还会将它委托给视口的 Scrollable 视图（如果有）。Scrollable 接口提供了此方法的一个更为特殊的版本。

参数：

direction - 为 -1 或 1，分别对应向上/向下

返回：

blockIncrement 属性的值

另请参见：

setBlockIncrement(int), setValue(int), Scrollable.getScrollableBlockIncrement(java.awt.Rectangle, int, int)

setBlockIncrement

public void setBlockIncrement(int blockIncrement)

设置 blockIncrement 属性。

注意，如果参数等于值 Integer.MIN_VALUE，大多数外观显示将不提供向右/向下滚动。

指定者：

接口 Adjustable 中的 setBlockIncrement

参数：

blockIncrement - 块值增量

另请参见：

getBlockIncrement()

getUnitIncrement

public int getUnitIncrement()

供与 java.awt.Scrollbar 向后兼容。

指定者：

接口 Adjustable 中的 getUnitIncrement

返回：

可调整对象的单位值增量

另请参见：

Adjustable.getUnitIncrement(), getUnitIncrement(int)

getBlockIncrement

public int getBlockIncrement()

供与 java.awt.Scrollbar 向后兼容。

指定者：

接口 Adjustable 中的 getBlockIncrement

返回：

可调整对象的块值增量

另请参见：

Adjustable.getBlockIncrement(), getBlockIncrement(int)

getValue

public int getValue()

返回滚动条的值。

指定者：

接口 Adjustable 中的 getValue

返回：

模型的 value 属性

另请参见：

setValue(int)

setValue

public void setValue(int value)

设置滚动条的值。此方法只将值转发给模型。

指定者：

接口 Adjustable 中的 setValue

参数：

value - 当前值，它位于 minimum 和 maximum - visibleAmount 之间

另请参见：

getValue(), BoundedRangeModel.setValue(int)

getVisibleAmount

public int getVisibleAmount()

返回滚动条的跨度，即它的 "visibleAmount"。在许多滚动条的外观实现中，滚动条“滑块”或 "thumb" 的大小与此跨度成正比。

指定者：

接口 Adjustable 中的 getVisibleAmount

返回：

模型的 extent 属性的值

另请参见：

setVisibleAmount(int)

setVisibleAmount

public void setVisibleAmount(int extent)

设置模型的 extent 属性。

指定者：

接口 Adjustable 中的 setVisibleAmount

参数：

extent - 指示器的长度

另请参见：

getVisibleAmount(), BoundedRangeModel.setExtent(int)

getMinimum

public int getMinimum()

返回滚动条支持的最小值（通常为 0）。

指定者：

接口 Adjustable 中的 getMinimum

返回：

模型的 minimum 属性的值

另请参见：

setMinimum(int)

setMinimum

public void setMinimum(int minimum)

设置模型的 minimum 属性。

指定者：

接口 Adjustable 中的 setMinimum

参数：

minimum - 最小值

另请参见：

getMinimum(), BoundedRangeModel.setMinimum(int)

getMaximum

public int getMaximum()

滚动条的最大值为最大跨度。

指定者：

接口 Adjustable 中的 getMaximum

返回：

模型的 maximum 属性值

另请参见：

setMaximum(int)

setMaximum

public void setMaximum(int maximum)

设置模型的 maximum 属性。注意，滚动条的值只能设置为最大跨度。

指定者：

接口 Adjustable 中的 setMaximum

参数：

maximum - 最大值

另请参见：

getMaximum(), BoundedRangeModel.setMaximum(int)

getValueIsAdjusting

public boolean getValueIsAdjusting()

如果滚动条滑块被拖动，则返回 True。

返回：

模型的 valueIsAdjusting 属性

另请参见：

setValueIsAdjusting(boolean)

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)

设置模型的 valueIsAdjusting 属性。当开始拖动滑块时，滚动条外观实现应将此属性设置为 true，拖动停止时，将此属性设置为 false。在 valueIsAdjusting 为 true 时，滚动条模型不生成 ChangeEvent。

另请参见：

getValueIsAdjusting(), BoundedRangeModel.setValueIsAdjusting(boolean)

setValues

public void setValues(int newValue,
                      int newExtent,
                      int newMin,
                      int newMax)

强制参数满足以下常规约束后设置四个 BoundedRangeModel 属性：

 minimum <= value <= value+extent <= maximum
 

另请参见：

BoundedRangeModel.setRangeProperties(int, int, int, int, boolean), setValue(int), setVisibleAmount(int), setMinimum(int), setMaximum(int)

addAdjustmentListener

public void addAdjustmentListener(AdjustmentListener l)

添加一个 AdjustmentListener。每当滚动条模型发生更改时，都会通知调整侦听器。为与 java.awt.Scrollbar 向后兼容而提供调整事件。

注意，AdjustmentEvent 类型属性将一直有一个占位值 AdjustmentEvent.TRACK，因为对 BoundedRangeModels 值的所有更改都被认为是等价的。要更改 BoundedRangeModel 的值，只需要设置它的 value 属性，即 model.setValue(123)。未提供任何关于更改起源的信息，如它是一个块减小的更改之类。这里对更改的起源将不赘述。

指定者：

接口 Adjustable 中的 addAdjustmentListener

参数：

l - 要添加的 AdjustmentLister

另请参见：

removeAdjustmentListener(java.awt.event.AdjustmentListener), BoundedRangeModel.addChangeListener(javax.swing.event.ChangeListener)

removeAdjustmentListener

public void removeAdjustmentListener(AdjustmentListener l)

移除一个 AdjustmentEvent 侦听器。

指定者：

接口 Adjustable 中的 removeAdjustmentListener

参数：

l - 要移除的 AdjustmentLister

另请参见：

addAdjustmentListener(java.awt.event.AdjustmentListener)

getAdjustmentListeners

public AdjustmentListener[] getAdjustmentListeners()

返回使用 addAdjustmentListener() 添加到此 JScrollBar 中的 AdjustmentListener 组成的数组。

返回：

如果有侦听器，则返回所有已添加的 AdjustmentListener；如果未添加任何侦听器，则返回一个空数组

从以下版本开始：

1.4

fireAdjustmentValueChanged

protected void fireAdjustmentValueChanged(int id,
                                          int type,
                                          int value)

通知侦听器该滚动条的模型已更改。

另请参见：

addAdjustmentListener(java.awt.event.AdjustmentListener), EventListenerList

getMinimumSize

public Dimension getMinimumSize()

滚动条沿其滚动轴具有弹性，沿另一个轴具有刚性。

覆盖：

类 JComponent 中的 getMinimumSize

返回：

minimumSize 属性的值

另请参见：

JComponent.setMinimumSize(java.awt.Dimension), ComponentUI

getMaximumSize

public Dimension getMaximumSize()

滚动条沿其滚动轴具有弹性，沿另一个轴具有刚性。

覆盖：

类 JComponent 中的 getMaximumSize

返回：

maximumSize 属性的值

另请参见：

JComponent.setMaximumSize(java.awt.Dimension), ComponentUI

setEnabled

public void setEnabled(boolean x)

启用该组件以便滑块位置能够改变。如果被禁用，滑块位置将不能改变。

覆盖：

类 JComponent 中的 setEnabled

参数：

x - boolean 值，它为 true 时，启用该组件，它为 false 时，禁用该组件

另请参见：

Component.isEnabled(), Component.isLightweight()

paramString

protected String paramString()

返回此 JScrollBar 的字符串表示形式。此方法仅在进行调试的时候使用，对于各个实现，所返回字符串的内容和格式可能有所不同。返回的字符串可能为空，但不可能为 null。

覆盖：

类 JComponent 中的 paramString

返回：

此 JScrollBar 的字符串表示形式。

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此 JScrollBar 相关联的 AccessibleContext。对于 JScrollBar，AccessibleContext 采取 AccessibleJScrollBar 的形式。必要时创建新的 AccessibleJScrollBar 实例。

指定者：

接口 Accessible 中的 getAccessibleContext

覆盖：

类 JComponent 中的 getAccessibleContext

返回：

一个 AccessibleJScrollBar，它充当此 JScrollBar 的 AccessibleContext

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。