|
JavaTM 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
- 要添加的 AdjustmentLister
removeAdjustmentListener(java.awt.event.AdjustmentListener)
,
BoundedRangeModel.addChangeListener(javax.swing.event.ChangeListener)
public void removeAdjustmentListener(AdjustmentListener l)
Adjustable
中的
removeAdjustmentListener
l
- 要移除的 AdjustmentLister
addAdjustmentListener(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 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。