Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Classes principales  ·  Annotées  ·  Classes groupées  ·  Fonctions  · 

QScrollBar Class Reference

The QScrollBar widget provides a vertical or horizontal scroll bar. More...

#include <qscrollbar.h>

Inherits QWidget and QRangeControl.

List of all member functions.

Public Members

Public Slots

Signals

Properties

  • bool draggingSlider - whether the user has clicked the mouse on the slider and is currently dragging it  (read only)
  • int lineStep - the line step
  • int maxValue - the scroll bar's maximum value
  • int minValue - the scroll bar's minimum value
  • Orientation orientation - the orientation of the scroll bar
  • int pageStep - the page step
  • bool tracking - whether scroll bar tracking is enabled
  • int value - the scroll bar's value

Protected Members


Detailed Description

The QScrollBar widget provides a vertical or horizontal scroll bar.

A scroll bar allows the user to control a value within a program-definable range and gives users a visible indication of the current value of a range control.

Scroll bars include four separate controls:

  • The line-up and line-down controls are little buttons which the user can use to move one "line" up or down. The meaning of line is configurable. In editors and list boxes it means one line of text; in an image viewer it might mean 20 pixels.

  • The slider is the handle that indicates the current value of the scroll bar, which the user can drag to change the value. This part of the scroll bar is sometimes called the "thumb".

  • The page-up/page-down control is the area on which the slider slides (the scroll bar's background). Clicking here moves the scroll bar towards the click. The meaning of "page" is also configurable: in editors and list boxes it means as many lines as there is space for in the widget.

QScrollBar has very few of its own functions; it mostly relies on QRangeControl. The most useful functions are setValue() to set the scroll bar directly to some value; addPage(), addLine(), subtractPage(), and subtractLine() to simulate the effects of clicking (useful for accelerator keys); setSteps() to define the values of pageStep() and lineStep(); and setRange() to set the minValue() and maxValue() of the scroll bar. QScrollBar has a convenience constructor with which you can set most of these properties.

Some GUI styles (for example, the Windows and Motif styles provided with Qt), also use the pageStep() value to calculate the size of the slider.

In addition to the access functions from QRangeControl, QScrollBar provides a comprehensive set of signals:

Signal Emitted when
valueChanged() the scroll bar's 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.
nextLine() the scroll bar has moved one line down or right. Line is defined in QRangeControl.
prevLine() the scroll bar has moved one line up or left.
nextPage() the scroll bar has moved one page down or right.
prevPage() the scroll bar has moved one page up or left.

QScrollBar only provides integer ranges. Note that although QScrollBar handles very large numbers, scroll bars on current screens cannot usefully control ranges above about 100,000 pixels. Beyond that, it becomes difficult for the user to control the scroll bar using either the keyboard or the mouse.

A scroll bar can be controlled by the keyboard, but it has a default focusPolicy() of NoFocus. Use setFocusPolicy() to enable keyboard focus. See keyPressEvent() for a list of key bindings.

If you need to add scroll bars to an interface, consider using the QScrollView class, which encapsulates the common uses for scroll bars.

See also QSlider, QSpinBox, QScrollView, GUI Design Handbook: Scroll Bar, and Basic Widgets.


Member Function Documentation

QScrollBar::QScrollBar ( QWidget * parent, const char * name = 0 )

Constructs a vertical scroll bar.

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

The minValue defaults to 0, the maxValue to 99, with a lineStep size of 1 and a pageStep size of 10, and an initial value of 0.

QScrollBar::QScrollBar ( Orientation orientation, QWidget * parent, const char * name = 0 )

Constructs a scroll bar.

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

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

The minValue defaults to 0, the maxValue to 99, with a lineStep size of 1 and a pageStep size of 10, and an initial value of 0.

QScrollBar::QScrollBar ( int minValue, int maxValue, int lineStep, int pageStep, int value, Orientation orientation, QWidget * parent, const char * name = 0 )

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

If orientation is Vertical the scroll bar is vertical and if it is Horizontal the scroll bar is horizontal.

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

QScrollBar::~QScrollBar ()

Destructor.

bool QScrollBar::draggingSlider () const

Returns TRUE if the user has clicked the mouse on the slider and is currently dragging it; otherwise returns FALSE. See the "draggingSlider" property for details.

void QScrollBar::hideEvent ( QHideEvent * ) [virtual protected]

This function is called when the scrollbar is hidden.

Reimplemented from QWidget.

int QScrollBar::lineStep () const

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

int QScrollBar::maxValue () const

Returns the scroll bar's maximum value. See the "maxValue" property for details.

int QScrollBar::minValue () const

Returns the scroll bar's minimum value. See the "minValue" property for details.

void QScrollBar::nextLine () [signal]

This signal is emitted when the scroll bar scrolls one line down or right.

void QScrollBar::nextPage () [signal]

This signal is emitted when the scroll bar scrolls one page down or right.

Orientation QScrollBar::orientation () const

Returns the orientation of the scroll bar. See the "orientation" property for details.

int QScrollBar::pageStep () const

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

void QScrollBar::prevLine () [signal]

This signal is emitted when the scroll bar scrolls one line up or left.

void QScrollBar::prevPage () [signal]

This signal is emitted when the scroll bar scrolls one page up or left.

void QScrollBar::setLineStep ( int )

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

void QScrollBar::setMaxValue ( int )

Sets the scroll bar's maximum value. See the "maxValue" property for details.

void QScrollBar::setMinValue ( int )

Sets the scroll bar's minimum value. See the "minValue" property for details.

void QScrollBar::setOrientation ( Orientation ) [virtual]

Sets the orientation of the scroll bar. See the "orientation" property for details.

void QScrollBar::setPageStep ( int )

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

void QScrollBar::setPalette ( const QPalette & p ) [virtual]

Reimplements the virtual function QWidget::setPalette().

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

Reimplemented from QWidget.

void QScrollBar::setTracking ( bool enable ) [virtual]

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

void QScrollBar::setValue ( int ) [slot]

Sets the scroll bar's value. See the "value" property for details.

void QScrollBar::sliderMoved ( int value ) [signal]

This signal is emitted when the slider is dragged by the user, with the new scroll bar value as an argument.

This signal is emitted even when tracking is turned off.

See also tracking, valueChanged(), nextLine(), prevLine(), nextPage(), and prevPage().

void QScrollBar::sliderPressed () [signal]

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

QRect QScrollBar::sliderRect () const

Returns the scroll bar slider rectangle.

See also sliderStart().

void QScrollBar::sliderReleased () [signal]

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

int QScrollBar::sliderStart () const

Returns the pixel position where the scroll bar slider starts.

This is equivalent to sliderRect().y() for vertical scroll bars or sliderRect().x() for horizontal scroll bars.

bool QScrollBar::tracking () const

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

int QScrollBar::value () const

Returns the scroll bar's value. See the "value" property for details.

void QScrollBar::valueChanged ( int value ) [signal]

This signal is emitted when the scroll bar value has changed, with the new scroll bar value as an argument.


Property Documentation

bool draggingSlider

This property holds whether the user has clicked the mouse on the slider and is currently dragging it.

Get this property's value with draggingSlider().

int lineStep

This property holds the 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(), QRangeControl::pageStep(), and setRange().

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

int maxValue

This property holds the scroll bar's maximum value.

When setting this property, the QScrollBar::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 scroll bar's minimum value.

When setting this property, the QScrollBar::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 orientation of the scroll bar.

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

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

int pageStep

This property holds the 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 QRangeControl::setSteps(), lineStep, and setRange().

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

bool tracking

This property holds whether scroll bar tracking is enabled.

If tracking is enabled (the default), the scroll bar emits the valueChanged() signal while the slider is being dragged. If tracking is disabled, the scroll bar emits the valueChanged() signal only when the user releases the mouse button after moving the slider.

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

int value

This property holds the scroll bar's value.

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

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


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

Publicité

Best Of

Actualités les plus lues

Semaine
Mois
Année
  1. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 82
  2. Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
  3. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  4. BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
  5. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
  6. Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
  7. 2017 : un quinquennat pour une nouvelle version du C++ ? Possible, selon Herb Sutter 6
Page suivante

Le Qt Quarterly au hasard

Logo

Qt s'associe avec le nouvel OS MeeGo

Qt Quarterly est la revue trimestrielle proposée par Nokia et à destination des développeurs Qt. Ces articles d'une grande qualité technique sont rédigés par des experts Qt. Lire l'article.

Communauté

Ressources

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 3.2
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 !
 
 
 
 
Partenaires

Hébergement Web