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)

Crée une fenêtre d'affichage.

L'argument « parent » est transmis au constructeur « QWidget ».

[virtual noexcept] QAbstractScrollArea::~QAbstractScrollArea()

Supprime la fenêtre d'affichage.

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

Ajoute un widget de barre de défilement de type « widget » à l'emplacement spécifié par « alignment ».

Les widgets de barre de défilement s'affichent à côté de la barre de défilement horizontale ou verticale, et peuvent être placés de chaque côté de celle-ci. Si vous souhaitez que les widgets de barre de défilement soient toujours visibles, définissez la propriété `scrollBarPolicy` de la barre de défilement correspondante sur ` AlwaysOn`.

alignment La valeur doit être l’une des suivantes : Qt::Alignleft et Qt::AlignRight, qui correspondent à la barre de défilement horizontale, ou Qt::AlignTop et Qt::AlignBottom, qui correspondent à la barre de défilement verticale.

Un widget de barre de défilement peut être supprimé soit en modifiant son parent, soit en le supprimant. Il est également possible de masquer un widget à l’aide de ` QWidget::hide()`

Le widget de barre de défilement sera redimensionné pour s’adapter à la géométrie de la barre de défilement du style actuel. Ce qui suit décrit le cas des widgets de barre de défilement sur la barre de défilement horizontale :

La hauteur du widget sera définie pour correspondre à celle 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 définissez la largeur sur cette valeur.

Voir également scrollBarWidgets().

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

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

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

Voir également 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 de coin n'est présent.

Voir aussi setCornerWidget().

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

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

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

Voir également QWidget::dragEnterEvent().

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

Réimplémentation de : 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 via event), pour le widget viewport().

Voir également QWidget::dragLeaveEvent().

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

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

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

Voir également QWidget::dragMoveEvent().

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

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

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe afin de recevoir les événements de dépôt (transmis via 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 du widget QAbstractScrollArea (etnon de la zone de défilement viewport()). L'event spécifié est un objet d'événement générique qui peut nécessiter un transtypage vers la classe appropriée en fonction de son type.

Voir également QEvent::type().

QScrollBar *QAbstractScrollArea::horizontalScrollBar() const

Affiche la barre de défilement horizontale.

Voir également 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'e d'événement de touche lorsqu'une touche est enfoncée. Elle gère les touches Page précédente, Page suivante, Haut, Bas, Gauche et Droite, et ignore toutes les autres touches.

QSize QAbstractScrollArea::maximumViewportSize() const

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

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

Réimplémente une fonction d'accès pour 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 afin de recevoir les événements de double-clic de la souris pour le widget viewport(). L'événement est transmis dans 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 afin de recevoir les événements de déplacement de la souris pour le widget viewport(). L’événement est transmis dans 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 afin de recevoir les événements de clic de souris pour le widget viewport(). L'événement est transmis dans 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 afin de recevoir les événements de relâchement de la souris pour le widget viewport(). L'événement est transmis via 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 afin de recevoir les événements de dessin (transmis via ` event`), pour le widget ` viewport()`.

Voir également QWidget::paintEvent().

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

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

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

Lorsque resizeEvent() est appelé, la fenêtre d'affichage possède 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. La valeur de ` alignment ` peut correspondre à n'importe quelle combinaison des quatre indicateurs d'emplacement.

Voir également 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 les méthodes ` dx` et ` dy` ; le contenu de la fenêtre d'affichage doit alors être mis à jour 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 dans le cas de ` QScrollArea ` — pour déplacer un widget de contenu. Les paramètres ` dx ` et ` dy ` sont fournis à titre pratique, afin que la classe sache de combien il faut faire défiler le contenu (ce qui est utile, par exemple, lors de décalages en pixels). Vous pouvez tout aussi bien ignorer ces valeurs et faire défiler directement jusqu’à la position indiquée par les barres de défilement.

Appeler cette fonction pour effectuer un défilement par programmation constitue 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 situé dans le coin entre les deux barres de défilement sur « widget ».

Vous souhaiterez probablement aussi définir au moins l'un des modes de barre de défilement sur « AlwaysOn ».

Si vous passez la valeur « nullptr », aucun widget n'apparaîtra dans le coin.

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

Vous pouvez appeler setCornerWidget() avec le même widget à différents moments.

Tous les widgets définis ici seront supprimés par la zone de défilement lors de sa destruction, à moins que vous ne redéfinissiez séparément le parent du 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 attribue toutes les propriétés du curseur de l'ancienne barre de défilement à la nouvelle barre de défilement. L'ancienne barre de défilement est ensuite supprimée.

QAbstractScrollArea fournit déjà par défaut des barres de défilement horizontales et verticales. 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 attribue toutes les propriétés du curseur de l'ancienne barre de défilement à la nouvelle barre de défilement. L'ancienne barre de défilement est ensuite supprimée.

QAbstractScrollArea fournit déjà par défaut des barres de défilement verticales et horizontales. 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 d'affichage sur l'widget spécifiée. L'QAbstractScrollArea prendra possession de l'widget spécifiée.

Si widget correspond à nullptr, QAbstractScrollArea attribuera une nouvelle instance de QWidget à la fenêtre d’affichage.

Voir également viewport().

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

Définit l'margins e autour de la zone de défilement. Cette fonctionnalité est utile pour des applications telles que les tableurs comportant des lignes et des colonnes « verrouillées ». L'espace marginal est laissé vide ; placez les widgets dans la zone inutilisée.

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

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 sur left, top, right et bottom. Cette fonctionnalité est utile pour des applications telles que les tableurs comportant des lignes et des colonnes « verrouillées ». L'espace marginal reste vide ; vous pouvez y placer des widgets.

Notez que cette fonction est fréquemment appelée par QTreeView et QTableView; les marges doivent donc être implémentées par les sous-classes de QAbstractScrollArea. De plus, 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 également viewportMargins().

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

Ce slot est appelé par QAbstractScrollArea après l'appel de setViewport(viewport). Réimplémentez cette fonction dans une sous-classe de QAbstractScrollArea afin d'initialiser le nouvel objet viewport avant son utilisation.

Voir également 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 à l'aide de ` viewportSizeHint()` et d'un espace supplémentaire pour les barres de défilement, si nécessaire.

QScrollBar *QAbstractScrollArea::verticalScrollBar() const

Affiche la barre de défilement verticale.

Voir également setVerticalScrollBar(), verticalScrollBarPolicy et horizontalScrollBar().

QWidget *QAbstractScrollArea::viewport() const

Renvoie le widget de la fenêtre d'affichage.

Utilisez la fonction QScrollArea::widget() pour récupérer le contenu du widget de la fenêtre d'affichage.

Voir également 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 l'event spécifiée et peut être appelé par des sous-classes afin de fournir un comportement par défaut approprié.

Renvoie true pour indiquer au système d’événements que l’événement a été géré et ne nécessite aucun traitement supplémentaire ; sinon, 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 plutôt d’utiliser l’un des gestionnaires d’événements spécialisés.

Les gestionnaires spécialisés pour les événements de la fenêtre d’affichage sont : 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 égales à zéro.

Voir aussi setViewportMargins().

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

Renvoie la taille recommandée pour la fenêtre d'affichage. L'implémentation par défaut renvoie viewport()->sizeHint(). Notez que cette taille correspond uniquement à celle de la fenêtre d'affichage, sans les 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 afin de recevoir les événements de molette pour le widget viewport(). L'événement est transmis dans e.

Voir également QWidget::wheelEvent().