|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一個類別 下一個類別 | 框架 無框架 | |||||||||
摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 |
java.lang.Object java.awt.Component java.awt.Container javax.swing.JComponent javax.swing.JScrollBar
public class JScrollBar
滾動條的實作。使用者在滾動條內移動滑塊可確定顯示區域中的內容。該程序通常將顯示調整為滾動條的結束代表可顯示內容的結束,或內容的 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 |
欄位詳細資訊 |
---|
protected BoundedRangeModel model
setModel(javax.swing.BoundedRangeModel)
protected int orientation
setOrientation(int)
protected int unitIncrement
setUnitIncrement(int)
protected int blockIncrement
setBlockIncrement(int)
建構子詳細資訊 |
---|
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)
public JScrollBar(int orientation)
minimum = 0 maximum = 100 value = 0 extent = 10
public JScrollBar()
minimum = 0 maximum = 100 value = 0 extent = 10
方法詳細資訊 |
---|
public void setUI(ScrollBarUI ui)
ui
- ScrollBarUI
L&F 物件UIDefaults.getUI(javax.swing.JComponent)
public ScrollBarUI getUI()
JComponent.setUI(javax.swing.plaf.ComponentUI)
public void updateUI()
JComponent.updateUI
。
JComponent
中的 updateUI
JComponent.updateUI()
public String getUIClassID()
JComponent
中的 getUIClassID
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public int getOrientation()
Adjustable
中的 getOrientation
setOrientation(int)
,
Adjustable.getOrientation()
public void setOrientation(int orientation)
IllegalArgumentException
- 如果方向不屬於 VERTICAL、HORIZONTAL 中的任何一個getOrientation()
public BoundedRangeModel getModel()
setModel(javax.swing.BoundedRangeModel)
public void setModel(BoundedRangeModel newModel)
getModel()
public int getUnitIncrement(int direction)
JScrollPane 元件創建的滾動條(預設)會覆寫此方法,還會將它委託給視口的 Scrollable 視圖(如果有)。Scrollable 介面提供了此方法的一個更為特殊的版本。
direction
- 為 -1 或 1,分別對應向上/向下
setUnitIncrement(int)
,
setValue(int)
,
Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int)
public void setUnitIncrement(int unitIncrement)
注意,如果參數等於值 Integer.MIN_VALUE,大多數外觀顯示將不提供向右/向下滾動。
Adjustable
中的 setUnitIncrement
unitIncrement
- 單位增量getUnitIncrement(int)
public int getBlockIncrement(int direction)
JScrollPane 元件創建的滾動條(預設)會覆寫此方法,還會將它委託給視口的 Scrollable 視圖(如果有)。Scrollable 介面提供了此方法的一個更為特殊的版本。
direction
- 為 -1 或 1,分別對應向上/向下
setBlockIncrement(int)
,
setValue(int)
,
Scrollable.getScrollableBlockIncrement(java.awt.Rectangle, int, int)
public void setBlockIncrement(int blockIncrement)
注意,如果參數等於值 Integer.MIN_VALUE,大多數外觀顯示將不提供向右/向下滾動。
Adjustable
中的 setBlockIncrement
blockIncrement
- 塊值增量getBlockIncrement()
public int getUnitIncrement()
Adjustable
中的 getUnitIncrement
Adjustable.getUnitIncrement()
,
getUnitIncrement(int)
public int getBlockIncrement()
Adjustable
中的 getBlockIncrement
Adjustable.getBlockIncrement()
,
getBlockIncrement(int)
public int getValue()
Adjustable
中的 getValue
setValue(int)
public void setValue(int value)
Adjustable
中的 setValue
value
- 當前值,它位於 minimum
和 maximum
- visibleAmount
之間getValue()
,
BoundedRangeModel.setValue(int)
public int getVisibleAmount()
Adjustable
中的 getVisibleAmount
setVisibleAmount(int)
public void setVisibleAmount(int extent)
Adjustable
中的 setVisibleAmount
extent
- 指示器的長度getVisibleAmount()
,
BoundedRangeModel.setExtent(int)
public int getMinimum()
Adjustable
中的 getMinimum
setMinimum(int)
public void setMinimum(int minimum)
Adjustable
中的 setMinimum
minimum
- 最小值getMinimum()
,
BoundedRangeModel.setMinimum(int)
public int getMaximum()
Adjustable
中的 getMaximum
setMaximum(int)
public void setMaximum(int maximum)
Adjustable
中的 setMaximum
maximum
- 最大值getMaximum()
,
BoundedRangeModel.setMaximum(int)
public boolean getValueIsAdjusting()
setValueIsAdjusting(boolean)
public void setValueIsAdjusting(boolean b)
getValueIsAdjusting()
,
BoundedRangeModel.setValueIsAdjusting(boolean)
public void setValues(int newValue, int newExtent, int newMin, int newMax)
minimum <= value <= value+extent <= maximum
BoundedRangeModel.setRangeProperties(int, int, int, int, boolean)
,
setValue(int)
,
setVisibleAmount(int)
,
setMinimum(int)
,
setMaximum(int)
public void addAdjustmentListener(AdjustmentListener l)
注意,AdjustmentEvent 型別屬性將一直有一個佔位值 AdjustmentEvent.TRACK,因為對 BoundedRangeModels 值的所有更改都被認為是等價的。要更改 BoundedRangeModel 的值,只需要設置它的 value 屬性,即 model.setValue(123)。未提供任何關於更改起源的資訊,如它是一個塊減小的更改之類別。這裡對更改的起源將不贅述。
Adjustable
中的 addAdjustmentListener
l
- 要添加的 AdjustmentListerremoveAdjustmentListener(java.awt.event.AdjustmentListener)
,
BoundedRangeModel.addChangeListener(javax.swing.event.ChangeListener)
public void removeAdjustmentListener(AdjustmentListener l)
Adjustable
中的 removeAdjustmentListener
l
- 要移除的 AdjustmentListeraddAdjustmentListener(java.awt.event.AdjustmentListener)
public AdjustmentListener[] getAdjustmentListeners()
AdjustmentListener
組成的陣列。
AdjustmentListener
;如果未添加任何偵聽器,則返回一個空陣列protected void fireAdjustmentValueChanged(int id, int type, int value)
addAdjustmentListener(java.awt.event.AdjustmentListener)
,
EventListenerList
public Dimension getMinimumSize()
JComponent
中的 getMinimumSize
minimumSize
屬性的值JComponent.setMinimumSize(java.awt.Dimension)
,
ComponentUI
public Dimension getMaximumSize()
JComponent
中的 getMaximumSize
maximumSize
屬性的值JComponent.setMaximumSize(java.awt.Dimension)
,
ComponentUI
public void setEnabled(boolean x)
JComponent
中的 setEnabled
x
- boolean 值,它為 true 時,啟用該元件,它為 false 時,禁用該元件Component.isEnabled()
,
Component.isLightweight()
protected String paramString()
null
。
JComponent
中的 paramString
public AccessibleContext getAccessibleContext()
Accessible
中的 getAccessibleContext
JComponent
中的 getAccessibleContext
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一個類別 下一個類別 | 框架 無框架 | |||||||||
摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 |
版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。