QAbstractScrollArea Class

QSize areaSize = viewport()->size();
QSize  widgetSize = widget->size();

verticalScrollBar()->setPageStep(areaSize.height());
horizontalScrollBar()->setPageStep(areaSize.width());
verticalScrollBar()->setRange(0, widgetSize.height() - areaSize.height());
horizontalScrollBar()->setRange(0, widgetSize.width() - areaSize.width());
updateWidgetPosition();

int hvalue = horizontalScrollBar()->value();
int vvalue = verticalScrollBar()->value();
QPoint topLeft = viewport()->rect().topLeft();

widget->move(topLeft.x() - hvalue, topLeft.y() - vvalue);

Documentation des fonctions membres

[explicit] QAbstractScrollArea::QAbstractScrollArea(QWidget *parent = nullptr)

Construit une fenêtre de visualisation.

L'argument parent est envoyé au constructeur QWidget.

[virtual noexcept] QAbstractScrollArea::~QAbstractScrollArea()

Détruit la fenêtre de visualisation.

void QAbstractScrollArea::addScrollBarWidget(QWidget *widget, Qt::Alignment alignment)

Ajoute widget comme widget de barre de défilement à l'emplacement spécifié par alignment.

Les widgets de barre de défilement sont affichés à côté de la barre de défilement horizontale ou verticale et peuvent être placés de part et d'autre de celle-ci. Si vous souhaitez que les widgets de la barre de défilement soient toujours visibles, attribuez la valeur AlwaysOn à la politique de défilement de la barre de défilement correspondante.

alignment doit être l'un de Qt::Alignleft et Qt::AlignRight, qui correspond à la barre de défilement horizontale, ou Qt::AlignTop et Qt::AlignBottom, qui correspond à la barre de défilement verticale.

Un widget de barre de défilement peut être supprimé en lui donnant un nouveau parent ou en le supprimant. Il est également possible de cacher un widget à l'aide de QWidget::hide()

Le widget de la barre de défilement sera redimensionné pour s'adapter à la géométrie de la barre de défilement pour le style actuel. Les paragraphes suivants décrivent le cas des widgets de barre de défilement sur la barre de défilement horizontale :

La hauteur du widget sera réglée pour correspondre à la hauteur de la barre de défilement. Pour contrôler la largeur du widget, utilisez QWidget::setMinimumWidth et QWidget::setMaximumWidth, ou implémentez QWidget::sizeHint() et définissez une politique de taille horizontale. Si vous souhaitez un widget carré, appelez QStyle::pixelMetric(QStyle::PM_ScrollBarExtent) et fixez la largeur à cette valeur.

Voir aussi scrollBarWidgets().

[override virtual protected] void QAbstractScrollArea::contextMenuEvent(QContextMenuEvent *e)

Réimplémente : QWidget::contextMenuEvent(QContextMenuEvent *event).

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements du menu contextuel pour le widget viewport(). L'événement est transmis à e.

Voir aussi QWidget::contextMenuEvent().

QWidget *QAbstractScrollArea::cornerWidget() const

Renvoie le widget situé dans le coin entre les deux barres de défilement.

Par défaut, aucun widget d'angle n'est présent.

Voir aussi setCornerWidget().

[override virtual protected] void QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event)

Réimplémente : QWidget::dragEnterEvent(QDragEnterEvent *event).

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe afin de recevoir les événements d'entrée par glissement (transmis dans event), pour le widget viewport().

Voir également QWidget::dragEnterEvent().

[override virtual protected] void QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event)

Réimplémente : QWidget::dragLeaveEvent(QDragLeaveEvent *event).

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe afin de recevoir les événements de sortie de glissement (transmis dans event), pour le widget viewport().

Voir également QWidget::dragLeaveEvent().

[override virtual protected] void QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event)

Réimplémente : QWidget::dragMoveEvent(QDragMoveEvent *event).

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de déplacement par glissement (transmis dans event), pour le widget viewport().

Voir également QWidget::dragMoveEvent().

[override virtual protected] void QAbstractScrollArea::dropEvent(QDropEvent *event)

Réimplémente : QWidget::dropEvent(QDropEvent *event).

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de chute (transmis dans event), pour le widget viewport().

Voir également QWidget::dropEvent().

[override virtual protected] bool QAbstractScrollArea::event(QEvent *event)

Réimplémente : QFrame::event(QEvent *e).

Il s'agit du gestionnaire d'événements principal pour le widget QAbstractScrollArea (et non pour la zone de défilement viewport()). L'objet event spécifié est un objet d'événement général qui peut nécessiter un cast dans la classe appropriée en fonction de son type.

Voir aussi QEvent::type().

QScrollBar *QAbstractScrollArea::horizontalScrollBar() const

Renvoie la barre de défilement horizontale.

Voir aussi setHorizontalScrollBar(), horizontalScrollBarPolicy, et verticalScrollBar().

[override virtual protected] void QAbstractScrollArea::keyPressEvent(QKeyEvent *e)

Réimplémente : QWidget::keyPressEvent(QKeyEvent *event).

Cette fonction est appelée avec l'événement e lorsqu'une touche est enfoncée. Elle gère les touches PageUp, PageDown, Haut, Bas, Gauche et Droite, et ignore toutes les autres touches.

QSize QAbstractScrollArea::maximumViewportSize() const

Renvoie la taille de la fenêtre comme si les barres de défilement n'avaient pas de plage de défilement valide.

[override virtual] QSize QAbstractScrollArea::minimumSizeHint() const

Réimplémente une fonction d'accès à la propriété : QWidget::minimumSizeHint.

[override virtual protected] void QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e)

Réimplémente : QWidget::mouseDoubleClickEvent(QMouseEvent *event).

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de double clic de la souris pour le widget viewport(). L'événement est transmis à e.

Voir également QWidget::mouseDoubleClickEvent().

[override virtual protected] void QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e)

Réimplémente : QWidget::mouseMoveEvent(QMouseEvent *event).

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de déplacement de la souris pour le widget viewport(). L'événement est transmis à e.

Voir également QWidget::mouseMoveEvent().

[override virtual protected] void QAbstractScrollArea::mousePressEvent(QMouseEvent *e)

Réimplémente : QWidget::mousePressEvent(QMouseEvent *event).

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de pression de la souris pour le widget viewport(). L'événement est transmis à e.

L'implémentation par défaut appelle QWidget::mousePressEvent() pour la gestion par défaut des fenêtres contextuelles.

Voir également QWidget::mousePressEvent().

[override virtual protected] void QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e)

Réimplémente : QWidget::mouseReleaseEvent(QMouseEvent *event).

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de relâchement de la souris pour le widget viewport(). L'événement est transmis à e.

Voir également QWidget::mouseReleaseEvent().

[override virtual protected] void QAbstractScrollArea::paintEvent(QPaintEvent *event)

Réimplémente : QFrame::paintEvent(QPaintEvent *).

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de peinture (transmis dans event), pour le widget viewport().

Voir également QWidget::paintEvent().

[override virtual protected] void QAbstractScrollArea::resizeEvent(QResizeEvent *event)

Réimplémente : QWidget::resizeEvent(QResizeEvent *event).

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir des événements de redimensionnement (transmis à event), pour le widget viewport().

Lorsque resizeEvent() est appelé, la fenêtre de visualisation a déjà sa nouvelle géométrie : Sa nouvelle taille est accessible via la fonction QResizeEvent::size(), et l'ancienne taille via QResizeEvent::oldSize().

Voir également QWidget::resizeEvent().

QWidgetList QAbstractScrollArea::scrollBarWidgets(Qt::Alignment alignment)

Renvoie une liste des widgets de barre de défilement actuellement définis. alignment peut être n'importe quelle combinaison des quatre drapeaux d'emplacement.

Voir aussi addScrollBarWidget().

[virtual protected] void QAbstractScrollArea::scrollContentsBy(int dx, int dy)

Ce gestionnaire virtuel est appelé lorsque les barres de défilement sont déplacées par dx, dy, et que le contenu de la fenêtre doit être défilé en conséquence.

L'implémentation par défaut appelle simplement update() sur l'ensemble de viewport(), les sous-classes peuvent réimplémenter ce gestionnaire à des fins d'optimisation, ou - comme QScrollArea - pour déplacer un widget de contenu. Les paramètres dx et dy sont là pour des raisons de commodité, afin que la classe sache de combien il faut faire défiler la page (utile, par exemple, en cas de décalage de pixels). Vous pouvez tout aussi bien ignorer ces valeurs et faire défiler le contenu directement jusqu'à la position indiquée par les barres de défilement.

L'appel à cette fonction pour faire défiler la page de manière programmatique est une erreur, utilisez plutôt les barres de défilement (par exemple en appelant directement QScrollBar::setValue()).

void QAbstractScrollArea::setCornerWidget(QWidget *widget)

Définit le widget dans le coin entre les deux barres de défilement comme étant widget.

Vous voudrez probablement aussi définir au moins l'un des modes de la barre de défilement sur AlwaysOn.

Si vous passez nullptr, aucun widget n'apparaît dans le coin.

Tout widget de coin précédent est caché.

Vous pouvez appeler setCornerWidget() avec le même widget à plusieurs reprises.

Tous les widgets définis ici seront supprimés par la zone de défilement lorsqu'elle sera détruite, à moins que vous ne répartissiez séparément le widget après avoir défini un autre widget de coin (ou nullptr).

Tout widget nouvellement défini ne doit pas avoir de parent actuel.

Par défaut, aucun widget de coin n'est présent.

Voir également cornerWidget() et horizontalScrollBarPolicy.

void QAbstractScrollArea::setHorizontalScrollBar(QScrollBar *scrollBar)

Remplace la barre de défilement horizontale existante par scrollBar, et définit toutes les propriétés du curseur de l'ancienne barre de défilement sur la nouvelle barre de défilement. L'ancienne barre de défilement est ensuite supprimée.

QAbstractScrollArea fournit déjà des barres de défilement horizontales et verticales par défaut. Vous pouvez appeler cette fonction pour remplacer la barre de défilement horizontale par défaut par votre propre barre de défilement personnalisée.

Voir également horizontalScrollBar() et setVerticalScrollBar().

void QAbstractScrollArea::setVerticalScrollBar(QScrollBar *scrollBar)

Remplace la barre de défilement verticale existante par scrollBar, et définit toutes les propriétés du curseur de l'ancienne barre de défilement sur la nouvelle barre de défilement. L'ancienne barre de défilement est ensuite supprimée.

QAbstractScrollArea fournit déjà des barres de défilement verticales et horizontales par défaut. Vous pouvez appeler cette fonction pour remplacer la barre de défilement verticale par défaut par votre propre barre de défilement personnalisée.

Voir également verticalScrollBar() et setHorizontalScrollBar().

void QAbstractScrollArea::setViewport(QWidget *widget)

Définit la fenêtre de visualisation comme étant la fenêtre donnée widget. L'instance QAbstractScrollArea devient propriétaire de l'instance widget.

Si widget est nullptr, QAbstractScrollArea attribuera une nouvelle instance QWidget pour la fenêtre de visualisation.

Voir aussi viewport().

[protected] void QAbstractScrollArea::setViewportMargins(const QMargins &margins)

Définit margins autour de la zone de défilement. Cette fonction est utile pour les applications telles que les feuilles de calcul dont les lignes et les colonnes sont "verrouillées". L'espace marginal est laissé vide ; les widgets peuvent être placés dans la zone inutilisée.

Par défaut, toutes les marges sont nulles.

Voir aussi viewportMargins().

[protected] void QAbstractScrollArea::setViewportMargins(int left, int top, int right, int bottom)

Définit les marges autour de la zone de défilement à left, top, right et bottom. Cette fonction est utile pour les applications telles que les feuilles de calcul dont les lignes et les colonnes sont "verrouillées". L'espace marginal est laissé vide ; placez des widgets dans la zone inutilisée.

Notez que cette fonction est fréquemment appelée par QTreeView et QTableView, de sorte que les marges doivent être implémentées par les sous-classes de QAbstractScrollArea. En outre, si les sous-classes doivent être utilisées dans des vues d'éléments, elles ne doivent pas appeler cette fonction.

Par défaut, toutes les marges sont égales à zéro.

Voir aussi viewportMargins().

[virtual] void QAbstractScrollArea::setupViewport(QWidget *viewport)

Ce slot est appelé par QAbstractScrollArea après que setViewport(viewport) a été appelé. Réimplémentez cette fonction dans une sous-classe de QAbstractScrollArea pour initialiser le nouveau viewport avant qu'il ne soit utilisé.

Voir aussi setViewport().

[override virtual] QSize QAbstractScrollArea::sizeHint() const

Réimplémente : QFrame::sizeHint() const.

Renvoie la propriété sizeHint de la zone de défilement. La taille est déterminée par l'utilisation de viewportSizeHint() plus un espace supplémentaire pour les barres de défilement, si nécessaire.

QScrollBar *QAbstractScrollArea::verticalScrollBar() const

Renvoie la barre de défilement verticale.

Voir aussi setVerticalScrollBar(), verticalScrollBarPolicy, et horizontalScrollBar().

QWidget *QAbstractScrollArea::viewport() const

Renvoie le widget viewport.

Utilisez la fonction QScrollArea::widget() pour récupérer le contenu du widget viewport.

Voir aussi setViewport() et QScrollArea::widget().

[virtual protected] bool QAbstractScrollArea::viewportEvent(QEvent *event)

Le gestionnaire d'événements principal pour la zone de défilement (le widget viewport()). Il gère le event spécifié et peut être appelé par des sous-classes pour fournir un comportement par défaut raisonnable.

Elle renvoie true pour indiquer au système d'événements que l'événement a été traité et ne nécessite pas d'autre traitement ; sinon, elle renvoie false pour indiquer que l'événement doit être propagé plus loin.

Vous pouvez réimplémenter cette fonction dans une sous-classe, mais nous vous recommandons d'utiliser plutôt l'un des gestionnaires d'événements spécialisés.

Les gestionnaires spécialisés pour les événements viewport sont les suivants : paintEvent(), mousePressEvent(), mouseReleaseEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), wheelEvent(), dragEnterEvent(), dragMoveEvent(), dragLeaveEvent(), dropEvent(), contextMenuEvent() et resizeEvent().

[protected] QMargins QAbstractScrollArea::viewportMargins() const

Renvoie les marges autour de la zone de défilement. Par défaut, toutes les marges sont nulles.

Voir aussi setViewportMargins().

[virtual protected] QSize QAbstractScrollArea::viewportSizeHint() const

Renvoie la taille recommandée pour la fenêtre de visualisation. L'implémentation par défaut renvoie viewport()->sizeHint(). Notez que la taille est simplement celle de la fenêtre d'affichage, sans barres de défilement visibles.

[override virtual protected] void QAbstractScrollArea::wheelEvent(QWheelEvent *e)

Réimplémente : QWidget::wheelEvent(QWheelEvent *event).

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de roue pour le widget viewport(). L'événement est transmis à e.

Voir également QWidget::wheelEvent().