The QSlider widget provides a vertical or horizontal slider. The slider is the classic widget for controlling a bounded value. It lets the user move a slider handle along a horizontal or vertical groove and translates the handle's position into an integer value within the legal range.

QSlider has very few of its own methods. Most of the functionality is inherited from QAbstractSlider. The most useful methods are setValue() to set the slider directly to some value, triggerAction() to simulate the effects of clicking, setSingleStep() and setPageStep() to set the steps, and setMinimum() and setMaximum() to define the range of the scroll bar.

QSlider provides methods for controlling tickmarks. You can use setTickPosition() to indicate where you want the tickmarks to be, setTickInterval() to indicate how many of them you want. the currently set tick position and interval can be queried using the tickPosition() and tickInterval() functions, respectively.

Signals

QSlider inherits a comprehensive set of signals.

QSlider only provides integer ranges. Although QSlider handles very large numbers, it becomes difficult for users to use a slider accurately for very large ranges.

Keyboard Input

A slider accepts focus on Tab and provides both a mouse wheel and a keyboard interface. The keyboard interface is the following.

• Left/Right move a horizontal slider by one single step.
• Up/Down move a vertical slider by one single step.
• PageUp moves up one page.
• PageDown moves down one page.
• Home moves to the start (minimum).
• End moves to the end (maximum).

	A slider shown in the Windows XP widget style.
	A slider shown in the Mac OS X widget style.
	A slider shown in the Fusion widget style.

See also

QScrollBar, QSpinBox, QDial