En esta página

QBackingStore Class

La clase QBackingStore proporciona un área de dibujo para QWindow. Más información...

Encabezado: #include <QBackingStore>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Funciones públicas

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

Descripción detallada

QBackingStore permite utilizar « QPainter » para dibujar en un « QWindow » de tipo «RasterSurface». La otra forma de renderizar en un « QWindow » es mediante el uso de OpenGL con « QOpenGLContext ».

Un QBackingStore contiene una representación almacenada en búfer del contenido de la ventana y, por lo tanto, admite actualizaciones parciales mediante el uso de « QPainter » para actualizar únicamente una subregión del contenido de la ventana.

QBackingStore puede ser utilizado por una aplicación que desee emplear QPainter sin aceleración OpenGL y sin la sobrecarga adicional que supone el uso de las pilas de interfaz de usuario QWidget o QGraphicsView. Para ver un ejemplo de cómo utilizar QBackingStore, consulte el ejemplo «Raster Window Example».

Documentación de las funciones de miembro

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

Crea una superficie vacía para el « window » de nivel superior indicado.

[noexcept] QBackingStore::~QBackingStore()

Destruye esta superficie.

void QBackingStore::beginPaint(const QRegion &region)

Comienza a pintar sobre la superficie de almacenamiento de fondo en el ` region` indicado.

Debes llamar a esta función antes de utilizar paintDevice() para dibujar.

Véanse también endPaint() y paintDevice().

void QBackingStore::endPaint()

Finaliza el proceso de pintura.

Debes llamar a esta función una vez que haya finalizado el proceso de dibujo con paintDevice().

Véase también beginPaint() y paintDevice().

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

Muestra en pantalla el « region » indicado a partir del « window » especificado.

La ventana « window » debe ser la ventana de nivel superior representada por este «backingstore», o bien una ventana hija no transitoria de dicha ventana. Si se pasa « nullptr », se recurre a la ventana de nivel superior del «backingstore».

Si ` window ` es una ventana secundaria, ` region ` debe estar en coordenadas de la ventana secundaria, y ` offset ` debe ser el desplazamiento de la ventana secundaria con respecto a la ventana de nivel superior del «backingstore».

Debes llamar a esta función tras finalizar el dibujo con ` endPaint()`.

QPlatformBackingStore *QBackingStore::handle() const

Devuelve un puntero a la implementación de QPlatformBackingStore

bool QBackingStore::hasStaticContents() const

Devuelve un valor booleano que indica si esta ventana tiene contenido estático o no.

QPaintDevice *QBackingStore::paintDevice()

Devuelve el dispositivo de dibujo de esta superficie.

Advertencia: El dispositivo solo es válido entre las llamadas a ` beginPaint()` y ` endPaint()`. No debes almacenar en caché el valor devuelto.

void QBackingStore::resize(const QSize &size)

Establece el tamaño de la superficie de la ventana en size.

Véase también size().

bool QBackingStore::scroll(const QRegion &area, int dx, int dy)

Desplaza el elemento area dx píxeles hacia la derecha y dy hacia abajo; tanto dx como dy pueden ser valores negativos.

Devuelve true si el área se ha desplazado correctamente; en caso contrario, devuelve false.

void QBackingStore::setStaticContents(const QRegion &region)

Establece region como contenido estático de esta ventana.

Véase también staticContents().

QSize QBackingStore::size() const

Devuelve el tamaño actual de la superficie de la ventana.

QRegion QBackingStore::staticContents() const

Devuelve un objeto ` QRegion ` que representa el área de la ventana que contiene contenido estático.

Véase también setStaticContents().

QWindow *QBackingStore::window() const

Devuelve un puntero a la ventana de nivel superior asociada a esta superficie.

© 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.