Qwt User's Guide
|
The Slider Widget. More...
#include <qwt_slider.h>
Public Types | |
enum | ScalePosition { NoScale, LeadingScale, TrailingScale } |
Public Member Functions | |
QwtSlider (QWidget *parent=NULL) | |
QwtSlider (Qt::Orientation, QWidget *parent=NULL) | |
virtual | ~QwtSlider () |
Destructor. | |
void | setOrientation (Qt::Orientation) |
Set the orientation. | |
Qt::Orientation | orientation () const |
void | setScalePosition (ScalePosition) |
Change the position of the scale. | |
ScalePosition | scalePosition () const |
void | setTrough (bool) |
bool | hasTrough () const |
void | setGroove (bool) |
bool | hasGroove () const |
void | setHandleSize (const QSize &) |
Set the slider's handle size. | |
QSize | handleSize () const |
void | setBorderWidth (int bw) |
Change the slider's border width. | |
int | borderWidth () const |
void | setSpacing (int) |
Change the spacing between trough and scale. | |
int | spacing () const |
virtual QSize | sizeHint () const |
virtual QSize | minimumSizeHint () const |
void | setScaleDraw (QwtScaleDraw *) |
Set a scale draw. | |
const QwtScaleDraw * | scaleDraw () const |
void | setUpdateInterval (int) |
Specify the update interval for automatic scrolling. | |
int | updateInterval () const |
Protected Member Functions | |
virtual double | scrolledTo (const QPoint &) const |
Determine the value for a new position of the slider handle. | |
virtual bool | isScrollPosition (const QPoint &) const |
Determine what to do when the user presses a mouse button. | |
virtual void | drawSlider (QPainter *, const QRect &) const |
virtual void | drawHandle (QPainter *, const QRect &, int pos) const |
virtual void | mousePressEvent (QMouseEvent *) |
virtual void | mouseReleaseEvent (QMouseEvent *) |
virtual void | resizeEvent (QResizeEvent *) |
virtual void | paintEvent (QPaintEvent *) |
virtual void | changeEvent (QEvent *) |
virtual void | timerEvent (QTimerEvent *) |
virtual void | scaleChange () |
Notify changed scale. | |
QRect | sliderRect () const |
QRect | handleRect () const |
The Slider Widget.
QwtSlider is a slider widget which operates on an interval of type double. Its position is related to a scale showing the current value.
The slider can be customized by having a through, a groove - or both.
Position of the scale
QwtSlider::QwtSlider | ( | QWidget * | parent = NULL | ) | [explicit] |
Construct vertical slider in QwtSlider::Trough style with a scale to the left.
The scale is initialized to [0.0, 100.0] and the value set to 0.0.
parent | Parent widget |
QwtSlider::QwtSlider | ( | Qt::Orientation | orientation, |
QWidget * | parent = NULL |
||
) | [explicit] |
Construct a slider in QwtSlider::Trough style
When orientation is Qt::Vertical the scale will be aligned to the left - otherwise at the the top of the slider.
The scale is initialized to [0.0, 100.0] and the value set to 0.0.
parent | Parent widget |
orientation | Orientation of the slider. |
int QwtSlider::borderWidth | ( | ) | const |
void QwtSlider::changeEvent | ( | QEvent * | event | ) | [protected, virtual] |
Handles QEvent::StyleChange and QEvent::FontChange events
event | Change event |
void QwtSlider::drawHandle | ( | QPainter * | painter, |
const QRect & | handleRect, | ||
int | pos | ||
) | const [protected, virtual] |
Draw the thumb at a position
painter | Painter |
handleRect | Bounding rectangle of the handle |
pos | Position of the handle marker in widget coordinates |
void QwtSlider::drawSlider | ( | QPainter * | painter, |
const QRect & | sliderRect | ||
) | const [protected, virtual] |
Draw the slider into the specified rectangle.
painter | Painter |
sliderRect | Bounding rectangle of the slider |
QRect QwtSlider::handleRect | ( | ) | const [protected] |
QSize QwtSlider::handleSize | ( | ) | const |
bool QwtSlider::hasGroove | ( | ) | const |
bool QwtSlider::hasTrough | ( | ) | const |
bool QwtSlider::isScrollPosition | ( | const QPoint & | pos | ) | const [protected, virtual] |
Determine what to do when the user presses a mouse button.
pos | Mouse position |
True,when | handleRect() contains pos |
Implements QwtAbstractSlider.
QSize QwtSlider::minimumSizeHint | ( | ) | const [virtual] |
void QwtSlider::mousePressEvent | ( | QMouseEvent * | event | ) | [protected, virtual] |
void QwtSlider::mouseReleaseEvent | ( | QMouseEvent * | event | ) | [protected, virtual] |
Qt::Orientation QwtSlider::orientation | ( | ) | const |
void QwtSlider::paintEvent | ( | QPaintEvent * | event | ) | [protected, virtual] |
Qt paint event handler
event | Paint event |
void QwtSlider::resizeEvent | ( | QResizeEvent * | event | ) | [protected, virtual] |
Qt resize event handler
event | Resize event |
const QwtScaleDraw * QwtSlider::scaleDraw | ( | ) | const |
double QwtSlider::scrolledTo | ( | const QPoint & | pos | ) | const [protected, virtual] |
Determine the value for a new position of the slider handle.
pos | Mouse position |
Implements QwtAbstractSlider.
void QwtSlider::setBorderWidth | ( | int | width | ) |
Change the slider's border width.
The border width is used for drawing the slider handle and the trough.
width | Border width |
void QwtSlider::setGroove | ( | bool | on | ) |
En/Disable the groove
The slider can be cutomized by showing a groove for the handle.
on | When true, the groove is visible |
void QwtSlider::setHandleSize | ( | const QSize & | size | ) |
Set the slider's handle size.
When the size is empty the slider handle will be painted with a default size depending on its orientation() and backgroundStyle().
size | New size |
void QwtSlider::setOrientation | ( | Qt::Orientation | orientation | ) |
Set the orientation.
orientation | Allowed values are Qt::Horizontal and Qt::Vertical. |
void QwtSlider::setScaleDraw | ( | QwtScaleDraw * | scaleDraw | ) |
Set a scale draw.
For changing the labels of the scales, it is necessary to derive from QwtScaleDraw and overload QwtScaleDraw::label().
scaleDraw | ScaleDraw object, that has to be created with new and will be deleted in ~QwtSlider() or the next call of setScaleDraw(). |
void QwtSlider::setScalePosition | ( | ScalePosition | scalePosition | ) |
Change the position of the scale.
scalePosition | Position of the scale. |
void QwtSlider::setSpacing | ( | int | spacing | ) |
Change the spacing between trough and scale.
A spacing of 0 means, that the backbone of the scale is covered by the trough.
The default setting is 4 pixels.
spacing | Number of pixels |
void QwtSlider::setTrough | ( | bool | on | ) |
En/Disable the trough
The slider can be cutomized by showing a trough for the handle.
on | When true, the groove is visible |
void QwtSlider::setUpdateInterval | ( | int | interval | ) |
Specify the update interval for automatic scrolling.
The minimal accepted value is 50 ms.
interval | Update interval in milliseconds |
QSize QwtSlider::sizeHint | ( | ) | const [virtual] |
QRect QwtSlider::sliderRect | ( | ) | const [protected] |
int QwtSlider::spacing | ( | ) | const |
void QwtSlider::timerEvent | ( | QTimerEvent * | event | ) | [protected, virtual] |
Timer event handler
Handles the timer, when the mouse stays pressed inside the sliderRect().
event | Mouse event |
int QwtSlider::updateInterval | ( | ) | const |