Skip to content

QLabeledSlider

A slider with a label next to it that shows the slider's value. The value can be typed into the label.

QLabeledSlider is a QAbstractSlider that wraps a QSlider and a label; slider methods such as setRange and setValue work as they do on a QSlider. To move the label to the other side, or hide it, use setEdgeLabelPosition (with LabelPosition.LabelsLeft or LabelPosition.NoLabel).

QLabeledSlider QLabeledSlider
from qtpy.QtCore import Qt
from qtpy.QtWidgets import QApplication

from superqt import QLabeledSlider

app = QApplication([])

slider = QLabeledSlider(Qt.Orientation.Horizontal)
slider.setValue(42)
slider.show()

app.exec()

QLabeledSlider

QLabeledSlider(parent: QWidget | None = ...)
QLabeledSlider(
    orientation: Orientation, parent: QWidget | None = ...
)

Subclass of QAbstractSlider

QLabeledSlider inherits all of QAbstractSlider's methods, signals, and properties. Only those that superqt adds or changes are listed here.

Signals

  • editingFinished()

Enums

QLabeledSlider.EdgeLabelMode
LabelIsRange, LabelIsValue
QLabeledSlider.LabelPosition
NoLabel, LabelsAbove, LabelsBelow, LabelsOnHandle

Methods

edgeLabelMode

edgeLabelMode() -> EdgeLabelMode

Return current EdgeLabelMode.

edgeLabelPosition

edgeLabelPosition() -> LabelPosition

Return where/whether a label is shown at the edge of the slider.

setEdgeLabelMode

setEdgeLabelMode(opt: EdgeLabelMode) -> None

Set the EdgeLabelMode.

Parameters:

  • opt (EdgeLabelMode) –

    To show no label, use EdgeLabelMode.NoLabel. To show the value of the slider, use EdgeLabelMode.LabelIsValue. To show value / maximum, use EdgeLabelMode.LabelIsValue | EdgeLabelMode.LabelIsRange.

setEdgeLabelPosition

setEdgeLabelPosition(opt: LabelPosition) -> None

Set where/whether a label is shown at the edge of the slider.

setOrientation

setOrientation(orientation: Orientation) -> None

Set orientation, value will be 'horizontal' or 'vertical'.

setTickInterval

setTickInterval(interval: int) -> None

setTickPosition

setTickPosition(pos: TickPosition) -> None

tickInterval

tickInterval() -> int

tickPosition

tickPosition() -> TickPosition