itom
Loading...
Searching...
No Matches
Public Types | Public Slots | Signals | Public Member Functions | Protected Slots | Protected Member Functions | Protected Attributes | Properties | Private Member Functions | List of all members
RangeSlider Class Reference

#include <rangeSlider.h>

Inheritance diagram for RangeSlider:

Public Types

typedef QSlider Superclass
 

Public Slots

void setMinimumValue (int min)
 
void setMaximumValue (int max)
 
void setValues (int min, int max)
 

Signals

void minimumValueChanged (int min)
 
void maximumValueChanged (int max)
 
void valuesChanged (int min, int max)
 Utility signal that is fired when minimum or maximum values have changed.
 
void minimumPositionChanged (int min)
 
void maximumPositionChanged (int max)
 
void positionsChanged (int min, int max)
 

Public Member Functions

 RangeSlider (Qt::Orientation o, QWidget *par=0)
 
 RangeSlider (QWidget *par=0)
 
int minimumValue () const
 
int maximumValue () const
 
int minimumPosition () const
 
void setMinimumPosition (int min)
 
int maximumPosition () const
 
void setMaximumPosition (int max)
 
uint stepSizePosition () const
 
void setStepSizePosition (uint stepSize)
 
uint minimumRange () const
 
void setMinimumRange (uint min)
 
uint maximumRange () const
 
void setMaximumRange (uint max)
 
uint stepSizeRange () const
 
void setStepSizeRange (uint stepSize)
 
bool rangeIncludeLimits () const
 
void setRangeIncludeLimits (bool include)
 
void setPositions (int min, int max)
 
bool symmetricMoves () const
 
void setSymmetricMoves (bool symmetry)
 
bool useStyleSheets () const
 
void setUseStyleSheets (bool useStyleSheets)
 
float handleBorderRadius () const
 
void setHandleBorderRadius (float radius)
 
QString handleToolTip () const
 
void setHandleToolTip (const QString &toolTip)
 
bool isMinimumSliderDown () const
 
bool isMaximumSliderDown () const
 
void setLimitsFromIntervalMeta (const ito::IntervalMeta &intervalMeta)
 

Protected Slots

void onRangeChanged (int minimum, int maximum)
 

Protected Member Functions

 RangeSlider (RangeSliderPrivate *impl, Qt::Orientation o, QWidget *par=0)
 
 RangeSlider (RangeSliderPrivate *impl, QWidget *par=0)
 
virtual void mousePressEvent (QMouseEvent *ev)
 
virtual void mouseMoveEvent (QMouseEvent *ev)
 
virtual void mouseReleaseEvent (QMouseEvent *ev)
 
virtual void keyPressEvent (QKeyEvent *ev)
 
virtual void paintEvent (QPaintEvent *ev)
 
virtual void initMinimumSliderStyleOption (QStyleOptionSlider *option) const
 
virtual void initMaximumSliderStyleOption (QStyleOptionSlider *option) const
 
virtual bool event (QEvent *event)
 

Protected Attributes

QScopedPointer< RangeSliderPrivate > d_ptr
 

Properties

int minimumValue
 
int maximumValue
 
int minimumPosition
 
int maximumPosition
 
uint stepSizePosition
 
uint minimumRange
 
uint maximumRange
 
uint stepSizeRange
 
bool rangeIncludeLimits
 
bool symmetricMoves
 
QString handleToolTip
 
bool useStyleSheets
 
float handleBorderRadius
 

Private Member Functions

 Q_DECLARE_PRIVATE (RangeSlider)
 
 Q_DISABLE_COPY (RangeSlider)
 

Detailed Description

A RangeSlider is a slider that lets you input 2 values instead of one (see QSlider). These values are typically a lower and upper bound. Values are comprised between the range of the slider. See setRange(), minimum() and maximum(). The upper bound can't be smaller than the lower bound and vice-versa. When setting new values (setMinimumValue(), setMaximumValue() or setValues()), make sure they lie between the range (minimum(), maximum()) of the slider, they would be forced otherwised. If it is not the behavior you desire, you can set the range first (setRange(), setMinimum(), setMaximum()) TODO: support triggerAction(QAbstractSlider::SliderSingleStepSub) that moves both values at a time.

See also
DoubleRangeSlider, DoubleSlider, RangeWidget

Constructor & Destructor Documentation

◆ RangeSlider()

RangeSlider::RangeSlider ( Qt::Orientation o,
QWidget * par = 0 )
explicit

Constructor, builds a RangeSlider that ranges from 0 to 100 and has a lower and upper values of 0 and 100 respectively, other properties are set the QSlider default properties.

Member Function Documentation

◆ handleBorderRadius()

float RangeSlider::handleBorderRadius ( ) const

When useStyleSheets is enabled, the groove and handles are not rendered by the native style methods, but by special methods, that obtain colors from the current palette. This option should be enabled by style sheets, since the Qt QStyleSheetStyle is not able to properly render two handles and a colored groove.

◆ handleToolTip()

QString RangeSlider::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.

◆ isMaximumSliderDown()

bool RangeSlider::isMaximumSliderDown ( ) const

Returns true if the maximum value handle is down, false if it is up.

See also
isMinimumSliderDown()

◆ isMinimumSliderDown()

bool RangeSlider::isMinimumSliderDown ( ) const

Returns true if the minimum value handle is down, false if it is up.

See also
isMaximumSliderDown()

◆ maximumPosition()

int RangeSlider::maximumPosition ( ) const

This property holds the current slider maximum position. If tracking is enabled (the default), this is identical to maximumValue.

◆ maximumPositionChanged

void RangeSlider::maximumPositionChanged ( int max)
signal

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

◆ maximumRange()

uint RangeSlider::maximumRange ( ) const

This property holds the maximum allowed range. The range is (1+maximumRange-minimumRange) if rangeIncludeLimits is true, else (maximumRange-minimumRange)

◆ maximumValue()

int RangeSlider::maximumValue ( ) const

This property holds the slider's current maximum value. The slider forces the maximum value to be within the legal range: The slider silently forces maximumValue to be within the legal range: Changing the maximumValue also changes the maximumPosition.

◆ maximumValueChanged

void RangeSlider::maximumValueChanged ( int max)
signal

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

◆ minimumPosition()

int RangeSlider::minimumPosition ( ) const

This property holds the current slider minimum position. If tracking is enabled (the default), this is identical to minimumValue.

◆ minimumPositionChanged

void RangeSlider::minimumPositionChanged ( int min)
signal

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

◆ minimumRange()

uint RangeSlider::minimumRange ( ) const

This property holds the minimum allowed range. The range is (1+maximumRange-minimumRange) if rangeIncludeLimits is true, else (maximumRange-minimumRange)

◆ minimumValue()

int RangeSlider::minimumValue ( ) const

This property holds the slider's current minimum value. The slider silently forces minimumValue to be within the legal range: minimum() <= minimumValue() <= maximumValue() <= maximum(). Changing the minimumValue also changes the minimumPosition.

◆ minimumValueChanged

void RangeSlider::minimumValueChanged ( int min)
signal

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

◆ positionsChanged

void RangeSlider::positionsChanged ( int min,
int max )
signal

Utility signal that is fired when minimum or maximum positions have changed.

◆ rangeIncludeLimits()

bool RangeSlider::rangeIncludeLimits ( ) const

This property indicates if the range is assumed to be (1+maximumRange-minimumRange) (true) or (maximumRange-minimumRange) (false). The first case is important if the rangeSlider is used for ROIs of cameras, where the first and last value are inside of the ROI.

◆ setLimitsFromIntervalMeta()

void RangeSlider::setLimitsFromIntervalMeta ( const ito::IntervalMeta & intervalMeta)

The range slider can be used for parameters whose meta data is of type ito::IntervalMeta or ito::RangeMeta. In this case, the limits, step sizes... of this rangeSlider can be automatically adapted to the requirements given by the corresponding parameter.

◆ setMaximumValue

void RangeSlider::setMaximumValue ( int max)
slot

This property holds the slider's current maximum value. The slider silently forces max to be within the legal range: minimum() <= minimumValue() <= max <= maximum(). Note: Changing the maximumValue also changes the maximumPosition.

See also
stMinimumValue, setValues, setMinimum, setMaximum, setRange

◆ setMinimumValue

void RangeSlider::setMinimumValue ( int min)
slot

This property holds the slider's current minimum value. The slider silently forces min to be within the legal range: minimum() <= min <= maximumValue() <= maximum(). Note: Changing the minimumValue also changes the minimumPosition.

See also
stMaximumValue, setValues, setMinimum, setMaximum, setRange

◆ setPositions()

void RangeSlider::setPositions ( int min,
int max )

Utility function that set the minimum position and maximum position at once.

◆ setValues

void RangeSlider::setValues ( int min,
int max )
slot

Utility function that set the minimum value and maximum value at once. The slider silently forces min and max to be within the legal range: minimum() <= min <= max <= maximum(). Note: Changing the minimumValue and maximumValue also changes the minimumPosition and maximumPosition.

See also
setMinimumValue, setMaximumValue, setMinimum, setMaximum, setRange

◆ stepSizePosition()

uint RangeSlider::stepSizePosition ( ) const

This property holds the step size for the left or right slider position. If the stepSize is equal to 1, this property has no impact.

◆ stepSizeRange()

uint RangeSlider::stepSizeRange ( ) const

This property holds the step size of the allowed range. The range is (1+maximumRange-minimumRange) if rangeIncludeLimits is true, else (maximumRange-minimumRange)

◆ symmetricMoves()

bool RangeSlider::symmetricMoves ( ) const

When symmetricMoves is true, moving a handle will move the other handle symmetrically, otherwise the handles are independent. False by default

◆ useStyleSheets()

bool RangeSlider::useStyleSheets ( ) const

When useStyleSheets is enabled, the groove and handles are not rendered by the native style methods, but by special methods, that obtain colors from the current palette. This option should be enabled by style sheets, since the Qt QStyleSheetStyle is not able to properly render two handles and a colored groove.

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