QwtSlider - Man Page
The Slider Widget.
Synopsis
#include <qwt_slider.h>
Inherits QwtAbstractSlider.
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)
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
Additional Inherited Members
Detailed Description
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.
Member Enumeration Documentation
enum QwtSlider::ScalePosition
Position of the scale
- See also
QwtSlider(), setScalePosition(), setOrientation()
Enumerator
- NoScale
The slider has no scale.
- LeadingScale
The scale is right of a vertical or below a horizontal slider.
- TrailingScale
The scale is left of a vertical or above a horizontal slider.
Constructor & Destructor Documentation
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.
- Parameters
parent Parent widget
- See also
setOrientation(), setScalePosition(), setBackgroundStyle()
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.
- Parameters
parent Parent widget
orientation Orientation of the slider.
Member Function Documentation
int QwtSlider::borderWidth () const
- Returns
the border width.
- See also
setBorderWidth()
void QwtSlider::changeEvent (QEvent * event) [protected], [virtual]
Handles QEvent::StyleChange and QEvent::FontChange events
- Parameters
event Change event
void QwtSlider::drawHandle (QPainter * painter, const QRect & handleRect, int pos) const [protected], [virtual]
Draw the thumb at a position
- Parameters
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.
- Parameters
painter Painter
sliderRect Bounding rectangle of the slider
QRect QwtSlider::handleRect () const [protected]
- Returns
Bounding rectangle of the slider handle
QSize QwtSlider::handleSize () const
- Returns
Size of the handle.
- See also
setHandleSize()
bool QwtSlider::hasGroove () const
- Returns
True, when the groove is visisble
- See also
setGroove(), hasTrough()
bool QwtSlider::hasTrough () const
- Returns
True, when the trough is visisble
- See also
setTrough(), hasGroove()
bool QwtSlider::isScrollPosition (const QPoint & pos) const [protected], [virtual]
Determine what to do when the user presses a mouse button.
- Parameters
pos Mouse position
- Return values
True,when handleRect() contains pos
- See also
scrolledTo()
Implements QwtAbstractSlider.
QSize QwtSlider::minimumSizeHint () const [virtual]
- Returns
Minimum size hint
- See also
sizeHint()
void QwtSlider::mousePressEvent (QMouseEvent * event) [protected], [virtual]
Mouse press event handler
- Parameters
event Mouse event
Reimplemented from QwtAbstractSlider.
void QwtSlider::mouseReleaseEvent (QMouseEvent * event) [protected], [virtual]
Mouse release event handler
- Parameters
event Mouse event
Reimplemented from QwtAbstractSlider.
Qt::Orientation QwtSlider::orientation () const
- Returns
Orientation
- See also
setOrientation()
void QwtSlider::paintEvent (QPaintEvent * event) [protected], [virtual]
Qt paint event handler
- Parameters
event Paint event
void QwtSlider::resizeEvent (QResizeEvent * event) [protected], [virtual]
Qt resize event handler
- Parameters
event Resize event
const QwtScaleDraw * QwtSlider::scaleDraw () const
- Returns
the scale draw of the slider
- See also
setScaleDraw()
QwtSlider::ScalePosition QwtSlider::scalePosition () const
- Returns
Position of the scale
- See also
setScalePosition()
double QwtSlider::scrolledTo (const QPoint & pos) const [protected], [virtual]
Determine the value for a new position of the slider handle.
- Parameters
pos Mouse position
- Returns
Value for the mouse position
- See also
isScrollPosition()
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.
- Parameters
width Border width
- See also
borderWidth()
void QwtSlider::setGroove (bool on)
En/Disable the groove
The slider can be cutomized by showing a groove for the handle.
- Parameters
on When true, the groove is visible
- See also
hasGroove(), setThrough()
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().
- Parameters
size New size
- See also
handleSize()
void QwtSlider::setOrientation (Qt::Orientation orientation)
Set the orientation.
- Parameters
orientation Allowed values are Qt::Horizontal and Qt::Vertical.
- See also
orientation(), scalePosition()
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().
- Parameters
scaleDraw ScaleDraw object, that has to be created with new and will be deleted in ~QwtSlider() or the next call of setScaleDraw().
- See also
scaleDraw()
void QwtSlider::setScalePosition (ScalePosition scalePosition)
Change the position of the scale.
- Parameters
scalePosition Position of the scale.
- See also
ScalePosition, scalePosition()
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.
- Parameters
spacing Number of pixels
- See also
spacing();
void QwtSlider::setTrough (bool on)
En/Disable the trough
The slider can be cutomized by showing a trough for the handle.
- Parameters
on When true, the groove is visible
- See also
hasTrough(), setGroove()
void QwtSlider::setUpdateInterval (int interval)
Specify the update interval for automatic scrolling. The minimal accepted value is 50 ms.
- Parameters
interval Update interval in milliseconds
- See also
setUpdateInterval()
QSize QwtSlider::sizeHint () const [virtual]
- Returns
minimumSizeHint()
QRect QwtSlider::sliderRect () const [protected]
- Returns
Bounding rectangle of the slider - without the scale
int QwtSlider::spacing () const
- Returns
Number of pixels between slider and scale
- See also
setSpacing()
void QwtSlider::timerEvent (QTimerEvent * event) [protected], [virtual]
Timer event handler
Handles the timer, when the mouse stays pressed inside the sliderRect().
- Parameters
event Mouse event
int QwtSlider::updateInterval () const
- Returns
Update interval in milliseconds for automatic scrolling
- See also
setUpdateInterval()
Author
Generated automatically by Doxygen for Qwt User's Guide from the source code.