Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.trolltech.qt.gui
Class QAbstractSlider

    java.lang.Object
      com.trolltech.qt.QSignalEmitter
          com.trolltech.qt.QtJambiObject
              com.trolltech.qt.core.QObject
                  com.trolltech.qt.gui.QWidget
                      com.trolltech.qt.gui.QAbstractSlider

All Implemented Interfaces:
  QPaintDeviceInterface, QtJambiInterface

Direct Known Subclasses:
  QDial, QScrollBar, QSlider

    public class QAbstractSlider

extends QWidget

The `QAbstractSlider` class provides an integer value within a range. The class is designed as a common super class for widgets like `QScrollBar`, `QSlider` and `QDial`.

Here are the main properties of the class:

1. `value`: The bounded integer that `QAbstractSlider` maintains.
2. `minimum`: The lowest possible value.
3. `maximum`: The highest possible value.
4. `singleStep`: The smaller of two natural steps that an abstract sliders provides and typically corresponds to the user pressing an arrow key.
5. `pageStep`: The larger of two natural steps that an abstract slider provides and typically corresponds to the user pressing `PageUp` or `PageDown`.
6. `tracking`: Whether slider tracking is enabled.
7. `sliderPosition`: The current position of the slider. If `tracking` is enabled (the default), this is identical to `value`.

Unity (1) may be viewed as a third step size. `setValue()` lets you set the current value to any integer in the allowed range, not just `minimum()` + n * `singleStep()` for integer values of n. Some widgets may allow the user to set any value at all; others may just provide multiples of `singleStep()` or `pageStep()`.

`QAbstractSlider` emits a comprehensive set of signals:

Signal | Emitted when
--- | ---
`valueChanged()` | the value has changed. The `tracking` determines whether this signal is emitted during user interaction.
`sliderPressed()` | the user starts to drag the slider.
`sliderMoved()` | the user drags the slider.
`sliderReleased()` | the user releases the slider.
`actionTriggered()` | a slider action was triggerd.
`rangeChanged()` | a the range has changed.

`QAbstractSlider` provides a virtual `sliderChange()` function that is well suited for updating the on-screen representation of sliders. By calling `triggerAction()`, subclasses trigger slider actions. Two helper functions `QStyle::sliderPositionFromValue()` and `QStyle::sliderValueFromPosition()` help subclasses and styles to map screen coordinates to logical range values.

See also:
  `QAbstractSpinBox`, `QSlider`, `QDial`, `QScrollBar`, and Sliders Example.

Nested Class Summary
`static class` | `QAbstractSlider.SliderAction`
`static class` | `QAbstractSlider.SliderChange`

Nested classes/interfaces inherited from class com.trolltech.qt.gui.QWidget
`QWidget.RenderFlag, QWidget.RenderFlags`

Nested classes/interfaces inherited from class com.trolltech.qt.QSignalEmitter
`QSignalEmitter.Signal0, QSignalEmitter.Signal1, QSignalEmitter.Signal2, QSignalEmitter.Signal3, QSignalEmitter.Signal4, QSignalEmitter.Signal5, QSignalEmitter.Signal6, QSignalEmitter.Signal7, QSignalEmitter.Signal8, QSignalEmitter.Signal9`

Field Summary
`QSignalEmitter.Signal1` | `actionTriggered` This signal is emitted when the slider action `action` is triggered.
`QSignalEmitter.Signal2` | `rangeChanged` This signal is emitted when the slider range has changed, with `min` being the new minimum, and `max` being the new maximum.
`QSignalEmitter.Signal1` | `sliderMoved` This signal is emitted when `sliderDown` is true and the slider moves.
`QSignalEmitter.Signal0` | `sliderPressed` This signal is emitted when the user presses the slider with the mouse, or programmatically when `setSliderDown` (true) is called.
`QSignalEmitter.Signal0` | `sliderReleased` This signal is emitted when the user releases the slider with the mouse, or programmatically when `setSliderDown` (false) is called.
`QSignalEmitter.Signal1` | `valueChanged` This signal is emitted when the slider value has changed, with the new slider `value` as argument.

Fields inherited from class com.trolltech.qt.gui.QWidget
`customContextMenuRequested`

Constructor Summary
`QAbstractSlider()` Constructs an abstract slider.
`QAbstractSlider(QWidget parent)` Constructs an abstract slider.

Method Summary
`static QAbstractSlider` | `fromNativePointer(QNativePointer nativePointer)` This method returns the QAbstractSlider instance pointed to by `nativePointer`.
`boolean` | `hasTracking()` This property holds whether slider tracking is enabled.
`boolean` | `invertedAppearance()` This property holds whether or not a slider shows its values inverted.
`boolean` | `invertedControls()` This property holds whether or not the slider inverts its wheel and key events.
`boolean` | `isSliderDown()` This property holds whether the slider is pressed down.
`int` | `maximum()` This property holds the slider's maximum value.
`int` | `minimum()` This property holds the sliders's minimum value.
`Qt.Orientation` | `orientation()` This property holds the orientation of the slider.
`int` | `pageStep()` This property holds the page step.
`protected QAbstractSlider.SliderAction` | `repeatAction()` Returns the current repeat action.
`void` | `setInvertedAppearance(boolean arg__1)` This property holds whether or not a slider shows its values inverted.
`void` | `setInvertedControls(boolean arg__1)` This property holds whether or not the slider inverts its wheel and key events.
`void` | `setMaximum(int arg__1)` This property holds the slider's maximum value.
`void` | `setMinimum(int arg__1)` This property holds the sliders's minimum value.
`void` | `setOrientation(Qt.Orientation arg__1)` This property holds the orientation of the slider.
`void` | `setPageStep(int arg__1)` This property holds the page step.
`void` | `setRange(int min, int max)` Sets the slider's minimum to `min` and its maximum to `max`.
`protected void` | `setRepeatAction(QAbstractSlider.SliderAction action)` Sets action `action` to be triggered repetitively in intervals of `repeatTime`, after an initial delay of `thresholdTime`.
`protected void` | `setRepeatAction(QAbstractSlider.SliderAction action, int thresholdTime)` Sets action `action` to be triggered repetitively in intervals of `repeatTime`, after an initial delay of `thresholdTime`.
`protected void` | `setRepeatAction(QAbstractSlider.SliderAction action, int thresholdTime, int repeatTime)` Sets action `action` to be triggered repetitively in intervals of `repeatTime`, after an initial delay of `thresholdTime`.
`void` | `setSingleStep(int arg__1)` This property holds the single step.
`void` | `setSliderDown(boolean arg__1)` This property holds whether the slider is pressed down.
`void` | `setSliderPosition(int arg__1)` This property holds the current slider position.
`void` | `setTracking(boolean enable)` This property holds whether slider tracking is enabled.
`void` | `setValue(int arg__1)` This property holds the slider's current value.
`int` | `singleStep()` This property holds the single step.
`protected void` | `sliderChange(QAbstractSlider.SliderChange change)` Reimplement this virtual function to track slider changes such as `SliderRangeChange` , `SliderOrientationChange` , `SliderStepsChange` , or `SliderValueChange` .
`int` | `sliderPosition()` This property holds the current slider position.
`void` | `triggerAction(QAbstractSlider.SliderAction action)` Triggers a slider `action`.
`int` | `value()` This property holds the slider's current value.

Methods inherited from class com.trolltech.qt.gui.QWidget
`acceptDrops, accessibleDescription, accessibleName, actionEvent, actions, activateWindow, addAction, addActions, adjustSize, autoFillBackground, backgroundRole, baseSize, changeEvent, childAt, childAt, childrenRect, childrenRegion, clearFocus, clearMask, close, closeEvent, contentsRect, contextMenuEvent, contextMenuPolicy, cursor, depth, destroy, destroy, destroy, dragEnterEvent, dragLeaveEvent, dragMoveEvent, dropEvent, effectiveWinId, ensurePolished, enterEvent, focusInEvent, focusNextChild, focusNextPrevChild, focusOutEvent, focusPolicy, focusPreviousChild, focusProxy, focusWidget, font, fontInfo, fontMetrics, foregroundRole, frameGeometry, frameSize, geometry, getContentsMargins, grabKeyboard, grabMouse, grabMouse, grabShortcut, grabShortcut, hasFocus, hasMouseTracking, height, heightForWidth, heightMM, hide, hideEvent, inputContext, inputMethodEvent, inputMethodQuery, insertAction, insertActions, isActiveWindow, isAncestorOf, isEnabled, isEnabledTo, isFullScreen, isHidden, isMaximized, isMinimized, isModal, isVisible, isVisibleTo, isWindow, isWindowModified, keyboardGrabber, keyPressEvent, keyReleaseEvent, languageChange, layout, layoutDirection, leaveEvent, locale, logicalDpiX, logicalDpiY, lower, mapFrom, mapFromGlobal, mapFromParent, mapTo, mapToGlobal, mapToParent, mask, maximumHeight, maximumSize, maximumWidth, metric, minimumHeight, minimumSize, minimumSizeHint, minimumWidth, mouseDoubleClickEvent, mouseGrabber, mouseMoveEvent, mousePressEvent, mouseReleaseEvent, move, move, moveEvent, nativeParentWidget, nextInFocusChain, normalGeometry, numColors, overrideWindowFlags, overrideWindowFlags, paintEngine, paintEvent, paintingActive, palette, parentWidget, physicalDpiX, physicalDpiY, pos, raise, rect, releaseKeyboard, releaseMouse, releaseShortcut, removeAction, render, render, render, render, render, render, render, render, render, repaint, repaint, repaint, repaint, resetInputContext, resize, resize, resizeEvent, restoreGeometry, saveGeometry, scroll, scroll, setAcceptDrops, setAccessibleDescription, setAccessibleName, setAttribute, setAttribute, setAutoFillBackground, setBackgroundRole, setBaseSize, setBaseSize, setContentsMargins, setContentsMargins, setContextMenuPolicy, setCursor, setDisabled, setEnabled, setFixedHeight, setFixedSize, setFixedSize, setFixedWidth, setFocus, setFocus, setFocusPolicy, setFocusProxy, setFont, setForegroundRole, setGeometry, setGeometry, setHidden, setInputContext, setLayout, setLayoutDirection, setLocale, setMask, setMask, setMaximumHeight, setMaximumSize, setMaximumSize, setMaximumWidth, setMinimumHeight, setMinimumSize, setMinimumSize, setMinimumWidth, setMouseTracking, setPalette, setParent, setParent, setParent, setShortcutAutoRepeat, setShortcutAutoRepeat, setShortcutEnabled, setShortcutEnabled, setSizeIncrement, setSizeIncrement, setSizePolicy, setSizePolicy, setStatusTip, setStyle, setStyleSheet, setTabOrder, setToolTip, setUpdatesEnabled, setVisible, setWhatsThis, setWindowFilePath, setWindowFlags, setWindowFlags, setWindowIcon, setWindowIconText, setWindowModality, setWindowModified, setWindowOpacity, setWindowRole, setWindowState, setWindowState, setWindowTitle, show, showEvent, showFullScreen, showMaximized, showMinimized, showNormal, size, sizeHint, sizeIncrement, sizePolicy, stackUnder, statusTip, style, styleSheet, tabletEvent, testAttribute, toolTip, underMouse, unsetCursor, unsetLayoutDirection, unsetLocale, update, update, update, update, updateGeometry, updateMicroFocus, updatesEnabled, visibleRegion, whatsThis, wheelEvent, width, widthMM, window, windowFilePath, windowFlags, windowIcon, windowIconText, windowModality, windowOpacity, windowRole, windowState, windowTitle, windowType, winId, x, y`

Methods inherited from class com.trolltech.qt.core.QObject
`childEvent, children, connectSlotsByName, customEvent, disposeLater, dumpObjectInfo, dumpObjectTree, dynamicPropertyNames, event, eventFilter, findChild, findChild, findChild, findChildren, findChildren, findChildren, findChildren, indexOfProperty, installEventFilter, isWidgetType, killTimer, moveToThread, objectName, parent, properties, property, removeEventFilter, setObjectName, setParent, setProperty, startTimer, timerEvent, toString, userProperty`

Methods inherited from class com.trolltech.qt.QtJambiObject
`dispose, disposed, equals, finalize, reassignNativeResources, tr, tr, tr`

Methods inherited from class com.trolltech.qt.QSignalEmitter
`blockSignals, disconnect, disconnect, signalsBlocked, signalSender, thread`

Methods inherited from class java.lang.Object
`clone, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Methods inherited from interface com.trolltech.qt.QtJambiInterface
`disableGarbageCollection, nativeId, nativePointer, reenableGarbageCollection, setJavaOwnership`

Field Detail

### actionTriggered

    public final QSignalEmitter.Signal1 actionTriggered

  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:
  `triggerAction()`.

### rangeChanged

    public final QSignalEmitter.Signal2 rangeChanged

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

See also:
  `minimum`, and `maximum`.

### sliderMoved

    public final QSignalEmitter.Signal1 sliderMoved

  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:
  `setTracking()`, `valueChanged()` , `isSliderDown()`, `sliderPressed()` , and `sliderReleased()` .

### sliderPressed

    public final QSignalEmitter.Signal0 sliderPressed

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

See also:
  `sliderReleased()` , `sliderMoved()` , and `isSliderDown()`.

### sliderReleased

    public final QSignalEmitter.Signal0 sliderReleased

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

See also:
  `sliderPressed()` , `sliderMoved()` , and `sliderDown`.

### valueChanged

    public final QSignalEmitter.Signal1 valueChanged

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

Constructor Detail

### QAbstractSlider

    public QAbstractSlider()

  Constructs an abstract slider.

  The `parent` arguments 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.

### QAbstractSlider

    public QAbstractSlider(QWidget parent)

  Constructs an abstract slider.

  The `parent` arguments 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.

Method Detail

### hasTracking

    public final boolean hasTracking()

  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.

See also:
  `sliderDown`.

### invertedAppearance

    public final boolean invertedAppearance()

  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.

### invertedControls

    public final boolean invertedControls()

  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.

### isSliderDown

    public final boolean isSliderDown()

  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.

### maximum

    public final int maximum()

  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.

### minimum

    public final int minimum()

  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.

### orientation

    public final Qt.Orientation orientation()

  This property holds the orientation of the slider. The orientation must be `Qt::Vertical` (the default) or `Qt::Horizontal` .

### pageStep

    public final int pageStep()

  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`.

See also:
  `singleStep`.

### repeatAction

    protected final QAbstractSlider.SliderAction repeatAction()

  Returns the current repeat action.

See also:
  `setRepeatAction()`.

### setInvertedAppearance

    public final void setInvertedAppearance(boolean arg__1)

  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.

### setInvertedControls

    public final void setInvertedControls(boolean arg__1)

  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.

### setMaximum

    public final void setMaximum(int arg__1)

  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.

### setMinimum

    public final void setMinimum(int arg__1)

  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.

### setOrientation

    public final void setOrientation(Qt.Orientation arg__1)

  This property holds the orientation of the slider. The orientation must be `Qt::Vertical` (the default) or `Qt::Horizontal` .

### setPageStep

    public final void setPageStep(int arg__1)

  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`.

See also:
  `singleStep`.

### setRange

    public final void setRange(int min,
                               int max)

  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:
  `minimum`, and `maximum`.

### setRepeatAction

    protected final void setRepeatAction(QAbstractSlider.SliderAction action,
                                         int thresholdTime)

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

See also:
  `triggerAction()`, and `repeatAction()`.

### setRepeatAction

    protected final void setRepeatAction(QAbstractSlider.SliderAction action)

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

See also:
  `triggerAction()`, and `repeatAction()`.

### setRepeatAction

    protected final void setRepeatAction(QAbstractSlider.SliderAction action,
                                         int thresholdTime,
                                         int repeatTime)

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

See also:
  `triggerAction()`, and `repeatAction()`.

### setSingleStep

    public final void setSingleStep(int arg__1)

  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.

See also:
  `pageStep`.

### setSliderDown

    public final void setSliderDown(boolean arg__1)

  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.

### setSliderPosition

    public final void setSliderPosition(int arg__1)

  This property holds the current slider position. If `tracking` is enabled (the default), this is identical to `value`.

### setTracking

    public final void setTracking(boolean enable)

  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.

See also:
  `sliderDown`.

### setValue

    public final void setValue(int arg__1)

  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`.

### singleStep

    public final int singleStep()

  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.

See also:
  `pageStep`.

### sliderPosition

    public final int sliderPosition()

  This property holds the current slider position. If `tracking` is enabled (the default), this is identical to `value`.

### triggerAction

    public final void triggerAction(QAbstractSlider.SliderAction action)

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

See also:
  `actionTriggered()` .

### value

    public final int value()

  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`.

### sliderChange

    protected void sliderChange(QAbstractSlider.SliderChange change)

  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.

### fromNativePointer

    public static QAbstractSlider fromNativePointer(QNativePointer nativePointer)

  This method returns the QAbstractSlider instance pointed to by `nativePointer`.

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD