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" 或「滾動框」）的寬度來表示可視的文本數。下面是表示某一範圍的滾動條：

在這個例子中，滑動塊表示的值範圍是可見量。此例中的水平滾動條可以用以下程式碼來創建：

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

注意，滾動條的實際最大值是 maximum 減去 visible amount。在前面的例子中，因為 maximum 是 300，visible amount 是 60，所以實際最大值是 240。滾動條軌道的範圍是 0 - 300。滑動塊的左側指示了滾動條的值。

通常，使用者通過使用鼠標來改變滾動條的值。例如，使用者可以上下拖動滾動條的滑動塊，或單擊滾動條的單位增量或塊增量區域。鍵盤動作也能映射到滾動條。按照慣例，Page Up 和 Page Down 鍵等同於單擊滾動條的塊增量和塊減量區域。

當使用者改變滾動條的值時，滾動條接收一個 AdjustmentEvent 實例。滾動條處理此事件，將它傳遞給所有已註冊的偵聽器。

任何希望滾動條值發生變化時被通知的物件都應該實作包 java.awt.event 中定義的 AdjustmentListener 介面。調用 addAdjustmentListener 和 removeAdjustmentListener 方法能動態地添加或刪除偵聽器。

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.BaselineResizeBehavior, 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) 設置此滾動條的四個屬性值：value、visibleAmount、minimum 和 maximum。
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, getBaseline, getBaselineResizeBehavior, 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
單元增量	在按下 Line Up 或 Line Down 鍵時， 或者單擊滾動條 的末端箭頭時， 值更改的量	1
塊增量	在按下 Page Up 或 Page Down 鍵時， 或在滑動塊的兩側 單擊滾動條軌道時， 值更改的量	10

拋出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true。

另請參見：

GraphicsEnvironment.isHeadless()

Scrollbar

public Scrollbar(int orientation)
          throws HeadlessException

建構一個具有指定方向的新滾動條。

orientation 參數必須是 Scrollbar.HORIZONTAL 或 Scrollbar.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.HORIZONTAL 或 Scrollbar.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.HORIZONTAL 或 Scrollbar.VERTICAL

另請參見：

setOrientation(int)

setOrientation

public void setOrientation(int orientation)

設置此滾動條的方向。

參數：

orientation - 此滾動條的方向，可以是 Scrollbar.HORIZONTAL 或 Scrollbar.VERTICAL

拋出：

IllegalArgumentException - 如果為 orientation 提供的值是非法值

從以下版本開始：

JDK1.1

另請參見：

getOrientation()

getValue

public int getValue()

獲取此滾動條的當前值。

指定者：

介面 Adjustable 中的 getValue

返回：

此滾動條的當前值

另請參見：

getMinimum(), getMaximum()

setValue

public void setValue(int newValue)

將此滾動條的值設置為指定值。

如果指定的值小於當前 minimum 或大於當前 maximum - visibleAmount，則對 minimum 或 maximum - 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，則對 one 或 maximum - 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)

設置此滾動條的四個屬性值：value、visibleAmount、minimum 和 maximum。如果為這些屬性提供的值是不一致或不正確的，則將更改它們，確保它們一致。

此方法同時且同步地設置滾動條的四個屬性值，以確保它們相互一致。它強制執行了以下約束：maximum 必須大於 minimum，maximum - minimum 不能大於 Integer.MAX_VALUE，visibleAmount 必須大於零。visibleAmount 不能大於 maximum - minimum，value 不能小於 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 - 新的調整正處於進行 (adjustment-in-progress) 狀態

從以下版本開始：

1.4

另請參見：

getValueIsAdjusting()

addAdjustmentListener

public void addAdjustmentListener(AdjustmentListener l)

添加指定的調整偵聽器，以接收發自此滾動條的 AdjustmentEvent 實例。如果 l 為 null，則不會拋出異常並且不執行任何動作。

有關 AWT 的執行緒模型的詳細資訊，請參閱 AWT 執行緒問題。

指定者：

介面 Adjustable 中的 addAdjustmentListener

參數：

l - 調整偵聽器

從以下版本開始：

JDK1.1

另請參見：

removeAdjustmentListener(java.awt.event.AdjustmentListener), getAdjustmentListeners(), AdjustmentEvent, AdjustmentListener

removeAdjustmentListener

public void removeAdjustmentListener(AdjustmentListener l)

移除指定的調整偵聽器，不再接收發自此滾動條的 AdjustmentEvent 實例。如果 l 為 null，則不會拋出異常並且不執行任何動作。

有關 AWT 的執行緒模型的詳細資訊，請參閱 AWT 執行緒問題。

指定者：

介面 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(), #getPropertyChangeListener

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

返回：

充當此 ScrollBar 的 AccessibleContext 的 AccessibleAWTScrollBar

從以下版本開始：

1.3