当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版
javax.swing
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
JScrollBar (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
javax.swing
类 JScrollBar
java.lang.Objectjava.awt.Component
- 所有已实现的接口：
- Adjustable, ImageObserver, MenuContainer, Serializable, Accessible
- 直接已知子类：
- JScrollPane.ScrollBar
public class JScrollBar
- extends JComponent
- implements Adjustable, Accessible
- extends JComponent
滚动条的实现。用户在滚动条内移动滑块可确定显示区域中的内容。该程序通常将显示调整为滚动条的结束代表可显示内容的结束，或内容的 100%。滚动条的开始为可显示内容的开始，或 0%。然后滑块在其边界中的位置转换为可显示内容对应的百分比。
通常，随着滑块的位置在滚动条中的变化，将在基础视图上对 JViewport 的位置进行相应的更改，这样 JViewport 的内容也随之改变。
警告：Swing 不是线程安全的。有关更多信息，请参阅 Swing's Threading Policy。
警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 XMLEncoder。
- 另请参见：
JScrollPane
| 嵌套类摘要 | |
|---|---|
protected class |
JScrollBar.AccessibleJScrollBar
此类实现 JScrollBar 类的可访问性支持。 |
| 从类 javax.swing.JComponent 继承的嵌套类/接口 |
|---|
JComponent.AccessibleJComponent |
| 从类 java.awt.Container 继承的嵌套类/接口 |
|---|
Container.AccessibleAWTContainer |
| 从类 java.awt.Component 继承的嵌套类/接口 |
|---|
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy |
| 字段摘要 | |
|---|---|
protected int |
blockIncrement
|
protected BoundedRangeModel |
model
表示滚动条的最小、最大、跨度（也叫 "visibleAmount"）和当前值的模型。 |
protected int |
orientation
|
protected int |
unitIncrement
|
| 从类 javax.swing.JComponent 继承的字段 |
|---|
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW |
| 从类 java.awt.Component 继承的字段 |
|---|
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
| 从接口 java.awt.Adjustable 继承的字段 |
|---|
HORIZONTAL, NO_ORIENTATION, VERTICAL |
| 从接口 java.awt.image.ImageObserver 继承的字段 |
|---|
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
| 构造方法摘要 | |
|---|---|
JScrollBar()
创建具有下列初始值的垂直滚动条： |
|
JScrollBar(int orientation)
创建具有指定方向和下列初始值的滚动条： |
|
JScrollBar(int orientation,
int value,
int extent,
int min,
int max)
创建具有指定方向、值、跨度、最小值和最大值的一个滚动条。 |
|
| 方法摘要 | |
|---|---|
void |
addAdjustmentListener(AdjustmentListener l)
添加一个 AdjustmentListener。 |
protected void |
fireAdjustmentValueChanged(int id,
int type,
int value)
通知侦听器该滚动条的模型已更改。 |
AccessibleContext |
getAccessibleContext()
获取与此 JScrollBar 相关联的 AccessibleContext。 |
AdjustmentListener[] |
getAdjustmentListeners()
返回使用 addAdjustmentListener() 添加到此 JScrollBar 中的 AdjustmentListener 组成的数组。 |
int |
getBlockIncrement()
供与 java.awt.Scrollbar 向后兼容。 |
int |
getBlockIncrement(int direction)
针对一个向上/向下滚动一个块（通常为 "page"）的请求，返回滚动条值的更改量。 |
int |
getMaximum()
滚动条的最大值为最大跨度。 |
Dimension |
getMaximumSize()
滚动条沿其滚动轴具有弹性，沿另一个轴具有刚性。 |
int |
getMinimum()
返回滚动条支持的最小值（通常为 0）。 |
Dimension |
getMinimumSize()
滚动条沿其滚动轴具有弹性，沿另一个轴具有刚性。 |
BoundedRangeModel |
getModel()
返回处理滚动条的四个基本属性的数据模型：minimum、maximum、value 和 extent。 |
int |
getOrientation()
返回组件的方向（横向或纵向）。 |
ScrollBarUI |
getUI()
返回实现此组件的外观的委托。 |
String |
getUIClassID()
返回此组件的 LookAndFeel 类的名称。 |
int |
getUnitIncrement()
供与 java.awt.Scrollbar 向后兼容。 |
int |
getUnitIncrement(int direction)
针对一个向上/向下滚动一个单位的请求，返回滚动条值的更改量。 |
int |
getValue()
返回滚动条的值。 |
boolean |
getValueIsAdjusting()
如果滚动条滑块被拖动，则返回 True。 |
int |
getVisibleAmount()
返回滚动条的跨度，即它的 "visibleAmount"。 |
protected String |
paramString()
返回此 JScrollBar 的字符串表示形式。 |
void |
removeAdjustmentListener(AdjustmentListener l)
移除一个 AdjustmentEvent 侦听器。 |
void |
setBlockIncrement(int blockIncrement)
设置 blockIncrement 属性。 |
void |
setEnabled(boolean x)
启用该组件以便滑块位置能够改变。 |
void |
setMaximum(int maximum)
设置模型的 maximum 属性。 |
void |
setMinimum(int minimum)
设置模型的 minimum 属性。 |
void |
setModel(BoundedRangeModel newModel)
设置处理滚动条的以下四个基本属性的模型：minimum、maximum、value 和 extent。 |
void |
setOrientation(int orientation)
将滚动条的方向设置为 VERTICAL 或 HORIZONTAL。 |
void |
setUI(ScrollBarUI ui)
设置呈现此组件的 L&F 对象。 |
void |
setUnitIncrement(int unitIncrement)
设置 unitIncrement 属性。 |
void |
setValue(int value)
设置滚动条的值。 |
void |
setValueIsAdjusting(boolean b)
设置模型的 valueIsAdjusting 属性。 |
void |
setValues(int newValue,
int newExtent,
int newMin,
int newMax)
强制参数满足以下常规约束后设置四个 BoundedRangeModel 属性： |
void |
setVisibleAmount(int extent)
设置模型的 extent 属性。 |
void |
updateUI()
重写 JComponent.updateUI。 |
| 从类 java.lang.Object 继承的方法 |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| 字段详细信息 |
|---|
model
protected BoundedRangeModel model
- 表示滚动条的最小、最大、跨度（也叫 "visibleAmount"）和当前值的模型。
orientation
protected int orientation
- 另请参见：
setOrientation(int)
unitIncrement
protected int unitIncrement
blockIncrement
protected int blockIncrement
| 构造方法详细信息 |
|---|
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-ScrollBarUIL&F 对象- 从以下版本开始：
- 1.4
- 另请参见：
UIDefaults.getUI(javax.swing.JComponent)
getUI
public ScrollBarUI getUI()
- 返回实现此组件的外观的委托。
updateUI
public void 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
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。
setValues
public void setValues(int newValue,
int newExtent,
int newMin,
int newMax)
- 强制参数满足以下常规约束后设置四个 BoundedRangeModel 属性：
minimum <= value <= value+extent <= maximum
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)
- 通知侦听器该滚动条的模型已更改。
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
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。