|
|
              
QAbstractSlider Class Reference |
| enum | SliderAction { SliderNoAction, SliderSingleStepAdd, SliderSingleStepSub, SliderPageStepAdd, ..., SliderMove } |
Properties
|
|
Public Functions
| QAbstractSlider ( QWidget * parent = 0 ) | |
| ~QAbstractSlider () | |
| bool | hasTracking () const |
| bool | invertedAppearance () const |
| bool | invertedControls () const |
| bool | isSliderDown () const |
| int | maximum () const |
| int | minimum () const |
| Qt::Orientation | orientation () const |
| int | pageStep () const |
| void | setInvertedAppearance ( bool ) |
| void | setInvertedControls ( bool ) |
| void | setMaximum ( int ) |
| void | setMinimum ( int ) |
| void | setPageStep ( int ) |
| void | setRange ( int min, int max ) |
| void | setSingleStep ( int ) |
| void | setSliderDown ( bool ) |
| void | setSliderPosition ( int ) |
| void | setTracking ( bool enable ) |
| int | singleStep () const |
| int | sliderPosition () const |
| void | triggerAction ( SliderAction action ) |
| int | value () const |
- 217 public functions inherited from QWidget
- 29 public functions inherited from QObject
- 13 public functions inherited from QPaintDevice
Public Slots
| void | setOrientation ( Qt::Orientation ) |
| void | setValue ( int ) |
Signals
| void | actionTriggered ( int action ) |
| void | rangeChanged ( int min, int max ) |
| void | sliderMoved ( int value ) |
| void | sliderPressed () |
| void | sliderReleased () |
| void | valueChanged ( int value ) |
Protected Types
| enum | SliderChange { SliderRangeChange, SliderOrientationChange, SliderStepsChange, SliderValueChange } |
Protected Functions
| SliderAction | repeatAction () const |
| void | setRepeatAction ( SliderAction action, int thresholdTime = 500, int repeatTime = 50 ) |
| virtual void | sliderChange ( SliderChange change ) |
Reimplemented Protected Functions
| virtual void | changeEvent ( QEvent * ev ) |
| virtual bool | event ( QEvent * e ) |
| virtual void | keyPressEvent ( QKeyEvent * ev ) |
| virtual void | timerEvent ( QTimerEvent * e ) |
| virtual void | wheelEvent ( QWheelEvent * e ) |
- 37 protected functions inherited from QWidget
- 7 protected functions inherited from QObject
- 1 protected function inherited from QPaintDevice
Additional Inherited Members
- 4 static public members inherited from QWidget
- 5 static public members inherited from QObject
- 1 protected slot inherited from QWidget
Detailed Description
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:
- value: The bounded integer that QAbstractSlider maintains.
- minimum: The lowest possible value.
- maximum: The highest possible value.
- singleStep: The smaller of two natural steps that an abstract sliders provides and typically corresponds to the user pressing an arrow key.
- pageStep: The larger of two natural steps that an abstract slider provides and typically corresponds to the user pressing PageUp or PageDown.
- tracking: Whether slider tracking is enabled.
- 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.
Member Type Documentation
enum QAbstractSlider::SliderAction
| Constant | Value |
|---|---|
| QAbstractSlider::SliderNoAction | 0 |
| QAbstractSlider::SliderSingleStepAdd | 1 |
| QAbstractSlider::SliderSingleStepSub | 2 |
| QAbstractSlider::SliderPageStepAdd | 3 |
| QAbstractSlider::SliderPageStepSub | 4 |
| QAbstractSlider::SliderToMinimum | 5 |
| QAbstractSlider::SliderToMaximum | 6 |
| QAbstractSlider::SliderMove | 7 |
enum QAbstractSlider::SliderChange
| Constant | Value |
|---|---|
| QAbstractSlider::SliderRangeChange | 0 |
| QAbstractSlider::SliderOrientationChange | 1 |
| QAbstractSlider::SliderStepsChange | 2 |
| QAbstractSlider::SliderValueChange | 3 |
Property Documentation
invertedAppearance : bool
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.
Access functions:
| bool | invertedAppearance () const |
| void | setInvertedAppearance ( bool ) |
invertedControls : bool
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.
Access functions:
| bool | invertedControls () const |
| void | setInvertedControls ( bool ) |
maximum : int
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.
Access functions:
| int | maximum () const |
| void | setMaximum ( int ) |
minimum : int
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.
Access functions:
| int | minimum () const |
| void | setMinimum ( int ) |
orientation : Qt::Orientation
This property holds the orientation of the slider.
The orientation must be Qt::Vertical (the default) or Qt::Horizontal.
Access functions:
| Qt::Orientation | orientation () const |
| void | setOrientation ( Qt::Orientation ) |
pageStep : int
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.
Access functions:
| int | pageStep () const |
| void | setPageStep ( int ) |
See also singleStep.
singleStep : int
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.
If the property is modified during an auto repeating key event, behavior is undefined.
Access functions:
| int | singleStep () const |
| void | setSingleStep ( int ) |
See also pageStep.
sliderDown : bool
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.
Access functions:
| bool | isSliderDown () const |
| void | setSliderDown ( bool ) |
sliderPosition : int
This property holds the current slider position.
If tracking is enabled (the default), this is identical to value.
Access functions:
| int | sliderPosition () const |
| void | setSliderPosition ( int ) |
Notifier signal:
| void | sliderMoved ( int value ) |
tracking : bool
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.
Access functions:
| bool | hasTracking () const |
| void | setTracking ( bool enable ) |
See also sliderDown.
value : int
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.
Access functions:
| int | value () const |
| void | setValue ( int ) |
Notifier signal:
| void | valueChanged ( int value ) |
Member Function Documentation
QAbstractSlider::QAbstractSlider ( QWidget * parent = 0 )
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::~QAbstractSlider ()
Destroys the slider.
void QAbstractSlider::actionTriggered ( int action ) [signal]
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().
void QAbstractSlider::changeEvent ( QEvent * ev ) [virtual protected]
Reimplemented from QWidget::changeEvent().
bool QAbstractSlider::event ( QEvent * e ) [virtual protected]
Reimplemented from QObject::event().
void QAbstractSlider::keyPressEvent ( QKeyEvent * ev ) [virtual protected]
Reimplemented from QWidget::keyPressEvent().
void QAbstractSlider::rangeChanged ( int min, int max ) [signal]
This signal is emitted when the slider range has changed, with min being the new minimum, and max being the new maximum.
SliderAction QAbstractSlider::repeatAction () const [protected]
Returns the current repeat action.
See also setRepeatAction().
void QAbstractSlider::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.
void QAbstractSlider::setRepeatAction ( SliderAction action, int thresholdTime = 500, int repeatTime = 50 ) [protected]
Sets action action to be triggered repetitively in intervals of repeatTime, after an initial delay of thresholdTime.
See also triggerAction() and repeatAction().
void QAbstractSlider::sliderChange ( SliderChange change ) [virtual protected]
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.
void QAbstractSlider::sliderMoved ( int value ) [signal]
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().
void QAbstractSlider::sliderPressed () [signal]
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().
void QAbstractSlider::sliderReleased () [signal]
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.
void QAbstractSlider::timerEvent ( QTimerEvent * e ) [virtual protected]
Reimplemented from QObject::timerEvent().
void QAbstractSlider::triggerAction ( SliderAction action )
Triggers a slider action. Possible actions are SliderSingleStepAdd, SliderSingleStepSub, SliderPageStepAdd, SliderPageStepSub, SliderToMinimum, SliderToMaximum, and SliderMove.
See also actionTriggered().
void QAbstractSlider::valueChanged ( int value ) [signal]
This signal is emitted when the slider value has changed, with the new slider value as argument.
void QAbstractSlider::wheelEvent ( QWheelEvent * e ) [virtual protected]
Reimplemented from QWidget::wheelEvent().
|
|
Best Of
Actualités les plus lues
- «Le projet de loi des droits du développeur» : quelles conditions doivent remplir les entreprises pour que le développeur puisse réussir ? 92
- Thread travailleur avec Qt en utilisant les signaux et les slots, un article de Christophe Dumez traduit par Thibaut Cuvelier 1
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 103
- Pourquoi les programmeurs sont-ils moins payés que les gestionnaires de programmes ? Manquent-ils de pouvoir de négociation ? 56
- «Le projet de loi des droits du développeur» : quelles conditions doivent remplir les entreprises pour que le développeur puisse réussir ? 90
- Les développeurs détestent-ils les antivirus ? Un programmeur manifeste sa haine envers ces solutions de sécurité 31
- Qt Commercial : Digia organise un webinar gratuit le 27 mars sur la conception d'interfaces utilisateur et d'applications avec le framework 0
- Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
- 2017 : un quinquennat pour une nouvelle version du C++ ? Possible, selon Herb Sutter 11
- Linus Torvalds : le "C++ est un langage horrible", en justifiant le choix du C pour le système de gestion de version Git 100
- Comment prendre en compte l'utilisateur dans vos applications ? Pour un développeur, « 90 % des utilisateurs sont des idiots » 231
- Quel est LE livre que tout développeur doit lire absolument ? Celui qui vous a le plus marqué et inspiré 96
- Apple cède et s'engage à payer des droits à Nokia, le conflit des brevets entre les deux firmes s'achève 158
- Nokia porte à nouveau plainte contre Apple pour violation de sept nouveaux brevets 158
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 103
- Quel est le code dont vous êtes le plus fier ? Pourquoi l'avez-vous écrit ? Et pourquoi vous a-t-il donné autant de satisfaction ? 83
Le Qt Developer Network au hasard
Comment fermer une application
Communauté
Ressources
- 91 cours et tutoriels Qt
- F.A.Q. Qt : 200 questions et réponses
- 51 Qt Quarterly, 35 Qt Labs et 22 Qt DevNet en français
- 43 outils Qt
- 99 sources Qt et 26 binaires Qt
- 6 livres Qt et 9 critiques
- La documentation de Qt 4.7 en français : 157 classes, 70 concepts et 24 modules
- 3 certifications Qt
Liens utiles
Contact
- Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).
Qt dans le magazine
| Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. | Qt 4.6-snapshot | |
| Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD. | ||
| Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP ! | ||
Copyright © 2000-2012 - www.developpez.com