Qwt User's Guide 6.0.0
Public Types | Public Member Functions | Protected Member Functions

QwtSlider Class Reference

The Slider Widget. More...

#include <qwt_slider.h>

Inheritance diagram for QwtSlider:
Inheritance graph
[legend]

List of all members.

Public Types

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

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

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.

sliders.png
See also:
QwtAbstractSlider and QwtAbstractScale for the descriptions of the inherited members.

Member Typedef Documentation

Background styles.


Member Enumeration Documentation

Background style.

See also:
QwtSlider()
Enumerator:
Trough 

Trough background.

Groove 

Groove.

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::Orientation  orientation = Qt::Horizontal,
ScalePos  scalePos = NoScale,
BackgroundStyles  bgStyle = Trough 
) [explicit]

Constructor.

Parameters:
parentparent widget
orientationOrientation of the slider. Can be Qt::Horizontal or Qt::Vertical. Defaults to Qt::Horizontal.
scalePosPosition of the scale. Defaults to QwtSlider::NoScale.
bgStyleBackground 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,
int  pos 
) const [protected, virtual]

Draw the thumb at a position

Parameters:
painterPainter
sliderRectBounding rectangle of the slider
posPosition of the slider thumb
void QwtSlider::drawSlider ( QPainter *  painter,
const QRect &  sliderRect 
) const [protected, virtual]

Draw the slider into the specified rectangle.

Parameters:
painterPainter
sliderRectBounding rectangle of the slider
void QwtSlider::getScrollMode ( const QPoint &  p,
QwtAbstractSlider::ScrollMode scrollMode,
int &  direction 
) const [protected, virtual]

Determine scrolling mode and direction.

Parameters:
ppoint
scrollModeScrolling mode
directionDirection

Implements QwtAbstractSlider.

double QwtSlider::getValue ( const QPoint &  pos) [protected, virtual]

Determine the value corresponding to a specified mouse location.

Parameters:
posMouse 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:
eventPaint 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 ( BackgroundStyles  style)

Set the background style.

void QwtSlider::setBorderWidth ( int  width)

Change the slider's border width.

Parameters:
widthBorder width
void QwtSlider::setHandleSize ( const QSize &  size)

Set the slider's handle size.

Parameters:
sizeNew size
See also:
handleSize()
void QwtSlider::setHandleSize ( int  width,
int  height 
)

Set the slider's handle size.

Parameters:
widthWidth
heightHeight
See also:
handleSize()
void QwtSlider::setOrientation ( Qt::Orientation  o) [virtual]

Set the orientation.

Parameters:
oOrientation. 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:
scaleDrawScaleDraw 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 ( ScalePos  scalePos)

Change the scale position (and slider orientation).

Parameters:
scalePosPosition 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 ( int  spacing)

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:
spacingNumber of pixels
See also:
spacing();
QSize QwtSlider::sizeHint ( ) const [virtual]
int QwtSlider::spacing ( ) const
Returns:
Number of pixels between slider and scale
See also:
setSpacing()
int QwtSlider::transform ( double  value) const [protected]

Map and round a value into widget coordinates

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

Notify change of value.

Reimplemented from QwtAbstractSlider.