The Slider Widget. More...

#include <qwt_slider.h>

Inheritance diagram for QwtSlider:

[legend]

Classes
class	PrivateData

Public Types
enum	ScalePosition { NoScale, LeadingScale, TrailingScale }

Public Member Functions
int	borderWidth () const

QSize	handleSize () const

bool	hasGroove () const

bool	hasTrough () const

virtual QSize	minimumSizeHint () const QWT_OVERRIDE

Qt::Orientation	orientation () const

	QwtSlider (Qt::Orientation, QWidget *parent=NULL)

	QwtSlider (QWidget *parent=NULL)

const QwtScaleDraw *	scaleDraw () const

ScalePosition	scalePosition () const

void	setBorderWidth (int)
	Change the slider's border width. More...

void	setGroove (bool)

void	setHandleSize (const QSize &)
	Set the slider's handle size. More...

void	setOrientation (Qt::Orientation)
	Set the orientation. More...

void	setScaleDraw (QwtScaleDraw *)
	Set a scale draw. More...

void	setScalePosition (ScalePosition)
	Change the position of the scale. More...

void	setSpacing (int)
	Change the spacing between trough and scale. More...

void	setTrough (bool)

void	setUpdateInterval (int)
	Specify the update interval for automatic scrolling. More...

virtual QSize	sizeHint () const QWT_OVERRIDE

int	spacing () const

int	updateInterval () const

virtual	~QwtSlider ()
	Destructor. More...

Public Member Functions inherited from QwtAbstractSlider
bool	invertedControls () const

bool	isReadOnly () const

bool	isTracking () const

bool	isValid () const

uint	pageSteps () const

	QwtAbstractSlider (QWidget *parent=NULL)
	Constructor. More...

void	setInvertedControls (bool)

void	setPageSteps (uint)
	Set the number of steps for a page increment. More...

void	setReadOnly (bool)

void	setSingleSteps (uint)
	Set the number of steps for a single increment. More...

void	setStepAlignment (bool)
	Enable step alignment. More...

void	setTotalSteps (uint)
	Set the number of steps. More...

void	setTracking (bool)
	Enables or disables tracking. More...

void	setValid (bool)

void	setWrapping (bool)

uint	singleSteps () const

bool	stepAlignment () const

uint	totalSteps () const

double	value () const

bool	wrapping () const

virtual	~QwtAbstractSlider ()
	Destructor. More...

Public Member Functions inherited from QwtAbstractScale
double	invTransform (int) const

bool	isInverted () const

double	lowerBound () const

double	maximum () const

double	minimum () const

	QwtAbstractScale (QWidget *parent=NULL)

const QwtScaleDiv &	scaleDiv () const

QwtScaleEngine *	scaleEngine ()

const QwtScaleEngine *	scaleEngine () const

const QwtScaleMap &	scaleMap () const

int	scaleMaxMajor () const

int	scaleMaxMinor () const

double	scaleStepSize () const

void	setLowerBound (double value)

void	setScale (const QwtInterval &)
	Specify a scale. More...

void	setScale (const QwtScaleDiv &)
	Specify a scale. More...

void	setScale (double lowerBound, double upperBound)
	Specify a scale. More...

void	setScaleEngine (QwtScaleEngine *)
	Set a scale engine. More...

void	setScaleMaxMajor (int ticks)
	Set the maximum number of major tick intervals. More...

void	setScaleMaxMinor (int ticks)
	Set the maximum number of minor tick intervals. More...

void	setScaleStepSize (double stepSize)
	Set the step size used for calculating a scale division. More...

void	setUpperBound (double value)

int	transform (double) const

double	upperBound () const

virtual	~QwtAbstractScale ()
	Destructor. More...

Protected Member Functions
virtual void	changeEvent (QEvent *) QWT_OVERRIDE

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

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

virtual bool	event (QEvent *) QWT_OVERRIDE

QRect	handleRect () const

virtual bool	isScrollPosition (const QPoint &) const QWT_OVERRIDE
	Determine what to do when the user presses a mouse button. More...

virtual void	mousePressEvent (QMouseEvent *) QWT_OVERRIDE

virtual void	mouseReleaseEvent (QMouseEvent *) QWT_OVERRIDE

virtual void	paintEvent (QPaintEvent *) QWT_OVERRIDE

virtual void	resizeEvent (QResizeEvent *) QWT_OVERRIDE

virtual void	scaleChange () QWT_OVERRIDE
	Notify changed scale. More...

virtual double	scrolledTo (const QPoint &) const QWT_OVERRIDE
	Determine the value for a new position of the slider handle. More...

QRect	sliderRect () const

virtual void	timerEvent (QTimerEvent *) QWT_OVERRIDE

Protected Member Functions inherited from QwtAbstractSlider
double	incrementedValue (double value, int stepCount) const

void	incrementValue (int stepCount)

virtual void	keyPressEvent (QKeyEvent *) QWT_OVERRIDE

virtual void	mouseMoveEvent (QMouseEvent *) QWT_OVERRIDE

virtual void	sliderChange ()
	Calling update() More...

virtual void	wheelEvent (QWheelEvent *) QWT_OVERRIDE

Protected Member Functions inherited from QwtAbstractScale
QwtAbstractScaleDraw *	abstractScaleDraw ()

const QwtAbstractScaleDraw *	abstractScaleDraw () const

void	rescale (double lowerBound, double upperBound, double stepSize)

void	setAbstractScaleDraw (QwtAbstractScaleDraw *)
	Set a scale draw. More...

void	updateScaleDraw ()

Properties
int	borderWidth

bool	groove

QSize	handleSize

Qt::Orientation	orientation

ScalePosition	scalePosition

int	spacing

bool	trough

Properties inherited from QwtAbstractSlider
bool	invertedControls

uint	pageSteps

bool	readOnly

uint	singleSteps

bool	stepAlignment

uint	totalSteps

bool	tracking

double	value
	Returns the current value. More...

bool	wrapping

Properties inherited from QwtAbstractScale
double	lowerBound

int	scaleMaxMajor

int	scaleMaxMinor

double	scaleStepSize

double	upperBound

Private Member Functions
void	initSlider (Qt::Orientation)

void	layoutSlider (bool)

QwtScaleDraw *	scaleDraw ()

Private Attributes
PrivateData *	m_data

Additional Inherited Members
Public Slots inherited from QwtAbstractSlider
void	setValue (double value)

Signals inherited from QwtAbstractSlider
void	sliderMoved (double value)

void	sliderPressed ()

void	sliderReleased ()

void	valueChanged (double value)
	Notify a change of value. More...

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.

Definition at line 30 of file qwt_slider.h.

Member Enumeration Documentation

◆ ScalePosition

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.

Definition at line 54 of file qwt_slider.h.

Constructor & Destructor Documentation

◆ QwtSlider() [1/2]

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

Definition at line 119 of file qwt_slider.cpp.

◆ QwtSlider() [2/2]

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.

Definition at line 136 of file qwt_slider.cpp.

◆ ~QwtSlider()

QwtSlider::~QwtSlider ( )

virtual

Destructor.

Definition at line 143 of file qwt_slider.cpp.

Member Function Documentation

◆ borderWidth()

int QwtSlider::borderWidth ( ) const

◆ changeEvent()

void QwtSlider::changeEvent ( QEvent * event )

protectedvirtual

Handles QEvent::StyleChange and QEvent::FontChange events

Parameters

event Change event

Reimplemented from QwtAbstractScale.

Definition at line 724 of file qwt_slider.cpp.

◆ drawHandle()

void QwtSlider::drawHandle	(	QPainter *	painter,
		const QRect &	handleRect,
		int	pos
	)		const

protectedvirtual

Draw the thumb at a position

Parameters

painter	Painter
handleRect	Bounding rectangle of the handle
pos	Position of the handle marker in widget coordinates

Definition at line 473 of file qwt_slider.cpp.

◆ drawSlider()

void QwtSlider::drawSlider	(	QPainter *	painter,
		const QRect &	sliderRect
	)		const

protectedvirtual

Draw the slider into the specified rectangle.

Parameters

painter	Painter
sliderRect	Bounding rectangle of the slider

Definition at line 415 of file qwt_slider.cpp.

◆ event()

bool QwtSlider::event ( QEvent * event )

protectedvirtual

Qt event handler

Parameters

event Event

Returns: true, if event was recognized and processed

Definition at line 712 of file qwt_slider.cpp.

◆ handleRect()

QRect QwtSlider::handleRect ( ) const

protected

Returns: Bounding rectangle of the slider handle

Definition at line 990 of file qwt_slider.cpp.

◆ handleSize()

QSize QwtSlider::handleSize ( ) const

◆ hasGroove()

bool QwtSlider::hasGroove ( ) const

Returns: True, when the groove is visible

See also: setGroove(), hasTrough()

Definition at line 904 of file qwt_slider.cpp.

◆ hasTrough()

bool QwtSlider::hasTrough ( ) const

Returns: True, when the trough is visible

See also: setTrough(), hasGroove()

Definition at line 875 of file qwt_slider.cpp.

◆ initSlider()

void QwtSlider::initSlider ( Qt::Orientation orientation )

private

Definition at line 148 of file qwt_slider.cpp.

◆ isScrollPosition()

bool QwtSlider::isScrollPosition ( const QPoint & pos ) const

protectedvirtual

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.

Definition at line 503 of file qwt_slider.cpp.

◆ layoutSlider()

void QwtSlider::layoutSlider ( bool update_geometry )

private

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

Parameters

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

Definition at line 743 of file qwt_slider.cpp.

◆ minimumSizeHint()

QSize QwtSlider::minimumSizeHint ( ) const

virtual

Returns: Minimum size hint

See also: sizeHint()

Definition at line 922 of file qwt_slider.cpp.

◆ mousePressEvent()

void QwtSlider::mousePressEvent ( QMouseEvent * event )

protectedvirtual

Mouse press event handler

Parameters

event Mouse event

Reimplemented from QwtAbstractSlider.

Definition at line 547 of file qwt_slider.cpp.

◆ mouseReleaseEvent()

void QwtSlider::mouseReleaseEvent ( QMouseEvent * event )

protectedvirtual

Mouse release event handler

Parameters

event Mouse event

Reimplemented from QwtAbstractSlider.

Definition at line 606 of file qwt_slider.cpp.

◆ orientation()

Qt::Orientation QwtSlider::orientation ( ) const

◆ paintEvent()

void QwtSlider::paintEvent ( QPaintEvent * event )

protectedvirtual

Qt paint event handler

Parameters

event Paint event

Definition at line 675 of file qwt_slider.cpp.

◆ resizeEvent()

void QwtSlider::resizeEvent ( QResizeEvent * event )

protectedvirtual

Qt resize event handler

Parameters

event Resize event

Definition at line 700 of file qwt_slider.cpp.

◆ scaleChange()

void QwtSlider::scaleChange ( )

protectedvirtual

Notify changed scale.

Reimplemented from QwtAbstractSlider.

Definition at line 378 of file qwt_slider.cpp.

◆ scaleDraw() [1/2]

QwtScaleDraw* QwtSlider::scaleDraw ( )

private

◆ scaleDraw() [2/2]

QwtScaleDraw * QwtSlider::scaleDraw ( ) const

Returns: the scale draw of the slider

See also: setScaleDraw()

Definition at line 363 of file qwt_slider.cpp.

◆ scalePosition()

ScalePosition QwtSlider::scalePosition ( ) const

◆ scrolledTo()

double QwtSlider::scrolledTo ( const QPoint & pos ) const

protectedvirtual

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.

Definition at line 526 of file qwt_slider.cpp.

◆ setBorderWidth()

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

Definition at line 244 of file qwt_slider.cpp.

◆ setGroove()

void QwtSlider::setGroove ( bool on )

En/Disable the groove

The slider can be customized by showing a groove for the handle.

Parameters

on	When true, the groove is visible

See also: hasGroove(), setThrough()

Definition at line 889 of file qwt_slider.cpp.

◆ setHandleSize()

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

Definition at line 311 of file qwt_slider.cpp.

◆ setOrientation()

void QwtSlider::setOrientation ( Qt::Orientation orientation )

Set the orientation.

Parameters

orientation Allowed values are Qt::Horizontal and Qt::Vertical.

See also: orientation(), scalePosition()

Definition at line 175 of file qwt_slider.cpp.

◆ setScaleDraw()

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

Definition at line 344 of file qwt_slider.cpp.

◆ setScalePosition()

void QwtSlider::setScalePosition ( ScalePosition scalePosition )

Change the position of the scale.

Parameters

scalePosition Position of the scale.

See also: ScalePosition, scalePosition()

Definition at line 213 of file qwt_slider.cpp.

◆ setSpacing()

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

Definition at line 278 of file qwt_slider.cpp.

◆ setTrough()

void QwtSlider::setTrough ( bool on )

En/Disable the trough

The slider can be customized by showing a trough for the handle.

Parameters

on	When true, the groove is visible

See also: hasTrough(), setGroove()

Definition at line 860 of file qwt_slider.cpp.

◆ setUpdateInterval()

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

Definition at line 395 of file qwt_slider.cpp.

◆ sizeHint()

QSize QwtSlider::sizeHint ( ) const

virtual

Returns: minimumSizeHint()

Definition at line 912 of file qwt_slider.cpp.

◆ sliderRect()

QRect QwtSlider::sliderRect ( ) const

protected

Returns: Bounding rectangle of the slider - without the scale

Definition at line 1014 of file qwt_slider.cpp.

◆ spacing()

int QwtSlider::spacing ( ) const

◆ timerEvent()

void QwtSlider::timerEvent ( QTimerEvent * event )

protectedvirtual

Timer event handler

Handles the timer, when the mouse stays pressed inside the sliderRect().

Parameters

event Mouse event

Definition at line 633 of file qwt_slider.cpp.

◆ updateInterval()

int QwtSlider::updateInterval ( ) const

Returns: Update interval in milliseconds for automatic scrolling

See also: setUpdateInterval()

Definition at line 404 of file qwt_slider.cpp.

Member Data Documentation

◆ m_data

PrivateData* QwtSlider::m_data

private

Definition at line 128 of file qwt_slider.h.

Property Documentation

◆ borderWidth

int QwtSlider::borderWidth

readwrite

Returns: the border width.

See also: setBorderWidth()

Definition at line 45 of file qwt_slider.h.

◆ groove

bool QwtSlider::groove

readwrite

Definition at line 42 of file qwt_slider.h.

◆ handleSize

QSize QwtSlider::handleSize

readwrite

Returns: Size of the handle.

See also: setHandleSize()

Definition at line 44 of file qwt_slider.h.

◆ orientation

Qt::Orientation QwtSlider::orientation

readwrite

Returns: Orientation

See also: setOrientation()

Definition at line 37 of file qwt_slider.h.

◆ scalePosition

QwtSlider::ScalePosition QwtSlider::scalePosition

readwrite

Returns: Position of the scale

See also: setScalePosition()

Definition at line 39 of file qwt_slider.h.

◆ spacing

int QwtSlider::spacing

readwrite

Returns: Number of pixels between slider and scale

See also: setSpacing()

Definition at line 46 of file qwt_slider.h.

◆ trough

bool QwtSlider::trough

readwrite

Definition at line 41 of file qwt_slider.h.

The documentation for this class was generated from the following files:

Classes

Public Types

Public Member Functions

Protected Member Functions

Properties

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ ScalePosition

Constructor & Destructor Documentation

◆ QwtSlider() [1/2]

◆ QwtSlider() [2/2]

◆ ~QwtSlider()

Member Function Documentation

◆ borderWidth()

◆ changeEvent()

◆ drawHandle()

◆ drawSlider()

◆ event()

◆ handleRect()

◆ handleSize()

◆ hasGroove()

◆ hasTrough()

◆ initSlider()

◆ isScrollPosition()

◆ layoutSlider()

◆ minimumSizeHint()

◆ mousePressEvent()

◆ mouseReleaseEvent()

◆ orientation()

◆ paintEvent()

◆ resizeEvent()

◆ scaleChange()

◆ scaleDraw() [1/2]

◆ scaleDraw() [2/2]

◆ scalePosition()

◆ scrolledTo()

◆ setBorderWidth()

◆ setGroove()

◆ setHandleSize()

◆ setOrientation()

◆ setScaleDraw()

◆ setScalePosition()

◆ setSpacing()

◆ setTrough()

◆ setUpdateInterval()

◆ sizeHint()

◆ sliderRect()

◆ spacing()

◆ timerEvent()

◆ updateInterval()

Member Data Documentation

◆ m_data

Property Documentation

◆ borderWidth

◆ groove

◆ handleSize

◆ orientation

◆ scalePosition

◆ spacing

◆ trough