javax.swing

Class JScrollBar

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JScrollBar

All Implemented Interfaces:

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版本不兼容。当前的序列化支持适用于短期贮藏或RMI运行相同Swing版本的应用程序之间。为1.4，为所有JavaBeans™长期存储的支持已被添加到java.beans包。请看XMLEncoder。

另请参见：

JScrollPane

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	JScrollBar.AccessibleJScrollBar 这个类实现了对 JScrollBar类可访问性支持。

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

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
protected int	blockIncrement
protected BoundedRangeModel	model 该模型表示滚动条的最小、最大、程度（又名“下可见大量”）和电流值。
protected int	orientation
protected int	unitIncrement

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.Adjustable

HORIZONTAL, NO_ORIENTATION, VERTICAL

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

构造方法

Constructor and Description
JScrollBar() 创建一个初始值，垂直滚动条的下面：
JScrollBar(int orientation) 创建一个具有指定方向和下面的初始值的滚动条：
JScrollBar(int orientation, int value, int extent, int min, int max) 创建一个指定的方向，滚动条的值，最小值，和最大程度。

方法摘要

Modifier and Type	Method and Description
void	addAdjustmentListener(AdjustmentListener l) 增加了一个adjustmentlistener。
protected void	fireAdjustmentValueChanged(int id, int type, int value) 通知听众，滚动条上的模型已经改变。
AccessibleContext	getAccessibleContext() 获取与此相关的accessiblecontext JScrollBar。
AdjustmentListener[]	getAdjustmentListeners() 返回所有的 AdjustmentListeners数组添加到使用与addadjustmentlistener()。
int	getBlockIncrement() 与java.awt.scrollbar向后兼容性。
int	getBlockIncrement(int direction) 退货量改变滚动条的值，给定一块（通常是“页”）上/下的要求。
int	getMaximum() 滚动条的最大值是最大程度。
Dimension	getMaximumSize() 滚动条的滚动轴和沿刚性沿着其他轴柔性。
int	getMinimum() 返回由滚动条支持的最小值（通常为零）。
Dimension	getMinimumSize() 滚动条的滚动轴和沿刚性沿着其他轴柔性。
BoundedRangeModel	getModel() 返回数据模型处理滚动条上的四个基本性质：最小值，最大值，范围。
int	getOrientation() 返回组件的方向（水平或垂直方向）。
ScrollBarUI	getUI() 返回实现此组件的外观和感觉的委托。
String	getUIClassID() 这个组件返回的LookAndFeel类的名称。
int	getUnitIncrement() 与java.awt.scrollbar向后兼容性。
int	getUnitIncrement(int direction) 退货量改变滚动条的值，给出了单位上下的要求。
int	getValue() 返回滚动条的值。
boolean	getValueIsAdjusting() 如果滚动旋钮被拖。
int	getVisibleAmount() 返回滚动条的范围，又名“下可见大量”。
protected String	paramString() 返回JScrollBar的字符串表示。
void	removeAdjustmentListener(AdjustmentListener l) 删除一个adjustmentevent听众。
void	setBlockIncrement(int blockIncrement) 集blockincrement财产。
void	setEnabled(boolean x) 使组件，使旋钮位置可以改变。
void	setMaximum(int maximum) 设置模型的最大属性。
void	setMinimum(int minimum) 设置模型的最小属性。
void	setModel(BoundedRangeModel newModel) 集处理滚动条上的四个基本性质的模型：最小，最大，价值、程度。
void	setOrientation(int orientation) 设置滚动条的方向垂直或水平。
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) 设置模型的程度属性。
void	updateUI() 覆盖 JComponent.updateUI。

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, 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, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, 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

model

protected BoundedRangeModel model

该模型表示滚动条的最小、最大、程度（又名“下可见大量”）和电流值。

另请参见：

setModel(javax.swing.BoundedRangeModel)

orientation

protected int orientation

另请参见：

setOrientation(int)

unitIncrement

protected int unitIncrement

另请参见：

setUnitIncrement(int)

blockIncrement

protected int blockIncrement

另请参见：

setBlockIncrement(int)

Constructor Detail

JScrollBar

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

创建一个指定的方向，滚动条的值，最小值，和最大程度。“程度”是可视区域的大小。它也被称为“可见金额”。

注意：使用setBlockIncrement设置块增量比视图的程度稍小的尺寸。这样，当用户将旋钮跳转到一个相邻的位置时，一个或两个原始内容的行仍然在视图中。

异常

IllegalArgumentException如果方向不垂直、水平

另请参见：

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

JScrollBar

public JScrollBar(int orientation)

创建一个具有指定方向和下面的滚动条：

最小= 0最大= 100价值= 0程度= 10

初始值

JScrollBar

public JScrollBar()

创建一个与初始值垂直滚动条：

最小= 0最大= 100价值= 0程度= 10

方法详细信息

setUI

public void setUI(ScrollBarUI ui)

设置呈现此组件的“L”和F对象。

参数

ui - ScrollBarUI L和F的对象

从以下版本开始：

一点四

另请参见：

UIDefaults.getUI(javax.swing.JComponent)

getUI

public ScrollBarUI getUI()

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

另请参见：

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

updateUI

public void updateUI()

覆盖 JComponent.updateUI。

重写：

updateUI 方法重写，继承类 JComponent

另请参见：

JComponent.updateUI()

getUIClassID

public String getUIClassID()

这个组件返回的LookAndFeel类的名称。

重写：

getUIClassID 方法重写，继承类 JComponent

结果

“scrollbarui”

另请参见：

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

getOrientation

public int getOrientation()

返回组件的方向（水平或垂直方向）。

Specified by:

getOrientation 接口 Adjustable

结果

垂直或水平

另请参见：

setOrientation(int)， Adjustable.getOrientation()

setOrientation

public void setOrientation(int orientation)

设置滚动条的方向垂直或水平。

异常

IllegalArgumentException如果方向不垂直、水平

另请参见：

getOrientation()

getModel

public BoundedRangeModel getModel()

返回数据模型处理滚动条上的四个基本性质：最小值，最大值，范围。

另请参见：

setModel(javax.swing.BoundedRangeModel)

setModel

public void setModel(BoundedRangeModel newModel)

集处理滚动条上的四个基本性质的模型：最小，最大，价值、程度。

另请参见：

getModel()

getUnitIncrement

public int getUnitIncrement(int direction)

退货量改变滚动条的值，给出了单位上下的要求。一个scrollbarui实施通常调用此方法，当用户点击滚动条的上/下箭头，用结果来更新滚动条的值。我的重写这个方法来计算一个值，例如，向上或向下滚动一个（可变高度）行文本或一行中的一行所需的变化。

在JScrollPane组件创建滚动条（默认），重写此方法并授予视图滚动视图，如果它有一个。滚动界面提供一个更专业的版本的方法。

一些外观和感觉实现自定义滚动的行为，忽略此属性。

参数

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价值，大多数的外观和感觉不会提供滚动到右/下。

一些外观和感觉实现自定义滚动的行为，忽略此属性。

Specified by:

setUnitIncrement 接口 Adjustable

参数

unitIncrement -单位增量

另请参见：

getUnitIncrement(int)

getBlockIncrement

public int getBlockIncrement(int direction)

退货量改变滚动条的值，给定一块（通常是“页”）上/下的要求。一个scrollbarui实施通常调用此方法，当用户点击上方或下方的滚动条“旋钮”通过大量上升或下降的变化值。我的子类重写此方法来计算一个值，例如在文本文档中向上或向下移动一个段落所需的变化。

在JScrollPane组件创建滚动条（默认），重写此方法并授予视图滚动视图，如果它有一个。滚动界面提供一个更专业的版本的方法。

一些外观和感觉实现自定义滚动的行为，忽略此属性。

参数

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价值，大多数的外观和感觉不会提供滚动到右/下。

一些外观和感觉实现自定义滚动的行为，忽略此属性。

Specified by:

setBlockIncrement 接口 Adjustable

参数

blockIncrement的块增量

另请参见：

getBlockIncrement()

getUnitIncrement

public int getUnitIncrement()

与java.awt.scrollbar向后兼容性。

Specified by:

getUnitIncrement 接口 Adjustable

结果

可调对象的单位值增量

另请参见：

Adjustable.getUnitIncrement()， getUnitIncrement(int)

getBlockIncrement

public int getBlockIncrement()

与java.awt.scrollbar向后兼容性。

Specified by:

getBlockIncrement 接口 Adjustable

结果

可调对象的块值增量

另请参见：

Adjustable.getBlockIncrement()， getBlockIncrement(int)

getValue

public int getValue()

返回滚动条的值。

Specified by:

getValue 接口 Adjustable

结果

模型的价值属性

另请参见：

setValue(int)

setValue

public void setValue(int value)

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

Specified by:

setValue 接口 Adjustable

参数

value的电流值， minimum和 maximum - visibleAmount之间

另请参见：

getValue()， BoundedRangeModel.setValue(int)

getVisibleAmount

public int getVisibleAmount()

返回滚动条的范围，又名“下可见大量”。在滚动条的外观和感觉的实现规模的滚动条“旋钮”或“拇指”的程度成正比。

Specified by:

getVisibleAmount 接口 Adjustable

结果

模型在一定程度上的价值

另请参见：

setVisibleAmount(int)

setVisibleAmount

public void setVisibleAmount(int extent)

设置模型的程度属性。

Specified by:

setVisibleAmount 接口 Adjustable

参数

extent -指示的长度

另请参见：

getVisibleAmount()， BoundedRangeModel.setExtent(int)

getMinimum

public int getMinimum()

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

Specified by:

getMinimum 接口 Adjustable

结果

模型的最小属性值

另请参见：

setMinimum(int)

setMinimum

public void setMinimum(int minimum)

设置模型的最小属性。

Specified by:

setMinimum 接口 Adjustable

参数

minimum -最小值

另请参见：

getMinimum()， BoundedRangeModel.setMinimum(int)

getMaximum

public int getMaximum()

滚动条的最大值是最大程度。

Specified by:

getMaximum 接口 Adjustable

结果

模型最大属性值

另请参见：

setMaximum(int)

setMaximum

public void setMaximum(int maximum)

设置模型的最大属性。注意滚动条的值只能设置到最大程度。

Specified by:

setMaximum 接口 Adjustable

参数

maximum -最大值

另请参见：

getMaximum()， BoundedRangeModel.setMaximum(int)

getValueIsAdjusting

public boolean getValueIsAdjusting()

如果滚动旋钮被拖。

结果

该模型的valueisadjusting属性的值

另请参见：

setValueIsAdjusting(boolean)

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)

设置模型的valueisadjusting财产。滚动条的外观和感觉的实现应该将该属性设置为true时，旋钮阻力开始，和假当拖动结束。滚动模式不会产生changeevents而valueisadjusting是真实的。

另请参见：

getValueIsAdjusting()， BoundedRangeModel.setValueIsAdjusting(boolean)

setValues

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

四套的性能参数后BoundedRangeModel强迫服从一般的约束：

最小≤价值≤价值+≤最大程度

另请参见：

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提供向后兼容性。

请注意，adjustmentevents型属性将始终有一个adjustmentevent.track占位符的值是一个boundedrangemodels值变化等效。改变一个BoundedRangeModel一套价值只是其价值的财产，即模型的设定值（123）。没有有关更改的起源的信息，例如，它是一个块递减，提供。我们不尝试在这里制造变化的起源。

Specified by:

addAdjustmentListener 接口 Adjustable

参数

l - adjustmentlister添加

另请参见：

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

removeAdjustmentListener

public void removeAdjustmentListener(AdjustmentListener l)

删除一个adjustmentevent听众。

Specified by:

removeAdjustmentListener 接口 Adjustable

参数

l - adjustmentlister删除

另请参见：

addAdjustmentListener(java.awt.event.AdjustmentListener)

getAdjustmentListeners

public AdjustmentListener[] getAdjustmentListeners()

返回所有的 AdjustmentListeners数组添加到使用与addadjustmentlistener()。

结果

所有的 AdjustmentListeners说如果没有听众已添加一个空数组

从以下版本开始：

一点四

fireAdjustmentValueChanged

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

通知听众，滚动条上的模型已经改变。

另请参见：

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

getMinimumSize

public Dimension getMinimumSize()

滚动条的滚动轴和沿刚性沿着其他轴柔性。

重写：

getMinimumSize 方法重写，继承类 JComponent

结果

该 minimumSize属性的值

另请参见：

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

getMaximumSize

public Dimension getMaximumSize()

滚动条的滚动轴和沿刚性沿着其他轴柔性。

重写：

getMaximumSize 方法重写，继承类 JComponent

结果

该 maximumSize属性的值

另请参见：

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

setEnabled

public void setEnabled(boolean x)

使组件，使旋钮位置可以改变。当禁用时，旋钮位置不能更改。

重写：

setEnabled 方法重写，继承类 JComponent

参数

x -一个布尔值，真正使组件和假禁用它

另请参见：

Component.isEnabled()， Component.isLightweight()

paramString

protected String paramString()

返回JScrollBar的字符串表示。此方法仅用于调试目的，返回的字符串的内容和格式可能会在实现过程中有所不同。返回的字符串是空的但可能不 null。

重写：

paramString 方法重写，继承类 JComponent

结果

这个JScrollBar的字符串表示。

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此相关的accessiblecontext JScrollBar。对于使用的accessiblecontext，以一个accessiblejscrollbar形式。一个新的accessiblejscrollbar实例被创建时。

Specified by:

getAccessibleContext 接口 Accessible

重写：

getAccessibleContext 方法重写，继承类 Component

结果

一个accessiblejscrollbar作为本使用的accessiblecontext