SYNOPSIS

#include <qwt_slider.h>

Inherits QwtAbstractSlider, and QwtAbstractScale.

Public Types

enum BGSTYLE { BgTrough = 0x1, BgSlot = 0x2, BgBoth = BgTrough | BgSlot }

enum ScalePos { NoScale, LeftScale, RightScale, TopScale, BottomScale }

Public Member Functions

QwtSlider (QWidget *parent, Qt::Orientation=Qt::Horizontal, ScalePos=NoScale, BGSTYLE bgStyle=BgTrough)

BGSTYLE bgStyle () const

int borderWidth () const

virtual QSize minimumSizeHint () const

const QwtScaleDraw * scaleDraw () const

ScalePos scalePosition () const

void setBgStyle (BGSTYLE)

void setBorderWidth (int bw)

void setMargins (int x, int y)

virtual void setOrientation (Qt::Orientation)

void setScaleDraw (QwtScaleDraw *)

void setScalePosition (ScalePos s)

void setThumbLength (int l)

void setThumbWidth (int w)

virtual QSize sizeHint () const

int thumbLength () const

int thumbWidth () const

Protected Member Functions

void draw (QPainter *p, const QRect &update_rect)

virtual void drawSlider (QPainter *p, const QRect &r)

virtual void drawThumb (QPainter *p, const QRect &, int pos)

virtual void fontChange (const QFont &oldFont)

virtual void getScrollMode (const QPoint &p, int &scrollMode, int &direction)

virtual double getValue (const QPoint &p)

void layoutSlider (bool update=true)

virtual void paintEvent (QPaintEvent *e)

virtual void rangeChange ()

virtual void resizeEvent (QResizeEvent *e)

virtual void scaleChange ()

QwtScaleDraw * scaleDraw ()

virtual void valueChange ()

int xyPosition (double v) const

Additional Inherited Members

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 Enumeration Documentation

enum \fBQwtSlider::BGSTYLE\fP

Background style.

See also:

QwtSlider()

enum \fBQwtSlider::ScalePos\fP

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

Constructor & Destructor Documentation

QwtSlider::QwtSlider (QWidget *parent, Qt::Orientationorientation = \fCQt::Horizontal\fP, \fBScalePos\fPscalePos = \fCNoScale\fP, \fBBGSTYLE\fPbgStyle = \fCBgTrough\fP)\fC [explicit]\fP

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::BgTrough draws the slider button in a trough, QwtSlider::BgSlot draws a slot underneath the button. An or-combination of both may also be used. The default is QwtSlider::BgTrough.

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

\fBQwtSlider::BGSTYLE\fP QwtSlider::bgStyle () const

Returns:

the background style.

int QwtSlider::borderWidth () const

Returns:

the border width.

void QwtSlider::drawSlider (QPainter *painter, const QRect &r)\fC [protected]\fP, \fC [virtual]\fP

Draw the slider into the specified rectangle.

Parameters:

painter Painter

r Rectangle

void QwtSlider::drawThumb (QPainter *painter, const QRect &sliderRect, intpos)\fC [protected]\fP, \fC [virtual]\fP

Draw the thumb at a position

Parameters:

painter Painter

sliderRect Bounding rectangle of the slider

pos Position of the slider thumb

void QwtSlider::getScrollMode (const QPoint &p, int &scrollMode, int &direction)\fC [protected]\fP, \fC [virtual]\fP

Determine scrolling mode and direction. Parameters:

p point

scrollMode Scrolling mode

direction Direction

Implements QwtAbstractSlider.

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

Determine the value corresponding to a specified mouse location.

Parameters:

pos Mouse position

Implements QwtAbstractSlider.

void QwtSlider::layoutSlider (boolupdate_geometry = \fCtrue\fP)\fC [protected]\fP

Recalculate the slider's geometry and layout based on the current rect and fonts.

Parameters:

update_geometry notify the layout system and call update to redraw the scale

QSize QwtSlider::minimumSizeHint () const\fC [virtual]\fP

Return a minimum size hint. Warning:

The return value of QwtSlider::minimumSizeHint() depends on the font and the scale.

void QwtSlider::paintEvent (QPaintEvent *event)\fC [protected]\fP, \fC [virtual]\fP

Qt paint event

Parameters:

event Paint event

const \fBQwtScaleDraw\fP * QwtSlider::scaleDraw () const

Returns:

the scale draw of the slider

See also:

setScaleDraw()

\fBQwtScaleDraw\fP * QwtSlider::scaleDraw ()\fC [protected]\fP

Returns:

the scale draw of the slider

See also:

setScaleDraw()

void QwtSlider::setBgStyle (\fBBGSTYLE\fPst)

Set the background style.

void QwtSlider::setBorderWidth (intbd)

Change the slider's border width. Parameters:

bd border width

void QwtSlider::setMargins (intxMargin, intyMargin)

Set distances between the widget's border and internals. Parameters:

xMargin Horizontal margin

yMargin Vertical margin

void QwtSlider::setOrientation (Qt::Orientationo)\fC [virtual]\fP

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 (\fBQwtScaleDraw\fP *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().

void QwtSlider::setScalePosition (\fBScalePos\fPs)

Change the scale position (and slider orientation). Parameters:

s 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::setThumbLength (intthumbLength)

Set the slider's thumb length. Parameters:

thumbLength new length

void QwtSlider::setThumbWidth (intw)

Change the width of the thumb. Parameters:

w new width

QSize QwtSlider::sizeHint () const\fC [virtual]\fP

Returns:

QwtSlider::minimumSizeHint()

int QwtSlider::thumbLength () const

Returns:

the thumb length.

int QwtSlider::thumbWidth () const

Returns:

the thumb width.

int QwtSlider::xyPosition (doublevalue) const\fC [protected]\fP

Find the x/y position for a given value v

Parameters:

value Value

Author

Generated automatically by Doxygen for Qwt User's Guide from the source code.