QwtSlider (3) - Linux Manuals

NAME

QwtSlider -

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

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::Orientationorientation, 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, intpos) 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 (intwidth)

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

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::Orientationorientation)

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

Change the position of the scale.

Parameters:

scalePosition Position of the scale.

See Also:

ScalePosition, scalePosition()

void QwtSlider::setSpacing (intspacing)

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

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

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.