Sur cette page

QPaintEvent Class

La classe QPaintEvent contient les paramètres relatifs aux événements de dessin. En savoir plus...

En-tête : #include <QPaintEvent>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui
Hérite de : QEvent

Fonctions publiques

QPaintEvent(const QRect &paintRect)
QPaintEvent(const QRegion &paintRegion)
const QRect &rect() const
const QRegion &region() const

Fonctions protégées

QPaintEvent(QPaintEvent &&)
QPaintEvent &operator=(QPaintEvent &&)
QPaintEvent &operator=(const QPaintEvent &other)

Description détaillée

Les événements Paint sont envoyés aux widgets qui doivent se mettre à jour, par exemple lorsqu’une partie d’un widget est exposée parce qu’un widget qui le recouvrait a été déplacé.

L'événement contient une région à mettre à jour ( region()) et un rectangle de délimitation de cette région ( rect()). Ces deux éléments sont fournis car de nombreux widgets ne peuvent pas tirer pleinement parti de la fonction region(), et la fonction rect() peut s'avérer bien plus rapide que region().boundingRect().

Découpage automatique

Le dessin est découpé selon region() lors du traitement d’un événement de dessin. Ce découpage est effectué par le système de dessin de Qt et est indépendant de tout découpage pouvant être appliqué à un QPainter utilisé pour dessiner sur le périphérique de dessin.

Par conséquent, la valeur renvoyée par QPainter::clipRegion() sur un QPainter nouvellement créé ne reflétera pas la région de découpage utilisée par le système de dessin.

Voir également QPainter, QWidget::update(), QWidget::repaint() et QWidget::paintEvent().

Documentation sur les fonctions membres

[explicit] QPaintEvent::QPaintEvent(const QRect &paintRect)

Crée un objet d'événement de dessin contenant le rectangle à mettre à jour. La zone est définie par paintRect.

[explicit] QPaintEvent::QPaintEvent(const QRegion &paintRegion)

Crée un objet d'événement de dessin contenant la région à mettre à jour. La région est spécifiée par paintRegion.

[protected delete] QPaintEvent::QPaintEvent(QPaintEvent &&)

Crée par « move » une instance de ` QPaintEvent`. Cette fonction est supprimée.

const QRect &QPaintEvent::rect() const

Renvoie le rectangle à mettre à jour.

Voir également region() et QPainter::setClipRect().

const QRegion &QPaintEvent::region() const

Renvoie la région à mettre à jour.

Voir également rect() et QPainter::setClipRegion().

[protected delete] QPaintEvent &QPaintEvent::operator=(QPaintEvent &&)

La fonction « Move-assigns » attribue « other » à cette instance de « QPaintEvent ». Cette fonction est supprimée.

[noexcept protected default] QPaintEvent &QPaintEvent::operator=(const QPaintEvent &other)

Attribue par copie l'other à cette instance d'QPaintEvent.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.