Sur cette page

QBackingStore Class

La classe QBackingStore fournit une zone de dessin pour QWindow. En savoir 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 &region)
void endPaint()
void flush(const QRegion &region, 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 &region)
QSize size() const
QRegion staticContents() const
QWindow *window() const

Description détaillée

QOpenGLContextQBackingStore permet d’utiliser l’ QPainter pour dessiner sur une surface de type RasterSurface ( QWindow ). L’autre méthode de rendu sur une surface de type RasterSurface ( QWindow ) consiste à utiliser OpenGL avec l’ .

Un QBackingStore contient une représentation mise 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 souhaitant recourir à QPainter sans accélération OpenGL et sans la surcharge supplémentaire liée à l’utilisation des piles d’interface utilisateur QWidget ou QGraphicsView. Pour un exemple d’utilisation de QBackingStore, consultez l’exemple « Raster Window ».

Documentation des fonctions membres

[explicit] QBackingStore::QBackingStore(QWindow *window)

Crée une surface vide pour l'window de niveau supérieur indiquée.

[noexcept] QBackingStore::~QBackingStore()

Détruit cette surface.

void QBackingStore::beginPaint(const QRegion &region)

Commence à dessiner sur la surface de stockage de fond selon l'region.

Vous devez appeler cette fonction avant d'utiliser la fonction ` paintDevice()` pour dessiner.

Voir également endPaint() et paintDevice().

void QBackingStore::endPaint()

Fin du dessin.

Vous devez appeler cette fonction une fois que le dessin avec la fonction paintDevice() est terminé.

Voir également beginPaint() et paintDevice().

void QBackingStore::flush(const QRegion &region, QWindow *window = nullptr, const QPoint &offset = QPoint())

Affiche à l'écran l'region donné à partir de l'window spécifié.

L'window doit être soit la fenêtre de niveau supérieur représentée par ce backingstore, soit un enfant non transitoire de cette fenêtre. Si l'nullptr est passé, le système utilise par défaut la fenêtre de niveau supérieur du backingstore.

Si l’ window est une fenêtre enfant, l’ region doit être exprimée en coordonnées de la fenêtre enfant, et l’ offset doit correspondre au décalage de la fenêtre enfant par rapport à la fenêtre de niveau supérieur du backingstore.

Vous devez appeler cette fonction après avoir terminé le dessin avec ` endPaint()`.

QPlatformBackingStore *QBackingStore::handle() const

Renvoie un pointeur vers l'implémentation de QPlatformBackingStore

bool QBackingStore::hasStaticContents() const

Renvoie une valeur booléenne indiquant si cette fenêtre contient ou non du contenu statique.

QPaintDevice *QBackingStore::paintDevice()

Renvoie le périphérique de dessin associé à cette surface.

Avertissement : le périphérique 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)

Définit 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 l'area donnée de dx pixels vers la droite et de dy vers le bas ; les valeurs dx et dy peuvent être négatives.

Renvoie true si le défilement de la zone a réussi ; false dans le cas contraire.

void QBackingStore::setStaticContents(const QRegion &region)

Définir region comme contenu statique de cette fenêtre.

Voir également staticContents().

QSize QBackingStore::size() const

Renvoie la taille actuelle de la surface de la fenêtre.

QRegion QBackingStore::staticContents() const

Renvoie un objet ` QRegion ` représentant la zone de la fenêtre contenant du contenu statique.

Voir aussi setStaticContents().

QWindow *QBackingStore::window() const

Renvoie un pointeur vers la fenêtre de niveau supérieur 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.