QBackingStore Class
La classe QBackingStore fournit une zone de dessin pour QWindow. Plus...
| En-tête : | #include <QBackingStore> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
Fonctions publiques
| QBackingStore(QWindow *window) | |
| ~QBackingStore() | |
| void | beginPaint(const QRegion ®ion) |
| void | endPaint() |
| void | flush(const QRegion ®ion, QWindow *window = nullptr, const QPoint &offset = QPoint()) |
| QPlatformBackingStore * | handle() const |
| bool | hasStaticContents() const |
| QPaintDevice * | paintDevice() |
| void | resize(const QSize &size) |
| bool | scroll(const QRegion &area, int dx, int dy) |
| void | setStaticContents(const QRegion ®ion) |
| QSize | size() const |
| QRegion | staticContents() const |
| QWindow * | window() const |
Description détaillée
QBackingStore permet d'utiliser QPainter pour peindre sur une QWindow de type RasterSurface. L'autre façon d'effectuer un rendu sur QWindow est d'utiliser OpenGL avec QOpenGLContext.
Un QBackingStore contient une représentation en mémoire tampon du contenu de la fenêtre et prend donc en charge les mises à jour partielles en utilisant QPainter pour ne mettre à jour qu'une sous-région du contenu de la fenêtre.
QBackingStore peut être utilisé par une application qui souhaite utiliser QPainter sans accélération OpenGL et sans les frais généraux supplémentaires liés à l'utilisation des piles d'interface utilisateur QWidget ou QGraphicsView. Pour un exemple d'utilisation de QBackingStore, voir l'exemple de fenêtre matricielle.
Documentation des fonctions membres
[explicit] QBackingStore::QBackingStore(QWindow *window)
Construit une surface vide pour le niveau supérieur donné window.
[noexcept] QBackingStore::~QBackingStore()
Détruit cette surface.
void QBackingStore::beginPaint(const QRegion ®ion)
Commence à peindre sur la surface du magasin d'appui à l'adresse region.
Vous devez appeler cette fonction avant d'utiliser la fonction paintDevice() pour peindre.
Voir également endPaint() et paintDevice().
void QBackingStore::endPaint()
Termine la peinture.
Vous devez appeler cette fonction une fois que la peinture avec paintDevice() est terminée.
Voir également beginPaint() et paintDevice().
void QBackingStore::flush(const QRegion ®ion, QWindow *window = nullptr, const QPoint &offset = QPoint())
Affiche à l'écran le contenu de la fenêtre region à partir de la fenêtre window spécifiée.
L'adresse window doit être soit la fenêtre de premier niveau représentée par ce backingstore, soit un enfant non transitoire de cette fenêtre. Passer nullptr revient à utiliser la fenêtre de premier niveau du backingstore.
Si window est une fenêtre enfant, region doit être dans les coordonnées de la fenêtre enfant et offset doit être le décalage de la fenêtre enfant par rapport à la fenêtre de premier niveau du backingstore.
Vous devez appeler cette fonction après avoir terminé la peinture avec endPaint().
QPlatformBackingStore *QBackingStore::handle() const
Retourne un pointeur sur l'implémentation de QPlatformBackingStore
bool QBackingStore::hasStaticContents() const
Renvoie un booléen indiquant si cette fenêtre a un contenu statique ou non.
QPaintDevice *QBackingStore::paintDevice()
Renvoie le dispositif de peinture pour cette surface.
Attention : Le dispositif n'est valide qu'entre les appels à beginPaint() et endPaint(). Vous ne devez pas mettre en cache la valeur renvoyée.
void QBackingStore::resize(const QSize &size)
Fixe la taille de la surface de la fenêtre à size.
Voir également size().
bool QBackingStore::scroll(const QRegion &area, int dx, int dy)
Fait défiler la zone area dx pixels vers la droite et dy vers le bas ; dx et dy peuvent être négatifs.
Renvoie true si le défilement de la zone s'est déroulé correctement, false dans le cas contraire.
void QBackingStore::setStaticContents(const QRegion ®ion)
Définit region comme le contenu statique de cette fenêtre.
Voir aussi staticContents().
QSize QBackingStore::size() const
Renvoie la taille actuelle de la surface de la fenêtre.
QRegion QBackingStore::staticContents() const
Renvoie une adresse QRegion représentant la zone de la fenêtre dont le contenu est statique.
Voir aussi setStaticContents().
QWindow *QBackingStore::window() const
Renvoie un pointeur sur la fenêtre de premier niveau associée à cette surface.
© 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.
