Scroll to navigation

QwtSlider(3) Qwt User's Guide QwtSlider(3)

NAME

QwtSlider -
The Slider Widget.
 

SYNOPSIS

#include <qwt_slider.h>
Inherits QwtAbstractSlider, and QwtAbstractScale.

Public Types


enum ScalePos { NoScale, LeftScale, RightScale, TopScale, BottomScale }
 
enum BackgroundStyle { Trough = 0x01, Groove = 0x02 }
 
typedef QFlags< BackgroundStyle > BackgroundStyles
 

Public Member Functions


QwtSlider (QWidget *parent, Qt::Orientation=Qt::Horizontal, ScalePos=NoScale, BackgroundStyles=Trough)
 
virtual void setOrientation (Qt::Orientation)
 
void setBackgroundStyle (BackgroundStyles)
 
BackgroundStyles backgroundStyle () const
 
void setScalePosition (ScalePos s)
 
ScalePos scalePosition () const
 
void setHandleSize (int width, int height)
 
void setHandleSize (const QSize &)
 
QSize handleSize () const
 
void setBorderWidth (int bw)
 
int borderWidth () const
 
void setSpacing (int)
 
int spacing () const
 
virtual QSize sizeHint () const
 
virtual QSize minimumSizeHint () const
 
void setScaleDraw (QwtScaleDraw *)
 
const QwtScaleDraw * scaleDraw () const
 

Protected Member Functions


virtual double getValue (const QPoint &p)
 
virtual void getScrollMode (const QPoint &p, QwtAbstractSlider::ScrollMode &, int &direction) const
 
virtual void drawSlider (QPainter *, const QRect &) const
 
virtual void drawHandle (QPainter *, const QRect &, int pos) const
 
virtual void resizeEvent (QResizeEvent *)
 
virtual void paintEvent (QPaintEvent *)
 
virtual void changeEvent (QEvent *)
 
virtual void valueChange ()
 
virtual void rangeChange ()
 
virtual void scaleChange ()
 
int transform (double v) const
 
QwtScaleDraw * scaleDraw ()
 

Detailed Description

The Slider Widget.
 
QwtSlider is a slider widget which operates on an interval of type double. QwtSlider supports different layouts as well as a scale.
See also:
QwtAbstractSlider and QwtAbstractScale for the descriptions of the inherited members.
 

Member Typedef Documentation

typedef QFlags<BackgroundStyle> QwtSlider::BackgroundStyles

Background styles.

Member Enumeration Documentation

enum QwtSlider::BackgroundStyle Background style.

See also:
QwtSlider()
 
Enumerator:
Trough
Trough background.
Groove
Groove.

enum QwtSlider::ScalePos Scale position. QwtSlider tries to enforce valid combinations of its orientation and scale position:

Qt::Horizonal combines with NoScale, TopScale and BottomScale
Qt::Vertical combines with NoScale, LeftScale and RightScale
See also:
QwtSlider()
 
Enumerator:
NoScale
The slider has no scale.
LeftScale
The scale is left of the slider.
RightScale
The scale is right of the slider.
TopScale
The scale is above of the slider.
BottomScale
The scale is below of the slider.

Constructor & Destructor Documentation

QwtSlider::QwtSlider (QWidget *parent, Qt::Orientationorientation = Qt::Horizontal, ScalePosscalePos = NoScale, BackgroundStylesbgStyle = Trough) [explicit]

Constructor. Parameters:
parent parent widget
 
orientation Orientation of the slider. Can be Qt::Horizontal or Qt::Vertical. Defaults to Qt::Horizontal.
 
scalePos Position of the scale. Defaults to QwtSlider::NoScale.
 
bgStyle Background style. QwtSlider::Trough draws the slider button in a trough, QwtSlider::Slot draws a slot underneath the button. An or-combination of both may also be used. The default is QwtSlider::Trough.
QwtSlider enforces valid combinations of its orientation and scale position. If the combination is invalid, the scale position will be set to NoScale. Valid combinations are:
Qt::Horizonal with NoScale, TopScale, or BottomScale;
Qt::Vertical with NoScale, LeftScale, or RightScale.
 

Member Function Documentation

QwtSlider::BackgroundStyles QwtSlider::backgroundStyle () const Returns:

the background style.
 

int QwtSlider::borderWidth () const Returns:

the border width.
See also:
setBorderWidth()
 

void QwtSlider::changeEvent (QEvent *event) [protected, virtual]

Qt change event handler.

void QwtSlider::drawHandle (QPainter *painter, const QRect &sliderRect, intpos) const [protected, virtual] Draw the thumb at a position

Parameters:
painter Painter
 
sliderRect Bounding rectangle of the slider
 
pos Position of the slider thumb
 

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
 

void QwtSlider::getScrollMode (const QPoint &p, QwtAbstractSlider::ScrollMode &scrollMode, int &direction) const [protected, virtual]

Determine scrolling mode and direction. Parameters:
p point
 
scrollMode Scrolling mode
 
direction Direction
 
Implements QwtAbstractSlider.

double QwtSlider::getValue (const QPoint &pos) [protected, virtual] Determine the value corresponding to a specified mouse location.

Parameters:
pos Mouse position
 
Implements QwtAbstractSlider.

QSize QwtSlider::handleSize () const Returns:

Size of the handle.
See also:
setHandleSize()
 

QSize QwtSlider::minimumSizeHint () const [virtual]

Return a minimum size hint. Warning:
The return value of QwtSlider::minimumSizeHint() depends on the font and the scale.
 

void QwtSlider::paintEvent (QPaintEvent *event) [protected, virtual] Qt paint event

Parameters:
event Paint event
 

void QwtSlider::rangeChange () [protected, virtual]

Notify change of range.
Reimplemented from QwtDoubleRange.

void QwtSlider::resizeEvent (QResizeEvent *) [protected, virtual]

Qt resize event.

void QwtSlider::scaleChange () [protected, virtual]

Notify changed scale.
Reimplemented from QwtAbstractScale.

const QwtScaleDraw * QwtSlider::scaleDraw () const Returns:

the scale draw of the slider
See also:
setScaleDraw()
 

QwtScaleDraw * QwtSlider::scaleDraw () [protected] Returns:

the scale draw of the slider
See also:
setScaleDraw()
 

QwtSlider::ScalePos QwtSlider::scalePosition () const

Return the scale position.

void QwtSlider::setBackgroundStyle (BackgroundStylesstyle) Set the background style.

void QwtSlider::setBorderWidth (intwidth)

Change the slider's border width. Parameters:
width Border width
 

void QwtSlider::setHandleSize (const QSize &size)

Set the slider's handle size. Parameters:
size New size
See also:
handleSize()
 

void QwtSlider::setHandleSize (intwidth, intheight)

Set the slider's handle size. Parameters:
width Width
 
height Height
See also:
handleSize()
 

void QwtSlider::setOrientation (Qt::Orientationo) [virtual]

Set the orientation. Parameters:
o Orientation. Allowed values are Qt::Horizontal and Qt::Vertical.
If the new orientation and the old scale position are an invalid combination, the scale position will be set to QwtSlider::NoScale.
See also:
QwtAbstractSlider::orientation()
 
Reimplemented from QwtAbstractSlider.

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 (ScalePosscalePos)

Change the scale position (and slider orientation). Parameters:
scalePos Position of the scale.
A valid combination of scale position and orientation is enforced:
if the new scale position is Left or Right, the scale orientation will become Qt::Vertical;
if the new scale position is Bottom or Top the scale orientation will become Qt::Horizontal;
if the new scale position is QwtSlider::NoScale, the scale orientation will not change.
 

void QwtSlider::setSpacing (intspacing)

Change the spacing between pipe and scale. A spacing of 0 means, that the backbone of the scale is below the trough.
The default setting is 4 pixels.
Parameters:
spacing Number of pixels
See also:
spacing();
 

QSize QwtSlider::sizeHint () const [virtual] Returns:

QwtSlider::minimumSizeHint()
 

int QwtSlider::spacing () const Returns:

Number of pixels between slider and scale
See also:
setSpacing()
 

int QwtSlider::transform (doublevalue) const [protected] Map and round a value into widget coordinates

Parameters:
value Value
 

void QwtSlider::valueChange () [protected, virtual]

Notify change of value.
Reimplemented from QwtAbstractSlider.
 

Author

Generated automatically by Doxygen for Qwt User's Guide from the source code.
Fri Apr 15 2011 Version 6.0.0