QwtSlider Class Reference

The Slider Widget. More...

#include <qwt_slider.h>

Inheritance diagram for QwtSlider:

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

---

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

List of all members.