主页 | 所有的类 | 主要的类 | 注释的类 | 分组的类 | 函数 |
QScrollBar窗口部件提供了水平的或垂直的滚动条。 详情请见……
#include <qscrollbar.h>
继承了QWidget和QRangeControl。
QScrollBar窗口部件提供了水平的或垂直的滚动条。
滚动条允许用户控制一个程序可定义范围内的值并且给用户一个范围控制的当前值得可视化表示。
滚动条包含四个分别的控制:
QScrollBar只有几个自己的函数,它多数依赖于QRangeControl。最有用的函数是setValue()直接设置滚动条的值,addPage()、addLine()、subtractPage()和subtractLine()模拟点击的效果(对于快捷键很有用),setSteps()定义pageStep()和lineStep()的值,并且setRange()设置滚动条的minValue()和maxValue()。QScrollBar有一个方便的可以设置这些属性的构造函数。
一些图形用户界面风格(例如,提供的Windows和Motif风格)也使用pageStep()的值来计算滑块的大小。
除了来自QRangeControl的访问函数之外,QScrollBar还有完整的一套信号:
QScrollBar只提供整数范围。注意尽管QScrollBar可以处理很大的数字,当前屏幕上的滚动条不能有效地控制超过100000像素的范围。除此以外,它使用户使用键盘或者鼠标来控制这个滚动条都很困难。
滚动条可以被键盘控制,但是它的默认focusPolicy()是NoFocus。使用setFocusPolicy()来让键盘焦点生效。对于绑定键的列表,请参考keyPressEvent()。
如果你需要在一个界面上添加滚动条,请考虑使用QScrollView类,它封装了滚动条的常用方法。
也可以参考QSlider、QSpinBox、QScrollView、GUI Design Handbook: Scroll Bar和基本窗口部件。
parent和name参数被发送给QWidget的构造函数。
orientation必须是Qt::Vertical或Qt::Horizontal。
parent和name参数被发送给QWidget的构造函数。
如果orientation是Vertical,滚动条是垂直的并且如果它是Horizontal,则滚动条是水平的。
parent和name参数被发送给QWidget的构造函数。
如果用户已经在滑块上点击鼠标并且现在正在拖动它,返回真,否则返回假。详细情况请参考“draggingSlider”属性。
从QWidget中重新实现的。
返回当前线步。详细情况请参考“lineStep”属性。
返回滚动条的当前最大值。详细情况请参考“maxValue”属性。
返回滚动条的当前最小值。详细情况请参考“minValue”>属性。
返回滚动条的方向。详细情况请参考“orientation”属性。
返回当前页步。详细情况请参考“pageStep”属性。
设置当前线步。详细情况请参考“lineStep”属性。
设置滚动条的当前最大值。详细情况请参考“maxValue”属性。
设置滚动条的当前最小值。详细情况请参考“minValue”属性。
设置滚动条的方位。详细情况请参考“orientation”属性。
设置当前页步。详细情况请参考“pageStep”属性。
对于使用调色板p的Motif风格的滚动条,设置背景色为中间的颜色。
从QWidget中重新实现的。
设置滚动条跟踪是否生效为enable。详细情况请参考“tracking”属性。
设置当前滚动条的值。详细情况请参考“value”属性。
当滑块被用户移动时,这个信号被发射,新滚动条的值value作为参数。
即使当跟踪被关闭,这个信号也被发射。
也可以参考tracking、valueChanged()、nextLine()、prevLine()、nextPage()和prevPage()。
也可以参考sliderStart()。
这对于垂直滚动条相当于sliderRect().y(),对于水平滚动条相当于sliderRect().x()。
如果滚动条跟踪是生效的,返回真,否则返回假。详细情况请参考“tracking”属性。
返回当前滚动条的值。详细情况请参考“value”属性。
这个属性保存的是用户是否已经在滑块上点击鼠标并且正在移动它。
通过draggingSlider()来获得属性值。
这个属性保存的是当前线步。
当设置线步时,如果新的线步与原来的设置不同,虚函数stepChange()将被调用。
也可以参考setSteps()、QRangeControl::pageStep()和setRange()。
通过setLineStep()设置属性值并且通过lineStep()来获得属性值。
这个属性保存的是滚动条的当前最大值。
当设置这个属性时,如果需要,QScrollBar::minValue被调整,这样使范围仍有效。
也可以参考setRange()。
通过setMaxValue()设置属性值并且通过maxValue()来获得属性值。
这个属性保存的是滚动条的当前最小值。
当设置这个属性时,如果需要,QScrollBar::maxValue被调整,这样使范围仍有效。
也可以参考setRange()。
通过setMinValue()设置属性值并且通过minValue()来获得属性值。
这个属性保存的是滚动条的方位。
这个方位必须是Qt::Vertical(默认)或Qt::Horizontal。
通过setOrientation()设置属性值并且通过orientation()来获得属性值。
这个属性保存的是当前页步。
当设置页步时,如果新的页步与原来的设置不同,虚函数stepChange()将被调用。
也可以参考QRangeControl::setSteps()、lineStep和setRange()。
通过setPageStep()设置属性值并且通过pageStep()来获得属性值。
这个属性保存的是滚动条跟踪是否生效。
如果跟踪生效(默认),当滑块正在被拖动时,滚动条发射valueChanged()信号。如果失效,只有当用户在移动滑块之后释放鼠标按键时,滚动条发射valueChanged()信号。
通过setTracking()设置属性值并且通过tracking()来获得属性值。
这个属性保存的是滚动条的当前值。
通过setValue()设置属性值并且通过value()来获得属性值。
也可以参考QRangeControl::value()和prevValue()。
这个文件是Qt工具包一部分。 版权所有 © 1995-2002 Trolltech。保留所有权利。
Copyright © 2002 Trolltech | Trademarks | 译者:Cavendish | Qt 3.0.5版
|