Contents

• Public Types
• Properties
• Public Functions
• Reimplemented Public Functions
• Protected Functions
• Reimplemented Protected Functions
• Detailed Description

Detailed Description

TheQSlider 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 functions; most of the functionality is inQAbstractSlider. The most useful functions aresetValue() to set the slider directly to some value;triggerAction() to simulate the effects of clicking (useful for shortcut keys);setSingleStep(),setPageStep() to set the steps; andsetMinimum() andsetMaximum() to define the range of the scroll bar.

QSlider provides methods for controlling tickmarks. You can usesetTickPosition() 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 thetickPosition() andtickInterval() functions, respectively.

QSlider inherits a comprehensive set of signals:

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

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 (mininum).
• End moves to the end (maximum).

	A slider shown in theMacintosh widget style.
	A slider shown in theWindows XP widget style.
	A slider shown in thePlastique widget style.

Member Type Documentation

enum QSlider::TickPosition

This enum specifies where the tick marks are to be drawn relative to the slider's groove and the handle the user moves.

Property Documentation

tickInterval :int

This property holds the interval between tickmarks.

This is a value interval, not a pixel interval. If it is 0, the slider will choose betweensingleStep() andpageStep().

The default value is 0.

Access functions:

See alsotickPosition,lineStep(), andpageStep().

tickPosition :TickPosition

This property holds the tickmark position for this slider.

The valid values are described by theQSlider::TickPosition enum.

The default value isQSlider::NoTicks.

Access functions:

See alsotickInterval.

Member Function Documentation

QSlider::QSlider(QWidget * parent = 0)

Constructs a vertical slider with the givenparent.

QSlider::QSlider(Qt::Orientation orientation,QWidget * parent = 0)

Constructs a slider with the givenparent. Theorientation parameter determines whether the slider is horizontal or vertical; the valid values areQt::Vertical andQt::Horizontal.

QSlider::~QSlider()

Destroys this slider.

[virtual]bool QSlider::event(QEvent * event)

Reimplemented fromQObject::event().

[protected]void QSlider::initStyleOption(QStyleOptionSlider * option) const

Initializeoption with the values from thisQSlider. This method is useful for subclasses when they need aQStyleOptionSlider, but don't want to fill in all the information themselves.

See alsoQStyleOption::initFrom().

[virtual]QSize QSlider::minimumSizeHint() const

Reimplemented fromQWidget::minimumSizeHint().

[virtual protected]void QSlider::mouseMoveEvent(QMouseEvent * ev)

Reimplemented fromQWidget::mouseMoveEvent().

[virtual protected]void QSlider::mousePressEvent(QMouseEvent * ev)

Reimplemented fromQWidget::mousePressEvent().

[virtual protected]void QSlider::mouseReleaseEvent(QMouseEvent * ev)

Reimplemented fromQWidget::mouseReleaseEvent().

[virtual protected]void QSlider::paintEvent(QPaintEvent * ev)

Reimplemented fromQWidget::paintEvent().

[virtual]QSize QSlider::sizeHint() const

Reimplemented fromQWidget::sizeHint().