java.applet

java.awt

java.awt.color

java.awt.datatransfer

java.awt.dnd

java.awt.event

java.awt.font

java.awt.geom

java.awt.im

java.awt.im.spi

java.awt.image

java.awt.image.renderable

java.awt.print

java.beans

java.beans.beancontext

java.io

java.lang

java.lang.annotation

java.lang.instrument

java.lang.management

java.lang.ref

java.lang.reflect

java.math

java.net

java.nio

java.nio.channels

java.nio.channels.spi

java.nio.charset

java.nio.charset.spi

java.rmi

java.rmi.activation

java.rmi.dgc

java.rmi.registry

java.rmi.server

java.security

java.security.acl

java.security.cert

java.security.interfaces

java.security.spec

java.sql

java.text

java.util

java.util.concurrent

java.util.concurrent.atomic

java.util.concurrent.locks

java.util.jar

java.util.logging

java.util.prefs

java.util.regex

java.util.zip

javax.accessibility

javax.activity

javax.crypto

javax.crypto.interfaces

javax.crypto.spec

javax.imageio

javax.imageio.event

javax.imageio.metadata

javax.imageio.plugins.bmp

javax.imageio.plugins.jpeg

javax.imageio.spi

javax.imageio.stream

javax.management

javax.management.loading

javax.management.modelmbean

javax.management.monitor

javax.management.openmbean

javax.management.relation

javax.management.remote

javax.management.remote.rmi

javax.management.timer

javax.naming

javax.naming.directory

javax.naming.event

javax.naming.ldap

javax.naming.spi

javax.net

javax.net.ssl

javax.print

javax.print.attribute

javax.print.attribute.standard

javax.print.event

javax.rmi

javax.rmi.CORBA

javax.rmi.ssl

javax.security.auth

javax.security.auth.callback

javax.security.auth.kerberos

javax.security.auth.login

javax.security.auth.spi

javax.security.auth.x500

javax.security.cert

javax.security.sasl

javax.sound.midi

javax.sound.midi.spi

javax.sound.sampled

javax.sound.sampled.spi

javax.sql

javax.sql.rowset

javax.sql.rowset.serial

javax.sql.rowset.spi

javax.swing

javax.swing.border

javax.swing.colorchooser

javax.swing.event

javax.swing.filechooser

javax.swing.plaf

javax.swing.plaf.basic

javax.swing.plaf.metal

javax.swing.plaf.multi

javax.swing.plaf.synth

javax.swing.table

javax.swing.text

javax.swing.text

javax.swing.text.parser

javax.swing.text.rtf

javax.swing.tree

javax.swing.undo

javax.transaction

javax.transaction.xa

javax.xml

javax.xml.datatype

javax.xml.namespace

javax.xml.parsers

javax.xml.transform

javax.xml.transform.dom

javax.xml.transform.sax

javax.xml.transform.stream

javax.xml.validation

javax.xml.xpath

org.ietf.jgss

org.omg.CORBA

org.omg.CORBA_2_3

org.omg.CORBA_2_3.portable

org.omg.CORBA.DynAnyPackage

org.omg.CORBA.ORBPackage

org.omg.CORBA.portable

org.omg.CORBA.TypeCodePackage

org.omg.CosNaming

org.omg.CosNaming.NamingContextExtPackage

org.omg.CosNaming.NamingContextPackage

org.omg.Dynamic

org.omg.DynamicAny

org.omg.DynamicAny.DynAnyFactoryPackage

org.omg.DynamicAny.DynAnyPackage

org.omg.IOP

org.omg.IOP.CodecFactoryPackage

org.omg.IOP.CodecPackage

org.omg.Messaging

org.omg.PortableInterceptor

org.omg.PortableInterceptor.ORBInitInfoPackage

org.omg.PortableServer

org.omg.PortableServer.CurrentPackage

org.omg.PortableServer.POAManagerPackage

org.omg.PortableServer.POAPackage

org.omg.PortableServer.portable

org.omg.PortableServer.ServantLocatorPackage

org.omg.SendingContext

org.omg.stub.java.rmi

org.w3c.dom

org.w3c.dom.bootstrap

org.w3c.dom.events

org.w3c.dom.ls

org.xml.sax

org.xml.sax.ext

org.xml.sax.helpers

allclasses-frame

allclasses-noframe

constant-values

deprecated-list

help-doc

JavaTM 2 Platform
Standard Ed. 5.0

java.awt
类 Scrollbar

java.lang.Object
  继承者 java.awt.Component
      继承者 java.awt.Scrollbar
所有已实现的接口:
Adjustable, ImageObserver, MenuContainer, Serializable, Accessible

public class Scrollbar
extends Component
implements Adjustable, Accessible

Scrollbar 类描述了一个滚动条,这是大家所熟悉的用户界面对象。滚动条提供了一个允许用户在一定范围的值中进行选择的便捷方式。可以将以下三个垂直滚动条用作滑动块控件,以选择红、绿和蓝三种颜色的分量:

图像并排显示了三个垂直滑动块。

在此例中,每个滚动条都是使用类似于下面的代码创建的:


 redSlider=new Scrollbar(Scrollbar.VERTICAL, 0, 1, 0, 255);
 add(redSlider);
 

此外,滚动条还可以表示某一范围的值。例如,如果滚动条用于滚动文本,则可以使用 "bubble"(也称为 "thumb" 或 "scroll box")的宽度来表示可视的文本数。下面是表示某一范围的滚动条:

图像显示了水平滑动块,其初始范围为 0,终止范围为 300。滑动块被标记为 60。

在这个例子中,滑动块表示的值范围是可视量。此例中的水平滚动条可以用以下代码来创建:


 ranger = new Scrollbar(Scrollbar.HORIZONTAL, 0, 60, 0, 300);
 add(ranger);
 

注意,滚动条的实际最大值是 maximum 减去 visible amount。在前面的例子中,因为 maximum 是 300,visible amount 是 60,所以实际最大值是 240。滚动条轨道的范围是 0 - 300。滑动块的左侧指示了滚动条的值。

通常,用户通过使用鼠标来改变滚动条的值。例如,用户可以上下拖动滚动条的滑动块,或单击滚动条的单位增量或块增量区域。键盘动作也能映射到滚动条。按照惯例,Page UpPage Down 键等同于单击滚动条的块增量和块减量区域。

当用户改变滚动条的值时,滚动条接收一个 AdjustmentEvent 实例。滚动条处理此事件,将它传递给所有已注册的侦听器。

任何希望滚动条值发生变化时被通知的对象都应该实现包 java.awt.event 中定义的 AdjustmentListener 接口。调用 addAdjustmentListenerremoveAdjustmentListener 方法能动态地添加或删除侦听器。

AdjustmentEvent 类定义了五种调整事件,如下所示:

  • 当用户拖动滚动条的滑动块时,发送 AdjustmentEvent.TRACK
  • 当用户单击水平滚动条的左箭头或垂直滚动条的上箭头,或从键盘做出等效动作时,发送 AdjustmentEvent.UNIT_INCREMENT
  • 当用户单击水平滚动条的右箭头或垂直滚动条的下箭头,或从键盘做出等效动作时,发送 AdjustmentEvent.UNIT_DECREMENT
  • 当用户单击水平滚动条滑动块左边的轨道,或垂直滚动条滑动块上边的轨道时,发送 AdjustmentEvent.BLOCK_INCREMENT。按照惯例,如果用户使用定义了 Page Up 键的键盘,则 Page Up 键是等效的。
  • 当用户单击水平滚动条滑动块右边的轨道,或垂直滚动条滑动块下边的轨道时,发送 AdjustmentEvent.BLOCK_DECREMENT。按照惯例,如果用户使用定义了 Page Down 键的键盘,则 Page Down 键是等效的。

为了向后兼容,也支持 JDK 1.0 事件系统,但是该平台的新版本不鼓励使用它。JDK 1.1 中介绍的五种调整事件,与以前该平台版本中的有关滚动条的五种事件对应。下面列表给出了调整事件类型和它对应的 JDK 1.0 中的替换事件类型。

  • AdjustmentEvent.TRACK 替换 Event.SCROLL_ABSOLUTE
  • AdjustmentEvent.UNIT_INCREMENT 替换 Event.SCROLL_LINE_UP
  • AdjustmentEvent.UNIT_DECREMENT 替换 Event.SCROLL_LINE_DOWN
  • AdjustmentEvent.BLOCK_INCREMENT 替换 Event.SCROLL_PAGE_UP
  • AdjustmentEvent.BLOCK_DECREMENT 替换 Event.SCROLL_PAGE_DOWN

:我们建议只对值的选择使用 Scrollbar。如果想在容器中实现一个可滚动的组件,那么建议您使用 ScrollPane。如果使用 Scrollbar 来实现这一目的,那么可能会遇到绘制、键处理、大小调整和分区问题。

从以下版本开始:
JDK1.0
另请参见:
AdjustmentEvent, AdjustmentListener, 序列化表格

嵌套类摘要
protected  class Scrollbar.AccessibleAWTScrollBar
          此类实现 Scrollbar 类的可访问性支持。
 
从类 java.awt.Component 继承的嵌套类/接口
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
字段摘要
static int HORIZONTAL
          指示一个水平滚动条的常量。
static int VERTICAL
          指示一个垂直滚动条的常量。
 
从类 java.awt.Component 继承的字段
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
从接口 java.awt.Adjustable 继承的字段
NO_ORIENTATION
 
从接口 java.awt.image.ImageObserver 继承的字段
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
构造方法摘要
Scrollbar()
          构造一个新的垂直滚动条。
Scrollbar(int orientation)
          构造一个具有指定方向的新滚动条。
Scrollbar(int orientation, int value, int visible, int minimum, int maximum)
          构造一个新的滚动条,它具有指定的方向、初始值、可视量、最小值和最大值。
 
方法摘要
 void addAdjustmentListener(AdjustmentListener l)
          添加指定的调整侦听器,以接收来自此滚动条的 AdjustmentEvent 实例。
 void addNotify()
          创建 Scrollbar 的同位体。
 AccessibleContext getAccessibleContext()
          获得与此 Scrollbar 相关的 AccessibleContext
 AdjustmentListener[] getAdjustmentListeners()
          返回在此滚动条上所有已注册调整侦听器的数组。
 int getBlockIncrement()
          获得此滚动条的块增量。
 int getLineIncrement()
          已过时。 从 JDK version 1.1 开始,由 getUnitIncrement() 取代。
<T extends EventListener>
T[]
getListeners(Class<T> listenerType)
          返回目前已在此 Scrollbar 上注册为 FooListener 的所有对象的数组。
 int getMaximum()
          获得此滚动条的最大值。
 int getMinimum()
          获得此滚动条的最小值。
 int getOrientation()
          返回此滚动条的方向。
 int getPageIncrement()
          已过时。 从 JDK version 1.1 开始,由 getBlockIncrement() 取代。
 int getUnitIncrement()
          获得此滚动条的单位增量。
 int getValue()
          获得此滚动条的当前值。
 boolean getValueIsAdjusting()
          如果该值作为用户执行操作的结果正处于改变过程中,则返回 true。
 int getVisible()
          已过时。 从 JDK version 1.1 开始,由 getVisibleAmount() 取代。
 int getVisibleAmount()
          获得此滚动条的可视量。
protected  String paramString()
          返回表示此 Scrollbar 的状态的字符串表示形式。
protected  void processAdjustmentEvent(AdjustmentEvent e)
          处理此滚动条上发生的调整事件,方法是将其指派到任意已注册的 AdjustmentListener 对象。
protected  void processEvent(AWTEvent e)
          处理在滚动条上发生的事件。
 void removeAdjustmentListener(AdjustmentListener l)
          移除指定的调整侦听器,不再接收来自此滚动条的 AdjustmentEvent 实例。
 void setBlockIncrement(int v)
          设置此滚动条的块增量。
 void setLineIncrement(int v)
          已过时。 从 JDK version 1.1 开始,由 setUnitIncrement(int) 取代。
 void setMaximum(int newMaximum)
          设置此滚动条的最大值。
 void setMinimum(int newMinimum)
          设置此滚动条的最小值。
 void setOrientation(int orientation)
          设置此滚动条的方向。
 void setPageIncrement(int v)
          已过时。 从 JDK version 1.1 开始,由 setBlockIncrement() 取代。
 void setUnitIncrement(int v)
          设置此滚动条的单位增量。
 void setValue(int newValue)
          将此滚动条的值设置为指定值。
 void setValueIsAdjusting(boolean b)
          设置 valueIsAdjusting 属性。
 void setValues(int value, int visible, int minimum, int maximum)
          设置此滚动条的四个属性值:valuevisibleAmountminimummaximum
 void setVisibleAmount(int newAmount)
          设置此滚动条的可视量。
 
从类 java.awt.Component 继承的方法
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

字段详细信息

HORIZONTAL

public static final int HORIZONTAL
指示一个水平滚动条的常量。

另请参见:
常量字段值

VERTICAL

public static final int VERTICAL
指示一个垂直滚动条的常量。

另请参见:
常量字段值
构造方法详细信息

Scrollbar

public Scrollbar()
          throws HeadlessException
构造一个新的垂直滚动条。滚动条的默认属性列在下表中:

属性 描述 默认值
方向 指示滚动条是垂直的
或水平的
Scrollbar.VERTICAL
控制滚动条的滑动块
位置的值
0
可视量 滚动条范围的可视量,
通常由滚动条的滑动块
的大小表示
10
最小值 滚动条的最小值 0
最大值 滚动条的最大值 100
unit increment 在按下 Line Up 或 Line Down 键时,
或者单击滚动条
的末端箭头时,
值更改的量
1
block increment 在按下 Page Up 或 Page Down 键时,
或在滑动块的两侧
单击滚动条轨道时,
值更改的量
10

抛出:
HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。
另请参见:
GraphicsEnvironment.isHeadless()

Scrollbar

public Scrollbar(int orientation)
          throws HeadlessException
构造一个具有指定方向的新滚动条。

orientation 参数必须是 Scrollbar.HORIZONTALScrollbar.VERTICAL 这两个值之一,分别指示滚动条是水平滚动条,还是垂直滚动条。

参数:
orientation - 指示滚动条的方向
抛出:
IllegalArgumentException - 在提供不合法的 orientation 参数值时
HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。
另请参见:
GraphicsEnvironment.isHeadless()

Scrollbar

public Scrollbar(int orientation,
                 int value,
                 int visible,
                 int minimum,
                 int maximum)
          throws HeadlessException
构造一个新的滚动条,它具有指定的方向、初始值、可视量、最小值和最大值。

orientation 参数必须是 Scrollbar.HORIZONTALScrollbar.VERTICAL 这两个值之一,分别指示滚动条是水平滚动条,还是垂直滚动条。

为此构造方法提供的参数受到 setValues(int, int, int, int) 中描述的约束 (Constraints) 的限制。

参数:
orientation - 指示滚动条的方向。
value - 滚动条的初始值
visible - 滚动条的可视量,通常由滑动块的大小表示
minimum - 滚动条的最小值
maximum - 滚动条的最大值
抛出:
IllegalArgumentException - 当提供不合法的 orientation 参数值时
HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。
另请参见:
setValues(int, int, int, int), GraphicsEnvironment.isHeadless()
方法详细信息

addNotify

public void addNotify()
创建 Scrollbar 的同位体。此同位体允许在不更改 Scrollbar 功能的情况下修改其外观。

覆盖:
Component 中的 addNotify
另请参见:
Component.isDisplayable(), Component.removeNotify()

getOrientation

public int getOrientation()
返回此滚动条的方向。

指定者:
接口 Adjustable 中的 getOrientation
返回:
此滚动条的方向,可以是 Scrollbar.HORIZONTALScrollbar.VERTICAL
另请参见:
setOrientation(int)

setOrientation

public void setOrientation(int orientation)
设置此滚动条的方向。

参数:
orientation - 此滚动条的方向,可以是 Scrollbar.HORIZONTALScrollbar.VERTICAL
抛出:
IllegalArgumentException - 如果为 orientation 提供的值是非法值
从以下版本开始:
JDK1.1
另请参见:
getOrientation()

getValue

public int getValue()
获得此滚动条的当前值。

指定者:
接口 Adjustable 中的 getValue
返回:
此滚动条的当前值
另请参见:
getMinimum(), getMaximum()

setValue

public void setValue(int newValue)
将此滚动条的值设置为指定值。

如果指定的值小于当前 minimum 或大于当前 maximum - visibleAmount,则对 minimummaximum - visibleAmount 进行适当的替换。

通常,程序应该只通过调用 setValues 更改滚动条的值。setValues 方法同时且同步地设置滚动条的最小值、最大值、可视量和值属性,因此它们是一致的。

调用此方法不会触发 AdjustmentEvent

指定者:
接口 Adjustable 中的 setValue
参数:
newValue - 滚动条的新值
另请参见:
setValues(int, int, int, int), getValue(), getMinimum(), getMaximum()

getMinimum

public int getMinimum()
获得此滚动条的最小值。

指定者:
接口 Adjustable 中的 getMinimum
返回:
此滚动条的最小值
另请参见:
getValue(), getMaximum()

setMinimum

public void setMinimum(int newMinimum)
设置此滚动条的最小值。

在调用 setMinimum 时,最小值会发生更改,并且其他值(包括最大值、可视量和滚动条的当前值)都会随新的最小值发生一致的更改。

通常,程序应该只通过调用 setValues 更改滚动条的最小值。setValues 方法同时且同步地设置滚动条的最小值、最大值、可视量和值属性,因此它们是相互一致的。

注意,设置 Integer.MAX_VALUE 的最小值会导致新的最小值被设置为 Integer.MAX_VALUE - 1

指定者:
接口 Adjustable 中的 setMinimum
参数:
newMinimum - 此滚动条的新的最小值
从以下版本开始:
JDK1.1
另请参见:
setValues(int, int, int, int), setMaximum(int)

getMaximum

public int getMaximum()
获得此滚动条的最大值。

指定者:
接口 Adjustable 中的 getMaximum
返回:
此滚动条的最大值
另请参见:
getValue(), getMinimum()

setMaximum

public void setMaximum(int newMaximum)
设置此滚动条的最大值。

在调用 setMaximum 时,最大值会发生更改,并且其他值(包括最小值、可视量和滚动条的当前值)都会随新的最大值发生一致的更改。

通常,程序应该只通过调用 setValues 更改滚动条的最大值。setValues 方法同时且同步地设置滚动条的最小值、最大值、可视量和值属性,因此它们是相互一致的。

注意,设置 Integer.MIN_VALUE 的最大值会导致新的最大值被设置为 Integer.MIN_VALUE + 1

指定者:
接口 Adjustable 中的 setMaximum
参数:
newMaximum - 此滚动条的新的最大值
从以下版本开始:
JDK1.1
另请参见:
setValues(int, int, int, int), setMinimum(int)

getVisibleAmount

public int getVisibleAmount()
获得此滚动条的可视量。

当使用滚动条来选择某一范围的值时,可以使用可视量来表示当前可视值的范围。滚动条的滑动块(也称为 thumb 或滚动框)的大小通常给出了滚动条范围与可视量之间关系的直观表示。

在滚动条的滑动块不可移动时(例如,当它充斥滚动条轨道的整个长度时,或者当禁用滚动条时),它可能不被显示。是否显示滑动块不会影响 getVisibleAmount 返回的值。

指定者:
接口 Adjustable 中的 getVisibleAmount
返回:
此滚动条的可视量
从以下版本开始:
JDK1.1
另请参见:
setVisibleAmount(int)

getVisible

@Deprecated
public int getVisible()
已过时。 从 JDK version 1.1 开始,由 getVisibleAmount() 取代。


setVisibleAmount

public void setVisibleAmount(int newAmount)
设置此滚动条的可视量。

当使用滚动条来选择某一范围的值时,可以使用可视量来表示当前可视值的范围。滚动条的滑动块(也称为 thumb 或滚动框)的大小通常给出了滚动条范围与可视量之间关系的直观表示。

在滚动条的滑动块不可移动时(例如,当它充斥滚动条轨道的整个长度时,或者当禁用滚动条时),它可能不被显示。是否显示滑动块不会影响 getVisibleAmount 返回的值。

如果提供的可视量小于 one 或大于当前 maximum - minimum,则对 onemaximum - minimum 进行适当的替换。

通常,程序应该只通过调用 setValues 更改滚动条的值。setValues 方法同时且同步地设置滚动条的最小值、最大值、可视量和值属性,因此它们是一致的。

指定者:
接口 Adjustable 中的 setVisibleAmount
参数:
newAmount - 新的可视量
从以下版本开始:
JDK1.1
另请参见:
getVisibleAmount(), setValues(int, int, int, int)

setUnitIncrement

public void setUnitIncrement(int v)
设置此滚动条的单位增量。

单位增量是用户激活滚动条的单位增量区域时增加或减少的值,通常通过鼠标或键盘来实现,该动作将滚动条作为一个调整事件来接收。单位增量必须大于零。试图将单位增量设置为小于 1 的值会导致该值被设置为 1。

指定者:
接口 Adjustable 中的 setUnitIncrement
参数:
v - 滚动条值增加或减少的量
从以下版本开始:
JDK1.1
另请参见:
getUnitIncrement()

setLineIncrement

@Deprecated
public void setLineIncrement(int v)
已过时。 从 JDK version 1.1 开始,由 setUnitIncrement(int) 取代。


getUnitIncrement

public int getUnitIncrement()
获得此滚动条的单位增量。

单位增量是用户激活滚动条的单位增量区域时增加或减少的值,通常通过鼠标或键盘来实现,该动作将滚动条作为一个调整事件来接收。单位增量必须大于零。

指定者:
接口 Adjustable 中的 getUnitIncrement
返回:
此滚动条的单位增量
从以下版本开始:
JDK1.1
另请参见:
setUnitIncrement(int)

getLineIncrement

@Deprecated
public int getLineIncrement()
已过时。 从 JDK version 1.1 开始,由 getUnitIncrement() 取代。


setBlockIncrement

public void setBlockIncrement(int v)
设置此滚动条的块增量。

块增量是用户激活滚动条的块增量区域时增加或减少的值,通常通过鼠标或键盘来实现,该动作将滚动条作为一个调整事件来接收。块增量必须大于零。试图将块增量设置为小于 1 的值会导致该值被设置为 1。

指定者:
接口 Adjustable 中的 setBlockIncrement
参数:
v - 滚动条值增加或减少的量
从以下版本开始:
JDK1.1
另请参见:
getBlockIncrement()

setPageIncrement

@Deprecated
public void setPageIncrement(int v)
已过时。 从 JDK version 1.1 开始,由 setBlockIncrement() 取代。


getBlockIncrement

public int getBlockIncrement()
获得此滚动条的块增量。

块增量是用户激活滚动条的块增量区域时增加或减少的值,通常通过鼠标或键盘来实现,该动作将滚动条作为一个调整事件来接收。块增量必须大于零。

指定者:
接口 Adjustable 中的 getBlockIncrement
返回:
此滚动条的块增量
从以下版本开始:
JDK1.1
另请参见:
setBlockIncrement(int)

getPageIncrement

@Deprecated
public int getPageIncrement()
已过时。 从 JDK version 1.1 开始,由 getBlockIncrement() 取代。


setValues

public void setValues(int value,
                      int visible,
                      int minimum,
                      int maximum)
设置此滚动条的四个属性值:valuevisibleAmountminimummaximum。如果为这些属性提供的值是不一致或不正确的,则将更改它们,确保它们一致。

此方法同时且同步地设置滚动条的四个属性值,以确保它们是相互一致的。它强制执行了以下约束:maximum 必须大于 minimummaximum - minimum 不能大于 Integer.MAX_VALUEvisibleAmount 必须大于零。visibleAmount 不能大于 maximum - minimumvalue 不能小于 minimum,并且 value 不能大于 maximum - visibleAmount

调用此方法不会触发 AdjustmentEvent

参数:
value - 当前窗口的位置
visible - 滚动条的可视量
minimum - 滚动条的最小值
maximum - 滚动条的最大值
另请参见:
setMinimum(int), setMaximum(int), setVisibleAmount(int), setValue(int)

getValueIsAdjusting

public boolean getValueIsAdjusting()
如果该值作为用户执行操作的结果正处于改变过程中,则返回 true。

返回:
valueIsAdjusting 属性的值
从以下版本开始:
1.4
另请参见:
setValueIsAdjusting(boolean)

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)
设置 valueIsAdjusting 属性。

参数:
b - 新的调整正处于进行状态
从以下版本开始:
1.4
另请参见:
getValueIsAdjusting()

addAdjustmentListener

public void addAdjustmentListener(AdjustmentListener l)
添加指定的调整侦听器,以接收来自此滚动条的 AdjustmentEvent 实例。如果 l 为 null,则不会抛出异常并且不执行任何操作。

指定者:
接口 Adjustable 中的 addAdjustmentListener
参数:
l - 调整侦听器
从以下版本开始:
JDK1.1
另请参见:
removeAdjustmentListener(java.awt.event.AdjustmentListener), getAdjustmentListeners(), AdjustmentEvent, AdjustmentListener

removeAdjustmentListener

public void removeAdjustmentListener(AdjustmentListener l)
移除指定的调整侦听器,不再接收来自此滚动条的 AdjustmentEvent 实例。如果 l 为 null,则不会抛出异常并且不执行任何操作。

指定者:
接口 Adjustable 中的 removeAdjustmentListener
参数:
l - 调整侦听器
从以下版本开始:
JDK1.1
另请参见:
addAdjustmentListener(java.awt.event.AdjustmentListener), getAdjustmentListeners(), AdjustmentEvent, AdjustmentListener

getAdjustmentListeners

public AdjustmentListener[] getAdjustmentListeners()
返回在此滚动条上所有已注册调整侦听器的数组。

返回:
此滚动条的所有 AdjustmentListener,如果当前没有已注册的调整侦听器,则返回一个空数组
从以下版本开始:
1.4
另请参见:
addAdjustmentListener(java.awt.event.AdjustmentListener), removeAdjustmentListener(java.awt.event.AdjustmentListener), AdjustmentEvent, AdjustmentListener

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)
返回目前已在此 Scrollbar 上注册为 FooListener 的所有对象的数组。FooListener 是用 addFooListener 方法注册的。

可以使用 class 字面值来指定 listenerType 参数,如 FooListener.class。例如,可以使用以下代码来查询 Scrollbar c 的鼠标侦听器:

MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));
如果不存在这样的侦听器,则此方法将返回一个空数组。

覆盖:
Component 中的 getListeners
参数:
listenerType - 所请求的侦听器类型;此参数应该指定一个从 java.util.EventListener 继承的接口
返回:
一个在此组件上作为 FooListener 注册的所有对象的数组,如果尚未添加这样的侦听器,则返回一个空数组
抛出:
ClassCastException - 如果 listenerType 未指定一个实现 java.util.EventListener 的类或接口
从以下版本开始:
1.3
另请参见:
Component.getComponentListeners(), Component.getFocusListeners(), Component.getHierarchyListeners(), Component.getHierarchyBoundsListeners(), Component.getKeyListeners(), Component.getMouseListeners(), Component.getMouseMotionListeners(), Component.getMouseWheelListeners(), Component.getInputMethodListeners(), Component.getPropertyChangeListeners()

processEvent

protected void processEvent(AWTEvent e)
处理在滚动条上发生的事件。如果事件是 AdjustmentEvent 的一个实例,则此方法将调用 processAdjustmentEvent 方法。否则,它将调用其超类的 processEvent 方法。

注意,如果事件参数为 null,则未指定行为并且可能导致异常。

覆盖:
Component 中的 processEvent
参数:
e - 事件
从以下版本开始:
JDK1.1
另请参见:
AdjustmentEvent, processAdjustmentEvent(java.awt.event.AdjustmentEvent)

processAdjustmentEvent

protected void processAdjustmentEvent(AdjustmentEvent e)
处理此滚动条上发生的调整事件,方法是将其指派到任意已注册的 AdjustmentListener 对象。

如果没有在组件上启用调整事件,则不调用此方法。出现以下情况之一时启用调整事件:

  • 通过 addAdjustmentListener 注册 AdjustmentListener 对象。
  • 通过 enableEvents 启用调整事件。

注意,如果事件参数为 null,则未指定行为并且可能导致异常。

参数:
e - 调整事件
从以下版本开始:
JDK1.1
另请参见:
AdjustmentEvent, AdjustmentListener, addAdjustmentListener(java.awt.event.AdjustmentListener), Component.enableEvents(long)

paramString

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

覆盖:
Component 中的 paramString
返回:
此滚动条的参数字符串

getAccessibleContext

public AccessibleContext getAccessibleContext()
获得与此 Scrollbar 相关的 AccessibleContext。对于滚动条,AccessibleContext 采用的是 AccessibleAWTScrollBar 的形式。如有必要,可以创建一个新的 AccessibleAWTScrollBar 实例。

指定者:
接口 Accessible 中的 getAccessibleContext
覆盖:
Component 中的 getAccessibleContext
返回:
充当此 ScrollBarAccessibleContextAccessibleAWTScrollBar

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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