The Slider Widget. More...

#include <qwt_slider.h>

Inheritance diagram for QwtSlider:

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
Qt::Orientation	orientation () const
	QwtSlider (QWidget *parent=NULL)
	QwtSlider (Qt::Orientation, QWidget *parent=NULL)
const QwtScaleDraw *	scaleDraw () const
ScalePosition	scalePosition () const
void	setBorderWidth (int bw)
	Change the slider's border width.
void	setGroove (bool)
void	setHandleSize (const QSize &)
	Set the slider's handle size.
void	setOrientation (Qt::Orientation)
	Set the orientation.
void	setScaleDraw (QwtScaleDraw *)
	Set a scale draw.
void	setScalePosition (ScalePosition)
	Change the position of the scale.
void	setSpacing (int)
	Change the spacing between trough and scale.
void	setTrough (bool)
void	setUpdateInterval (int)
	Specify the update interval for automatic scrolling.
virtual QSize	sizeHint () const
int	spacing () const
int	updateInterval () const
virtual	~QwtSlider ()
	Destructor.
Protected Member Functions
virtual void	changeEvent (QEvent *)
virtual void	drawHandle (QPainter *, const QRect &, int pos) const
virtual void	drawSlider (QPainter *, const QRect &) const
virtual bool	event (QEvent *)
QRect	handleRect () const
virtual bool	isScrollPosition (const QPoint &) const
	Determine what to do when the user presses a mouse button.
virtual void	mousePressEvent (QMouseEvent *)
virtual void	mouseReleaseEvent (QMouseEvent *)
virtual void	paintEvent (QPaintEvent *)
virtual void	resizeEvent (QResizeEvent *)
virtual void	scaleChange ()
	Notify changed scale.
virtual double	scrolledTo (const QPoint &) const
	Determine the value for a new position of the slider handle.
QRect	sliderRect () const
virtual void	timerEvent (QTimerEvent *)
Properties
int	borderWidth
bool	groove
QSize	handleSize
Qt::Orientation	orientation
ScalePosition	scalePosition
int	spacing
bool	trough
Private Member Functions
void	initSlider (Qt::Orientation)
void	layoutSlider (bool)
QwtScaleDraw *	scaleDraw ()
Private Attributes
PrivateData *	d_data

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

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::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 118 of file qwt_slider.cpp.

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 135 of file qwt_slider.cpp.

QwtSlider::~QwtSlider ( ) [virtual]

Destructor.

Definition at line 142 of file qwt_slider.cpp.

Member Function Documentation

int QwtSlider::borderWidth ( ) const

void QwtSlider::changeEvent ( QEvent * event ) [protected, virtual]

Handles QEvent::StyleChange and QEvent::FontChange events

Parameters:

event Change event

Reimplemented from QwtAbstractScale.

Definition at line 723 of file qwt_slider.cpp.

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

Definition at line 472 of file qwt_slider.cpp.

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

Definition at line 414 of file qwt_slider.cpp.

bool QwtSlider::event ( QEvent * event ) [protected, virtual]

Qt event handler

Parameters:

event Event

Returns:: true, if event was recognized and processed

Definition at line 711 of file qwt_slider.cpp.

QRect QwtSlider::handleRect ( ) const [protected]

Returns:: Bounding rectangle of the slider handle

Definition at line 990 of file qwt_slider.cpp.

QSize QwtSlider::handleSize ( ) const

bool QwtSlider::hasGroove ( ) const

Returns:: True, when the groove is visisble

See also:: setGroove(), hasTrough()

Definition at line 903 of file qwt_slider.cpp.

bool QwtSlider::hasTrough ( ) const

Returns:: True, when the trough is visisble

See also:: setTrough(), hasGroove()

Definition at line 874 of file qwt_slider.cpp.

void QwtSlider::initSlider ( Qt::Orientation orientation ) [private]

Definition at line 147 of file qwt_slider.cpp.

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.

Definition at line 502 of file qwt_slider.cpp.

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 742 of file qwt_slider.cpp.

QSize QwtSlider::minimumSizeHint ( ) const [virtual]

Returns:: Minimum size hint

See also:: sizeHint()

Definition at line 921 of file qwt_slider.cpp.

void QwtSlider::mousePressEvent ( QMouseEvent * event ) [protected, virtual]

Mouse press event handler

Parameters:

event Mouse event

Reimplemented from QwtAbstractSlider.

Definition at line 546 of file qwt_slider.cpp.

void QwtSlider::mouseReleaseEvent ( QMouseEvent * event ) [protected, virtual]

Mouse release event handler

Parameters:

event Mouse event

Reimplemented from QwtAbstractSlider.

Definition at line 605 of file qwt_slider.cpp.

Qt::Orientation QwtSlider::orientation ( ) const

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

Qt paint event handler

Parameters:

event Paint event

Definition at line 674 of file qwt_slider.cpp.

void QwtSlider::resizeEvent ( QResizeEvent * event ) [protected, virtual]

Qt resize event handler

Parameters:

event Resize event

Definition at line 699 of file qwt_slider.cpp.

void QwtSlider::scaleChange ( ) [protected, virtual]

Notify changed scale.

Reimplemented from QwtAbstractSlider.

Definition at line 377 of file qwt_slider.cpp.

const QwtScaleDraw * QwtSlider::scaleDraw ( ) const

Returns:: the scale draw of the slider

See also:: setScaleDraw()

Definition at line 362 of file qwt_slider.cpp.

QwtScaleDraw * QwtSlider::scaleDraw ( ) [private]

Returns:: the scale draw of the slider

See also:: setScaleDraw()

Definition at line 371 of file qwt_slider.cpp.

ScalePosition QwtSlider::scalePosition ( ) const

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.

Definition at line 525 of file qwt_slider.cpp.

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 243 of file qwt_slider.cpp.

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

Definition at line 888 of file qwt_slider.cpp.

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 310 of file qwt_slider.cpp.

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 174 of file qwt_slider.cpp.

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 343 of file qwt_slider.cpp.

void QwtSlider::setScalePosition ( ScalePosition scalePosition )

Change the position of the scale.

Parameters:

scalePosition Position of the scale.

See also:: ScalePosition, scalePosition()

Definition at line 212 of file qwt_slider.cpp.

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 277 of file qwt_slider.cpp.

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

Definition at line 859 of file qwt_slider.cpp.

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 394 of file qwt_slider.cpp.

QSize QwtSlider::sizeHint ( ) const [virtual]

Returns:: minimumSizeHint()

Definition at line 911 of file qwt_slider.cpp.

QRect QwtSlider::sliderRect ( ) const [protected]

Returns:: Bounding rectangle of the slider - without the scale

Definition at line 1014 of file qwt_slider.cpp.

int QwtSlider::spacing ( ) const

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

Definition at line 632 of file qwt_slider.cpp.

int QwtSlider::updateInterval ( ) const

Returns:: Update interval in milliseconds for automatic scrolling

See also:: setUpdateInterval()

Definition at line 403 of file qwt_slider.cpp.

Member Data Documentation

PrivateData* QwtSlider::d_data [private]

Reimplemented from QwtAbstractSlider.

Definition at line 128 of file qwt_slider.h.

Property Documentation

int QwtSlider::borderWidth [read, write]

Returns:: the border width.

See also:: setBorderWidth()

Definition at line 45 of file qwt_slider.h.

bool QwtSlider::groove [read, write]

Definition at line 42 of file qwt_slider.h.

QSize QwtSlider::handleSize [read, write]

Returns:: Size of the handle.

See also:: setHandleSize()

Definition at line 44 of file qwt_slider.h.

Qt::Orientation QwtSlider::orientation [read, write]

Returns:: Orientation

See also:: setOrientation()

Definition at line 37 of file qwt_slider.h.

QwtSlider::ScalePosition QwtSlider::scalePosition [read, write]

Returns:: Position of the scale

See also:: setScalePosition()

Definition at line 39 of file qwt_slider.h.

int QwtSlider::spacing [read, write]

Returns:: Number of pixels between slider and scale

See also:: setSpacing()

Definition at line 46 of file qwt_slider.h.

bool QwtSlider::trough [read, write]

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

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

Property Documentation