|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 | |||||||||
java.lang.Objectjava.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JScrollBar
public class JScrollBar
滚动条的实现。用户在滚动条内移动滑块可确定显示区域中的内容。该程序通常将显示调整为滚动条的结束代表可显示内容的结束,或内容的 100%。滚动条的开始为可显示内容的开始,或 0%。然后滑块在其边界中的位置转换为可显示内容对应的百分比。
通常,随着滑块的位置在滚动条中的变化,将在基础视图上对 JViewport 的位置进行相应的更改,这样 JViewport 的内容也随之改变。
警告:此类的序列化对象将与以后的 Swing 版本不兼容。当前的序列化支持适用于短期存储或运行相同 Swing 版本的应用程序之间的 RMI。从 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.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()
创建具有下列初始值的垂直滚动条: minimum = 0 maximum = 100 value = 0 extent = 10 |
|
JScrollBar(int orientation)
创建具有指定方向和下列初始值的滚动条: minimum = 0 maximum = 100 value = 0 extent = 10 |
|
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()
返回滚动条支持的最小值(通常为零)。 |
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 属性: minimum <= value <= value+extent <= maximum |
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 中的 updateUIJComponent.updateUI()public String getUIClassID()
JComponent 中的 getUIClassIDJComponent.getUIClassID(),
UIDefaults.getUI(javax.swing.JComponent)public int getOrientation()
Adjustable 中的 getOrientationsetOrientation(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 中的 setUnitIncrementunitIncrement - 单位增量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 中的 setBlockIncrementblockIncrement - 块值增量getBlockIncrement()public int getUnitIncrement()
Adjustable 中的 getUnitIncrementAdjustable.getUnitIncrement(),
getUnitIncrement(int)public int getBlockIncrement()
Adjustable 中的 getBlockIncrementAdjustable.getBlockIncrement(),
getBlockIncrement(int)public int getValue()
Adjustable 中的 getValuesetValue(int)public void setValue(int value)
Adjustable 中的 setValuevalue - 当前值,它位于 minimum 和 maximum - visibleAmount 之间getValue(),
BoundedRangeModel.setValue(int)public int getVisibleAmount()
Adjustable 中的 getVisibleAmountsetVisibleAmount(int)public void setVisibleAmount(int extent)
Adjustable 中的 setVisibleAmountextent - 指示器的长度getVisibleAmount(),
BoundedRangeModel.setExtent(int)public int getMinimum()
Adjustable 中的 getMinimumsetMinimum(int)public void setMinimum(int minimum)
Adjustable 中的 setMinimumminimum - 最小值getMinimum(),
BoundedRangeModel.setMinimum(int)public int getMaximum()
Adjustable 中的 getMaximumsetMaximum(int)public void setMaximum(int maximum)
Adjustable 中的 setMaximummaximum - 最大值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 中的 addAdjustmentListenerl - 要添加的 AdjustmentListerremoveAdjustmentListener(java.awt.event.AdjustmentListener),
BoundedRangeModel.addChangeListener(javax.swing.event.ChangeListener)public void removeAdjustmentListener(AdjustmentListener l)
Adjustable 中的 removeAdjustmentListenerl - 要移除的 AdjustmentListeraddAdjustmentListener(java.awt.event.AdjustmentListener)public AdjustmentListener[] getAdjustmentListeners()
AdjustmentListener 组成的数组。
AdjustmentListener,如果未添加任何侦听器,则返回一个空数组
protected void fireAdjustmentValueChanged(int id,
int type,
int value)
public Dimension getMinimumSize()
JComponent 中的 getMinimumSizeminimumSize 属性的值JComponent.setMinimumSize(java.awt.Dimension),
ComponentUIpublic Dimension getMaximumSize()
JComponent 中的 getMaximumSizemaximumSize 属性的值JComponent.setMaximumSize(java.awt.Dimension),
ComponentUIpublic void setEnabled(boolean x)
JComponent 中的 setEnabledx - 一个 boolean 值,它为 true 时,启用该组件,它为 false 时,禁用该组件Component.isEnabled(),
Component.isLightweight()protected String paramString()
null。
JComponent 中的 paramStringpublic AccessibleContext getAccessibleContext()
Accessible 中的 getAccessibleContextJComponent 中的 getAccessibleContext
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 | |||||||||
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。