java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JScrollBar
- 所有已实现的接口：
Adjustable,ImageObserver,MenuContainer,Serializable,Accessible
- 已知子类：
JScrollPane.ScrollBar
@JavaBean (defaultProperty ="UI", description ="A component that helps determine the visible content range of an area.") public class JScrollBar extends JComponent implements Adjustable , Accessible
滚动条的实现。用户将旋钮定位在滚动条中以确定查看区域的内容。该程序通常会调整显示，使滚动条的末尾代表可显示内容的末尾，或 100% 的内容。滚动条的起点是可显示内容的起点，即 0%。旋钮在这些边界内的位置然后转换为可显示内容的相应百分比。
通常，当滚动条中旋钮的位置发生变化时，基础视图上的 JViewport 的位置也会发生相应的变化，从而改变 JViewport 的内容。
Warning: Swing 不是线程安全的。有关详细信息，请参阅 Swing 的线程策略。
Warning: 此类的序列化对象将与未来的 Swing 版本不兼容。当前的序列化支持适用于运行相同版本 Swing 的应用程序之间的短期存储或 RMI。从 1.4 开始，对所有 JavaBeans 的长期存储的支持已添加到 java.beans 包中。请参阅 XMLEncoder 。
- 自从：
- 1.2
- 参见：
-
内部类总结
内部类在类 javax.swing.JComponent 中声明的嵌套类/接口
JComponent.AccessibleJComponent在类 java.awt.Container 中声明的嵌套类/接口
Container.AccessibleAWTContainer -
字段摘要
字段修饰符和类型Field描述protected int存储在块（通常是“页面”）上/下请求时滚动条值更改的量。protected BoundedRangeModel表示滚动条的最小值、最大值、范围（也称为“visibleAmount”）和当前值的模型。protected int此滚动条的方向。protected int存储在单位向上/向下请求时滚动条值的更改量。在类 javax.swing.JComponent 中声明的字段
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW在类 java.awt.Component 中声明的字段
accessibleContext, 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(int orientation) 创建一个具有指定方向和以下初始值的滚动条：JScrollBar(int orientation, int value, int extent, int min, int max) 创建具有指定方向、值、范围、最小值和最大值的滚动条。 -
方法总结
修饰符和类型方法描述void添加一个 AdjustmentListener。protected voidfireAdjustmentValueChanged(int id, int type, int value) 通知监听滚动条的模型已更改。获取与此 JScrollBar 关联的 AccessibleContext。返回使用 addAdjustmentListener() 添加到此 JScrollBar 的所有AdjustmentListener的数组。int为了向后兼容 java.awt.Scrollbar。intgetBlockIncrement(int direction) 给定块（通常是“页面”）向上/向下请求，返回更改滚动条值的量。int滚动条的最大值是maximum - extent。滚动条沿其滚动轴是灵活的，而沿另一个轴是刚性的。int返回滚动条支持的最小值（通常为零）。滚动条沿其滚动轴是灵活的，而沿另一个轴是刚性的。getModel()返回处理滚动条的四个基本属性的数据模型：最小值、最大值、值、范围。int返回组件的方向（水平或垂直）。getUI()返回实现此组件外观的委托。返回此组件的 LookAndFeel 类的名称。int为了向后兼容 java.awt.Scrollbar。intgetUnitIncrement(int direction) 给定单位向上/向下请求，返回更改滚动条值的量。intgetValue()返回滚动条的值。boolean如果正在拖动滚动条旋钮，则为真。int返回滚动条的范围，也就是它的“visibleAmount”。protected String返回此 JScrollBar 的字符串表示形式。void删除 AdjustmentEvent 监听。voidsetBlockIncrement(int blockIncrement) 设置 blockIncrement 属性。voidsetEnabled(boolean x) 启用组件以便可以更改旋钮位置。voidsetMaximum(int maximum) 设置模型的最大属性。voidsetMinimum(int minimum) 设置模型的最小属性。voidsetModel(BoundedRangeModel newModel) 设置处理滚动条的四个基本属性的模型：最小值、最大值、值、范围。voidsetOrientation(int orientation) 将滚动条的方向设置为垂直或水平。voidsetUI(ScrollBarUI ui) 设置呈现此组件的 L&F 对象。voidsetUnitIncrement(int unitIncrement) 设置 unitIncrement 属性。voidsetValue(int value) 设置滚动条的值。voidsetValueIsAdjusting(boolean b) 设置模型的 valueIsAdjusting 属性。voidsetValues(int newValue, int newExtent, int newMin, int newMax) 在强制参数遵守通常的约束后设置四个 BoundedRangeModel 属性：voidsetVisibleAmount(int extent) 设置模型的范围属性。voidupdateUI()重写JComponent.updateUI在类 javax.swing.JComponent 中声明的方法
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, 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在类 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在类 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, 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, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
字段详细信息
-
model
表示滚动条的最小值、最大值、范围（也称为“visibleAmount”）和当前值的模型。- 参见：
-
orientation
protected int orientation此滚动条的方向。- 参见：
-
unitIncrement
protected int unitIncrement存储在单位向上/向下请求时滚动条值的更改量。- 参见：
-
blockIncrement
protected int blockIncrement存储在块（通常是“页面”）上/下请求时滚动条值更改的量。- 参见：
-
-
构造方法详细信息
-
JScrollBar
public JScrollBar(int orientation, int value, int extent, int min, int max) 创建具有指定方向、值、范围、最小值和最大值的滚动条。 “范围”是可视区域的大小。它也被称为“可见量”。注意：使用
setBlockIncrement将块增量设置为略小于视图范围的大小。这样，当用户将旋钮跳到相邻位置时，原始内容中的一行或两行将保留在视图中。- 参数：
orientation-JScrollBar的方向value- 一个给出当前值的整数extent- 一个整数，给出值可以“跳跃”的量min- 给出最小值的整数max- 一个给出最大值的整数- 抛出：
IllegalArgumentException- 如果方向不是 VERTICAL、HORIZONTAL 之一- 参见：
-
JScrollBar
public JScrollBar(int orientation) 创建一个具有指定方向和以下初始值的滚动条：minimum = 0 maximum = 100 value = 0 extent = 10
- 参数：
orientation-JScrollBar的方向
-
JScrollBar
public JScrollBar()创建具有以下初始值的垂直滚动条：minimum = 0 maximum = 100 value = 0 extent = 10
-
-
方法详情
-
setUI
@BeanProperty (hidden =true, visualUpdate =true, description ="The UI object that implements the Component\'s LookAndFeel") public void setUI(ScrollBarUI ui) 设置呈现此组件的 L&F 对象。- 参数：
ui-ScrollBarUIL&F 对象- 自从：
- 1.4
- 参见：
-
getUI
返回实现此组件外观的委托。- 重写：
getUI在类JComponent中- 返回：
- 滚动条的当前 UI。
- 参见：
-
updateUI
public void updateUI()重写JComponent.updateUI- 重写：
updateUI在类JComponent中- 参见：
-
getUIClassID
返回此组件的 LookAndFeel 类的名称。- 重写：
getUIClassID在类JComponent中- 返回：
- 字符串“ScrollBarUI”
- 参见：
-
getOrientation
public int getOrientation()返回组件的方向（水平或垂直）。- 指定者：
getOrientation在接口Adjustable中- 返回：
- 垂直或水平
- 参见：
-
setOrientation
@BeanProperty (preferred =true, visualUpdate =true, enumerationValues ={"JScrollBar.VERTICAL","JScrollBar.HORIZONTAL"}, description ="The scrollbar\'s orientation.") public void setOrientation(int orientation) 将滚动条的方向设置为垂直或水平。- 参数：
orientation-JScrollBar的方向- 抛出：
IllegalArgumentException- 如果方向不是 VERTICAL、HORIZONTAL 之一- 参见：
-
getModel
返回处理滚动条的四个基本属性的数据模型：最小值、最大值、值、范围。- 返回：
- 数据模型
- 参见：
-
setModel
@BeanProperty (expert =true, description ="The scrollbar\'s BoundedRangeModel.") public void setModel(BoundedRangeModel newModel) 设置处理滚动条的四个基本属性的模型：最小值、最大值、值、范围。- 参数：
newModel- 新型号- 参见：
-
getUnitIncrement
public int getUnitIncrement(int direction) 给定单位向上/向下请求，返回更改滚动条值的量。当用户单击滚动条上/下箭头并使用结果更新滚动条的值时，ScrollBarUI 实现通常会调用此方法。子类可以重写此方法来计算一个值，例如滚动一行（可变高度）文本或表格中的一行所需的更改。JScrollPane 组件创建滚动条（默认情况下）重写此方法并委托给视口 Scrollable 视图（如果有的话）。 Scrollable 接口提供了此方法的更专用版本。
一些提供自定义滚动行为的外观实现会忽略此属性。
- 参数：
direction- 分别为 -1 或 1 表示向上/向下- 返回：
- unitIncrement 属性的值
- 参见：
-
setUnitIncrement
@BeanProperty (preferred =true, description ="The scrollbar\'s unit increment.") public void setUnitIncrement(int unitIncrement) 设置 unitIncrement 属性。请注意，如果参数等于 Integer.MIN_VALUE 的值，那么大多数外观实现将不提供向右/向下滚动。
一些提供自定义滚动行为的外观实现会忽略此属性。
- 指定者：
setUnitIncrement在接口Adjustable中- 参数：
unitIncrement- 单位增量- 参见：
-
getBlockIncrement
public int getBlockIncrement(int direction) 给定块（通常是“页面”）向上/向下请求，返回更改滚动条值的量。当用户在滚动条“旋钮”外部单击以大幅向上或向下滚动时，ScrollBarUI 实现通常会调用此方法。子类可以重写此方法来计算一个值，例如滚动文本文档中的一个段落所需的更改。JScrollPane 组件创建滚动条（默认情况下）重写此方法并委托给视口 Scrollable 视图（如果有的话）。 Scrollable 接口提供了此方法的更专用版本。
一些提供自定义滚动行为的外观实现会忽略此属性。
- 参数：
direction- 分别为 -1 或 1 表示向上/向下- 返回：
- blockIncrement 属性的值
- 参见：
-
setBlockIncrement
@BeanProperty (preferred =true, description ="The scrollbar\'s block increment.") public void setBlockIncrement(int blockIncrement) 设置 blockIncrement 属性。请注意，如果参数等于 Integer.MIN_VALUE 的值，那么大多数外观实现将不提供向右/向下滚动。
一些提供自定义滚动行为的外观实现会忽略此属性。
- 指定者：
setBlockIncrement在接口Adjustable中- 参数：
blockIncrement- 块增量- 参见：
-
getUnitIncrement
public int getUnitIncrement()为了向后兼容 java.awt.Scrollbar。- 指定者：
getUnitIncrement在接口Adjustable中- 返回：
- 可调对象的单位值增量
- 参见：
-
getBlockIncrement
public int getBlockIncrement()为了向后兼容 java.awt.Scrollbar。- 指定者：
getBlockIncrement在接口Adjustable中- 返回：
- 可调整对象的块值增量
- 参见：
-
getValue
public int getValue()返回滚动条的值。- 指定者：
getValue在接口Adjustable中- 返回：
- 模型的值属性
- 参见：
-
setValue
@BeanProperty (bound =false, preferred =true, description ="The scrollbar\'s current value.") public void setValue(int value) 设置滚动条的值。此方法只是将值转发给模型。- 指定者：
setValue在接口Adjustable中- 参数：
value- 当前值，介于minimum和maximum-visibleAmount- 参见：
-
getVisibleAmount
public int getVisibleAmount()返回滚动条的范围，也就是它的“visibleAmount”。在许多滚动条外观实现中，滚动条“旋钮”或“拇指”的大小与范围成正比。- 指定者：
getVisibleAmount在接口Adjustable中- 返回：
- 模型的范围属性的值
- 参见：
-
setVisibleAmount
@BeanProperty (bound =false, preferred =true, description ="The amount of the view that is currently visible.") public void setVisibleAmount(int extent) 设置模型的范围属性。- 指定者：
setVisibleAmount在接口Adjustable中- 参数：
extent- 指标的长度- 参见：
-
getMinimum
public int getMinimum()返回滚动条支持的最小值（通常为零）。- 指定者：
getMinimum在接口Adjustable中- 返回：
- 模型最小属性的值
- 参见：
-
setMinimum
@BeanProperty (bound =false, preferred =true, description ="The scrollbar\'s minimum value.") public void setMinimum(int minimum) 设置模型的最小属性。- 指定者：
setMinimum在接口Adjustable中- 参数：
minimum- 最小值- 参见：
-
getMaximum
public int getMaximum()滚动条的最大值是maximum - extent。- 指定者：
getMaximum在接口Adjustable中- 返回：
- 模型最大属性的值
- 参见：
-
setMaximum
@BeanProperty (bound =false, preferred =true, description ="The scrollbar\'s maximum value.") public void setMaximum(int maximum) 设置模型的最大属性。请注意，滚动条的值只能设置为最大范围。- 指定者：
setMaximum在接口Adjustable中- 参数：
maximum- 最大值- 参见：
-
getValueIsAdjusting
public boolean getValueIsAdjusting()如果正在拖动滚动条旋钮，则为真。- 返回：
- 模型的 valueIsAdjusting 属性的值
- 参见：
-
setValueIsAdjusting
@BeanProperty (bound =false, expert =true, description ="True if the scrollbar thumb is being dragged.") public void setValueIsAdjusting(boolean b) 设置模型的 valueIsAdjusting 属性。滚动条外观实现应在旋钮拖动开始时将此属性设置为 true，在拖动结束时设置为 false。当 valueIsAdjusting 为真时，滚动条模型不会生成 ChangeEvents。- 参数：
b-true如果即将对 value 属性进行的更改是系列的一部分- 参见：
-
setValues
public void setValues(int newValue, int newExtent, int newMin, int newMax) 在强制参数遵守通常的约束后设置四个 BoundedRangeModel 属性：minimum ≤ value ≤ value+extent ≤ maximum
- 参数：
newValue- 一个给出当前值的整数newExtent- 一个整数，给出值可以“跳跃”的量newMin- 一个给出最小值的整数newMax- 一个给出最大值的整数- 参见：
-
addAdjustmentListener
添加一个 AdjustmentListener。每次滚动条的模型更改时都会通知调整监听。提供调整事件是为了向后兼容 java.awt.Scrollbar。请注意，AdjustmentEvents 类型属性将始终具有占位符值 AdjustmentEvent.TRACK，因为对 BoundedRangeModels 值的所有更改都被视为等效。要更改 BoundedRangeModel 的值，只需设置其值属性，即 model.setValue(123)。没有提供有关更改来源的信息，例如，它是块减量。我们不会在这里捏造变化的来源。
- 指定者：
addAdjustmentListener在接口Adjustable中- 参数：
l- 要添加的 AdjustmentLister- 参见：
-
removeAdjustmentListener
删除 AdjustmentEvent 监听。- 指定者：
removeAdjustmentListener在接口Adjustable中- 参数：
l- 要删除的 AdjustmentLister- 参见：
-
getAdjustmentListeners
返回使用 addAdjustmentListener() 添加到此 JScrollBar 的所有AdjustmentListener的数组。- 返回：
-
添加所有
AdjustmentListeners，如果没有添加任何监听器，则为空数组 - 自从：
- 1.4
-
fireAdjustmentValueChanged
protected void fireAdjustmentValueChanged(int id, int type, int value) 通知监听滚动条的模型已更改。- 参数：
id- 表示事件类型的整数。type- 表示调整类型的整数。value- 调整的当前值- 参见：
-
getMinimumSize
滚动条沿其滚动轴是灵活的，而沿另一个轴是刚性的。- 重写：
getMinimumSize在类JComponent中- 返回：
minimumSize属性的值- 参见：
-
getMaximumSize
滚动条沿其滚动轴是灵活的，而沿另一个轴是刚性的。- 重写：
getMaximumSize在类JComponent中- 返回：
maximumSize属性的值- 参见：
-
setEnabled
public void setEnabled(boolean x) 启用组件以便可以更改旋钮位置。禁用时，旋钮位置无法更改。- 重写：
setEnabled在类JComponent中- 参数：
x- 一个boolean，其中 true 启用组件，false 禁用它- 参见：
-
paramString
返回此 JScrollBar 的字符串表示形式。此方法仅用于调试目的，返回字符串的内容和格式可能因实现而异。返回的字符串可能为空，但可能不是null。- 重写：
paramString在类JComponent中- 返回：
- 此 JScrollBar 的字符串表示形式。
-
getAccessibleContext
获取与此 JScrollBar 关联的 AccessibleContext。对于 JScrollBar，AccessibleContext 采用 AccessibleJScrollBar 的形式。如有必要，将创建一个新的 AccessibleJScrollBar 实例。- 指定者：
getAccessibleContext在接口Accessible中- 重写：
getAccessibleContext在类Component中- 返回：
- 作为此 JScrollBar 的 AccessibleContext 的 AccessibleJScrollBar
-