En esta página

QBackingStore Class

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

Cabecera: #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 el uso de QPainter para pintar sobre un QWindow con tipo RasterSurface. La otra forma de renderizar en un QWindow es mediante el uso de OpenGL con QOpenGLContext.

Un QBackingStore contiene una representación en búfer del contenido de la ventana y, por tanto, admite actualizaciones parciales utilizando QPainter para actualizar sólo una subregión del contenido de la ventana.

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

Documentación de las funciones miembro

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

Construye una superficie vacía para el nivel superior window.

[noexcept] QBackingStore::~QBackingStore()

Destruye esta superficie.

void QBackingStore::beginPaint(const QRegion &region)

Comienza a pintar sobre la superficie del almacén de fondo en el region dado.

Debe llamar a esta función antes de utilizar paintDevice() para pintar.

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

void QBackingStore::endPaint()

Finaliza el pintado.

Debe llamar a esta función después de que haya terminado el pintado con paintDevice().

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

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

Descarga el region dado desde el window especificado en la pantalla.

El window debe ser la ventana de nivel superior representada por este backingstore, o un hijo no transitorio de esa ventana. Si se pasa nullptr, se vuelve a utilizar la ventana de nivel superior del almacén de respaldo.

Si window es una ventana hija, region debe estar en coordenadas de la ventana hija, y offset debe ser el desplazamiento de la ventana hija en relación con la ventana de nivel superior de la tienda de apoyo.

Debe llamar a esta función después de terminar de pintar con endPaint().

QPlatformBackingStore *QBackingStore::handle() const

Devuelve un puntero a la implementación de QPlatformBackingStore

bool QBackingStore::hasStaticContents() const

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

QPaintDevice *QBackingStore::paintDevice()

Devuelve el dispositivo de pintura para esta superficie.

Advertencia: El dispositivo sólo es válido entre llamadas a beginPaint() y endPaint(). No debe 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 área dada area dx píxeles hacia la derecha y dy hacia abajo; tanto dx como dy pueden ser negativos.

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

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 QRegion que representa el área de la ventana que tiene 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.