QAbstractSlider Class

See also QAbstractSpinBox, QSlider, QDial, QScrollBar, Sliders Example

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.

Access functions:

• bool invertedAppearance() const

• void setInvertedAppearance(bool)

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.

Access functions:

• bool invertedControls() const

• void setInvertedControls(bool)

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.

Access functions:

• int maximum() const

• void setMaximum(int)

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.

Access functions:

• int minimum() const

• void setMinimum(int)

This property holds the orientation of the slider

The orientation must be Qt::Vertical (the default) or Qt::Horizontal.

Access functions:

• orientation() const

• void setOrientation(Qt::Orientation)

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.

Access functions:

• int pageStep() const

• void setPageStep(int)

See Also▲

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.

If the property is modified during an auto repeating key event, behavior is undefined.

Access functions:

• int singleStep() const

• void setSingleStep(int)

See Also▲

This property holds whether the slider is pressed down.

The property is set by subclasses in order to let the abstract slider know whether or not tracking has any effect.

Changing the slider down property emits the sliderPressed() and sliderReleased() signals.

Access functions:

• bool isSliderDown() const

• void setSliderDown(bool)

This property holds the current slider position

If tracking is enabled (the default), this is identical to value.

Access functions:

• int sliderPosition() const

• void setSliderPosition(int)

Notifier signal:

• void sliderMoved(int value)

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.

Access functions:

• bool hasTracking() const

• void setTracking(bool enable)

See Also▲

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.

Access functions:

• int value() const

• void setValue(int)

Notifier signal:

• void valueChanged(int value)

Constructs an abstract slider.

The parent argument is sent to the QWidget constructor.

The minimum defaults to 0, the maximum to 99, with a singleStep size of 1 and a pageStep size of 10, and an initial value of 0.

Destroys the slider.

This signal is emitted when the slider action action is triggered. Actions are SliderSingleStepAdd, SliderSingleStepSub, SliderPageStepAdd, SliderPageStepSub, SliderToMinimum, SliderToMaximum, and SliderMove.

When the signal is emitted, the sliderPosition has been adjusted according to the action, but the value has not yet been propagated (meaning the valueChanged() signal was not yet emitted), and the visual display has not been updated. In slots connected to this signal you can thus safely adjust any action by calling setSliderPosition() yourself, based on both the action and the slider's value.

See Also▲

Reimplements: QWidget::changeEvent(QEvent *event).

Reimplements: QWidget::event(QEvent *event).

Reimplements: QWidget::keyPressEvent(QKeyEvent *event).

This signal is emitted when the slider range has changed, with min being the new minimum, and max being the new maximum.

See Also▲

Returns the current repeat action.

See Also▲

Sets the slider's minimum to min and its maximum to max.

If max is smaller than min, min becomes the only legal value.

See Also▲

Sets action action to be triggered repetitively in intervals of repeatTime, after an initial delay of thresholdTime.

See Also▲

Reimplement this virtual function to track slider changes such as SliderRangeChange, SliderOrientationChange, SliderStepsChange, or SliderValueChange. The default implementation only updates the display and ignores the change parameter.

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.

See Also▲

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

See Also▲

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

See Also▲

Reimplements: QObject::timerEvent(QTimerEvent *event).

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

See Also▲

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

Reimplements: QWidget::wheelEvent(QWheelEvent *event).