Home | All Classes | Main Classes | Annotated | Grouped Classes | Functions |

# TQSlider Class Reference

The TQSlider widget provides a vertical or horizontal slider. More...

`#include <ntqslider.h>`

Inherits TQWidget and TQRangeControl.

List of all member functions.

## Public Members

- enum TickSetting { NoMarks = 0, Above = 1, Left = Above, Below = 2, Right = Below, Both = 3 }
- TQSlider ( TQWidget * parent, const char * name = 0 )
- TQSlider ( Orientation orientation, TQWidget * parent, const char * name = 0 )
- TQSlider ( int minValue, int maxValue, int pageStep, int value, Orientation orientation, TQWidget * parent, const char * name = 0 )
- ~TQSlider ()
- virtual void setOrientation ( Orientation )
- Orientation orientation () const
- virtual void setTracking ( bool enable )
- bool tracking () const
- virtual void setPalette ( const TQPalette & p )
- int sliderStart () const
- TQRect sliderRect () const
- virtual void setTickmarks ( TickSetting )
- TickSetting tickmarks () const
- virtual void setTickInterval ( int )
- int tickInterval () const
- int minValue () const
- int maxValue () const
- void setMinValue ( int )
- void setMaxValue ( int )
- int lineStep () const
- int pageStep () const
- void setLineStep ( int )
- void setPageStep ( int )
- int value () const

## Public Slots

- virtual void setValue ( int )
- void addStep ()
- void subtractStep ()

## Signals

- void valueChanged ( int value )
- void sliderPressed ()
- void sliderMoved ( int value )
- void sliderReleased ()

## Important Inherited Members

- void setRange ( int minValue, int maxValue )

## Properties

- int lineStep - the current line step
- int maxValue - the current maximum value of the slider
- int minValue - the current minimum value of the slider
- Orientation orientation - the slider's orientation
- int pageStep - the current page step
- int tickInterval - the interval between tickmarks
- TickSetting tickmarks - the tickmark settings for this slider
- bool tracking - whether slider tracking is enabled
- int value - the current slider value

## Protected Members

- virtual void valueChange ()
- virtual void rangeChange ()

## Detailed Description

The TQSlider 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 along a horizontal or vertical groove and translates the slider's position into an integer value within the legal range.

TQSlider inherits TQRangeControl, which provides the "integer" side of the slider. setRange() and value() are likely to be used by practically all slider users; see the TQRangeControl documentation for information about the many other functions that class provides.

The main functions offered by the slider itself are tickmark and orientation control; you can use setTickmarks() to indicate where you want the tickmarks to be, setTickInterval() to indicate how many of them you want and setOrientation() to indicate whether the slider is to be horizontal or vertical.

A slider accepts focus on Tab and uses the mouse wheel and a suitable keyboard interface.

See also TQScrollBar, TQSpinBox, GUI Design Handbook: Slider, and Basic Widgets.

## Member Type Documentation

### TQSlider::TickSetting

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

- `TQSlider::NoMarks` - do not draw any tickmarks.
- `TQSlider::Both` - draw tickmarks on both sides of the groove.
- `TQSlider::Above` - draw tickmarks above the (horizontal) slider
- `TQSlider::Below` - draw tickmarks below the (horizontal) slider
- `TQSlider::Left` - draw tickmarks to the left of the (vertical) slider
- `TQSlider::Right` - draw tickmarks to the right of the (vertical) slider

## Member Function Documentation

### TQSlider::TQSlider ( TQWidget * parent, const char * name = 0 )

Constructs a vertical slider.

The parent and name arguments are sent on to the TQWidget constructor.

### TQSlider::TQSlider ( Orientation orientation, TQWidget * parent, const char * name = 0 )

Constructs a slider.

The orientation must be TQt::Vertical or TQt::Horizontal.

The parent and name arguments are sent on to the TQWidget constructor.

### TQSlider::TQSlider ( int minValue, int maxValue, int pageStep, int value, Orientation orientation, TQWidget * parent, const char * name = 0 )

Constructs a slider whose value can never be smaller than minValue or greater than maxValue, whose page step size is pageStep and whose value is initially value (which is guaranteed to be in range using bound()).

If orientation is TQt::Vertical the slider is vertical and if it is TQt::Horizontal the slider is horizontal.

The parent and name arguments are sent on to the TQWidget constructor.

### TQSlider::~TQSlider ()

Destructor.

### void TQSlider::addStep ()`[slot]`

Moves the slider one pageStep() up or right.

### int TQSlider::lineStep () const

Returns the current line step. See the "lineStep" property for details.

### int TQSlider::maxValue () const

Returns the current maximum value of the slider. See the "maxValue" property for details.

### int TQSlider::minValue () const

Returns the current minimum value of the slider. See the "minValue" property for details.

### Orientation TQSlider::orientation () const

Returns the slider's orientation. See the "orientation" property for details.

### int TQSlider::pageStep () const

Returns the current page step. See the "pageStep" property for details.

### void TQSlider::rangeChange ()`[virtual protected]`

Implements the virtual TQRangeControl function.

Reimplemented from TQRangeControl.

### void TQSlider::setLineStep ( int )

Sets the current line step. See the "lineStep" property for details.

### void TQSlider::setMaxValue ( int )

Sets the current maximum value of the slider. See the "maxValue" property for details.

### void TQSlider::setMinValue ( int )

Sets the current minimum value of the slider. See the "minValue" property for details.

### void TQSlider::setOrientation ( Orientation )`[virtual]`

Sets the slider's orientation. See the "orientation" property for details.

### void TQSlider::setPageStep ( int )

Sets the current page step. See the "pageStep" property for details.

### void TQSlider::setPalette ( const TQPalette & p )`[virtual]`

Reimplements the virtual function TQWidget::setPalette().

Sets the background color to the mid color for Motif style sliders using palette p.

Reimplemented from TQWidget.

### void TQRangeControl::setRange ( int minValue, int maxValue )

Sets the range control's minimum value to minValue and its maximum value to maxValue.

Calls the virtual rangeChange() function if one or both of the new minimum and maximum values are different from the previous setting. Calls the virtual valueChange() function if the current value is adjusted because it was outside the new range.

If maxValue is smaller than minValue, minValue becomes the only legal value.

See also minValue and maxValue.

Examples: listbox/listbox.cpp, t12/lcdrange.cpp, t5/main.cpp, t6/main.cpp, t8/lcdrange.cpp, and xform/xform.cpp.

### void TQSlider::setTickInterval ( int )`[virtual]`

Sets the interval between tickmarks. See the "tickInterval" property for details.

### void TQSlider::setTickmarks ( TickSetting )`[virtual]`

Sets the tickmark settings for this slider. See the "tickmarks" property for details.

### void TQSlider::setTracking ( bool enable )`[virtual]`

Sets whether slider tracking is enabled to enable. See the "tracking" property for details.

### void TQSlider::setValue ( int )`[virtual slot]`

Sets the current slider value. See the "value" property for details.

### void TQSlider::sliderMoved ( int value )`[signal]`

This signal is emitted when the slider is dragged, with the new slider value as its argument.

### void TQSlider::sliderPressed ()`[signal]`

This signal is emitted when the user presses the slider with the mouse.

### TQRect TQSlider::sliderRect () const

Returns the slider handle rectangle. (This is the visual marker that the user can move.)

### void TQSlider::sliderReleased ()`[signal]`

This signal is emitted when the user releases the slider with the mouse.

### int TQSlider::sliderStart () const

Returns the start position of the slider.

### void TQSlider::subtractStep ()`[slot]`

Moves the slider one pageStep() down or left.

### int TQSlider::tickInterval () const

Returns the interval between tickmarks. See the "tickInterval" property for details.

### TickSetting TQSlider::tickmarks () const

Returns the tickmark settings for this slider. See the "tickmarks" property for details.

### bool TQSlider::tracking () const

Returns TRUE if slider tracking is enabled; otherwise returns FALSE. See the "tracking" property for details.

### int TQSlider::value () const

Returns the current slider value. See the "value" property for details.

### void TQSlider::valueChange ()`[virtual protected]`

Implements the virtual TQRangeControl function.

Reimplemented from TQRangeControl.

### void TQSlider::valueChanged ( int value )`[signal]`

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

Examples: rangecontrols/rangecontrols.cpp, simple/main.cpp, t12/lcdrange.cpp, t5/main.cpp, t6/main.cpp, t7/lcdrange.cpp, and xform/xform.cpp.

## Property Documentation

### int lineStep

This property holds the current line step.

When setting lineStep, the virtual stepChange() function will be called if the new line step is different from the previous setting.

See also setSteps(), TQRangeControl::pageStep(), and setRange().

Set this property's value with setLineStep() and get this property's value with lineStep().

### int maxValue

This property holds the current maximum value of the slider.

When setting this property, the TQSlider::minValue is adjusted, if necessary, to ensure that the range remains valid.

See also setRange().

Set this property's value with setMaxValue() and get this property's value with maxValue().

### int minValue

This property holds the current minimum value of the slider.

When setting this property, the TQSlider::maxValue is adjusted, if necessary, to ensure that the range remains valid.

See also setRange().

Set this property's value with setMinValue() and get this property's value with minValue().

### Orientation orientation

This property holds the slider's orientation.

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

Set this property's value with setOrientation() and get this property's value with orientation().

### int pageStep

This property holds the current page step.

When setting pageStep, the virtual stepChange() function will be called if the new page step is different from the previous setting.

See also TQRangeControl::setSteps(), lineStep, and setRange().

Set this property's value with setPageStep() and get this property's value with pageStep().

### int tickInterval

This property holds the interval between tickmarks.

This is a value interval, not a pixel interval. If it is 0, the slider will choose between lineStep() and pageStep(). The initial value of tickInterval is 0.

See also TQRangeControl::lineStep() and TQRangeControl::pageStep().

Set this property's value with setTickInterval() and get this property's value with tickInterval().

### TickSetting tickmarks

This property holds the tickmark settings for this slider.

The valid values are in TQSlider::TickSetting. The default is NoMarks.

See also tickInterval.

Set this property's value with setTickmarks() and get this property's value with tickmarks().

### bool tracking

This property holds whether slider tracking is enabled.

If tracking is enabled (the default), the slider emits the valueChanged() signal whenever the slider is being dragged. If tracking is disabled, the slider emits the valueChanged() signal when the user releases the mouse button (unless the value happens to be the same as before).

Set this property's value with setTracking() and get this property's value with tracking().

### int value

This property holds the current slider value.

Set this property's value with setValue() and get this property's value with value().

See also TQRangeControl::value() and prevValue().

This file is part of the TQt toolkit. Copyright © 1995-2007 Trolltech. All Rights Reserved.