itom  4.1.0
DoubleSlider Class Reference

#include <doubleSlider.h>

Inheritance diagram for DoubleSlider:

Public Types

typedef QWidget Superclass
 Superclass typedef.
 

Public Slots

void setValue (double value)
 
void setOrientation (Qt::Orientation orientation)
 

Signals

void valueChanged (double value)
 
void sliderMoved (double position)
 
void sliderPressed ()
 
void sliderReleased ()
 
void rangeChanged (double min, double max)
 

Public Member Functions

 DoubleSlider (QWidget *parent=0)
 
 DoubleSlider (Qt::Orientation orient, QWidget *parent=0)
 
virtual ~DoubleSlider ()
 Destructor.
 
void setMinimum (double min)
 
double minimum () const
 
void setMaximum (double max)
 
double maximum () const
 
void setRange (double min, double max)
 
double value () const
 
void setSingleStep (double step)
 
double singleStep () const
 
bool isValidStep (double step) const
 
void setPageStep (double step)
 
double pageStep () const
 
void setTickInterval (double ti)
 
double tickInterval () const
 
void setTickPosition (QSlider::TickPosition position)
 
QSlider::TickPosition tickPosition () const
 
double sliderPosition () const
 
void setSliderPosition (double)
 
void setTracking (bool enable)
 
bool hasTracking () const
 
void triggerAction (QAbstractSlider::SliderAction action)
 
Qt::Orientation orientation () const
 
void setInvertedAppearance (bool invertedAppearance)
 
bool invertedAppearance () const
 
void setInvertedControls (bool invertedControls)
 
bool invertedControls () const
 
QString handleToolTip () const
 
void setHandleToolTip (const QString &toolTip)
 
virtual bool eventFilter (QObject *, QEvent *)
 Reimplemented for internal reasons (handle tooltip).
 
void setValueProxy (ValueProxy *proxy)
 
ValueProxyvalueProxy () const
 

Protected Slots

void onValueChanged (int value)
 
void onSliderMoved (int position)
 
void onRangeChanged (int min, int max)
 
void onValueProxyAboutToBeModified ()
 
void onValueProxyModified ()
 

Protected Attributes

QScopedPointer< DoubleSliderPrivated_ptr
 

Properties

double value
 
double sliderPosition
 
double singleStep
 
double pageStep
 
double minimum
 
double maximum
 
double tickInterval
 
QSlider::TickPosition tickPosition
 
bool tracking
 
Qt::Orientation orientation
 
QString handleToolTip
 
bool invertedAppearance
 
bool invertedControls
 

Private Member Functions

 Q_DECLARE_PRIVATE (DoubleSlider)
 
 Q_DISABLE_COPY (DoubleSlider)
 

Detailed Description

DoubleSlider is a QSlider that controls doubles instead of integers. DoubleSlider internally aggregates a QSlider TODO: DoubleSlider tries to represent a double value with integers. It's of course non-optimal and can lead to errors, it would be better if DoubleSlider works like QDoubleSpinBox, where the value is a QVariant and the conversion between double and integer is only done to convert to/from screen coordinates.

See also
RangeSlider, DoubleRangeSlider, RangeWidget

Constructor & Destructor Documentation

DoubleSlider::DoubleSlider ( QWidget *  parent = 0)
explicit

Constructors, builds a slider whose default values are the same as QSlider (vertical by default).

DoubleSlider::DoubleSlider ( Qt::Orientation  orient,
QWidget *  parent = 0 
)
explicit

Constructors, builds a slider whose default values are the same as QSlider (vertical by default).

Member Function Documentation

QString DoubleSlider::handleToolTip ( ) const

Controls the text to display for the handle tooltip. It is in addition to the widget tooltip. "%1" is replaced by the current value of the slider. Empty string (by default) means no tooltip.

bool DoubleSlider::isValidStep ( double  step) const

Return true if the step can be handled by the slider, false otherwise. An invalid step is a step that can't be used to convert from double to int (too large or too small).

See also
singleStep
Qt::Orientation DoubleSlider::orientation ( ) const

This property holds the orientation of the slider. The orientation must be Qt::Vertical (the default) or Qt::Horizontal.

void DoubleSlider::rangeChanged ( double  min,
double  max 
)
signal

This signal is emitted when the slider range has changed, with min being the new minimum, and max being the new maximum. Warning: don't confound with valuesChanged(double, double);

See also
QAbstractSlider::rangeChanged()
void DoubleSlider::setInvertedAppearance ( bool  invertedAppearance)

This property holds whether or not a slider shows its values inverted. If this property is false (the default), the minimum and maximum will be shown in its classic position for the inherited widget. If the value is true, the minimum and maximum appear at their opposite location. Note: This property makes most sense for sliders and dials. For scroll bars, the visual effect of the scroll bar subcontrols depends on whether or not the styles understand inverted appearance; most styles ignore this property for scroll bars.

See also
invertedControls
void DoubleSlider::setInvertedControls ( bool  invertedControls)

This property holds whether or not the slider inverts its wheel and key events. If this property is false, scrolling the mouse wheel "up" and using keys like page up will increase the slider's value towards its maximum. Otherwise pressing page up will move value towards the slider's minimum.

See also
invertedAppearance
void DoubleSlider::setMaximum ( double  max)

This property holds the slider's maximum value. When setting this property, the minimum is adjusted if necessary to ensure that the range remains valid. Also the slider's current value is adjusted to be within the new range.

void DoubleSlider::setMinimum ( double  min)

This property holds the sliders's minimum value. When setting this property, the maximum is adjusted if necessary to ensure that the range remains valid. Also the slider's current value is adjusted to be within the new range.

void DoubleSlider::setOrientation ( Qt::Orientation  orientation)
slot

This property holds the orientation of the slider. The orientation must be Qt::Vertical (the default) or Qt::Horizontal.

void DoubleSlider::setPageStep ( double  step)

This property holds the page step. The larger of two natural steps that an abstract slider provides and typically corresponds to the user pressing PageUp or PageDown. Default value is 10.

void DoubleSlider::setRange ( double  min,
double  max 
)

Sets the slider's minimum to min and its maximum to max. If max is smaller than min, min becomes the only legal value.

In case QSlider::setRange(...) didn't notify the value has changed.

void DoubleSlider::setSingleStep ( double  step)

This property holds the single step. The smaller of two natural steps that an abstract sliders provides and typically corresponds to the user pressing an arrow key Default value is 1.

See also
isValidStep()
void DoubleSlider::setTickInterval ( double  ti)

This property holds the interval between tickmarks. This is a value interval, not a pixel interval. If it is 0, the slider will choose between lineStep() and pageStep(). The default value is 0.

void DoubleSlider::setTickPosition ( QSlider::TickPosition  position)

This property holds the tickmark position for this slider. The valid values are described by the QSlider::TickPosition enum. The default value is QSlider::NoTicks.

void DoubleSlider::setTracking ( bool  enable)

This property holds whether slider tracking is enabled. If tracking is enabled (the default), the slider emits the valueChanged() signal while the slider is being dragged. If tracking is disabled, the slider emits the valueChanged() signal only when the user releases the slider.

void DoubleSlider::setValue ( double  value)
slot

This property holds the slider's current value. The slider forces the value to be within the legal range: minimum <= value <= maximum. Changing the value also changes the sliderPosition.

void DoubleSlider::setValueProxy ( ValueProxy proxy)

Install or remove a value proxy filter. The value proxy decouples the displayed value from the value retrieved by the value property. For example, the value proxy can allow one to display celsius in the spinbox while the value retrieved from the value property and signals are in farenheit. To remove the proxy, simply install a new empty proxy. The proxy installation/removal is silent.

See also
setValueProxy(), valueProxy()
void DoubleSlider::sliderMoved ( double  position)
signal

This signal is emitted when sliderDown is true and the slider moves. This usually happens when the user is dragging the slider. The value is the new slider position. This signal is emitted even when tracking is turned off.

double DoubleSlider::sliderPosition ( ) const

This property holds the current slider position. If there is no proxy installed and tracking is enabled (the default), this is identical to value. With a proxy installed, it allows to modify the proxy value.

See also
value(), setValue(), setValueProxy(), valueProxy()
void DoubleSlider::sliderPressed ( )
signal

This signal is emitted when the user presses the slider with the mouse, or programmatically when setSliderDown(true) is called.

void DoubleSlider::sliderReleased ( )
signal

This signal is emitted when the user releases the slider with the mouse, or programmatically when setSliderDown(false) is called.

void DoubleSlider::triggerAction ( QAbstractSlider::SliderAction  action)

Triggers a slider action. Possible actions are SliderSingleStepAdd, SliderSingleStepSub, SliderPageStepAdd, SliderPageStepSub, SliderToMinimum, SliderToMaximum, and SliderMove.

double DoubleSlider::value ( ) const

This property holds the slider's current value. The slider forces the value to be within the legal range: minimum <= value <= maximum. Changing the value also changes the sliderPosition.

void DoubleSlider::valueChanged ( double  value)
signal

This signal is emitted when the slider value has changed, with the new slider value as argument.


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