Back to Qt.io
Contact Us Blog Download Qt
En esta página

QPaintDeviceWindow Class

Conveniente subclase de QWindow que también es un QPaintDevice. Más...

Cabecera: #include <QPaintDeviceWindow>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Hereda: QWindow y QPaintDevice
Heredado por:

QOpenGLWindow y QRasterWindow

Funciones públicas

void update(const QRect &rect)
void update(const QRegion &region)

Ranuras públicas

void update()

Funciones protegidas reimplementadas

virtual void paintEvent(QPaintEvent *event) override

Descripción Detallada

QPaintDeviceWindow es como un QWindow normal, con la funcionalidad añadida de ser también un dispositivo de pintura. Cada vez que el contenido necesita ser actualizado, la función virtual paintEvent() es llamada. Las subclases que reimplementen esta función pueden simplemente abrir un QPainter en la ventana.

Nota: Esta clase no puede utilizarse directamente en las aplicaciones. Más bien sirve de base para subclases como QOpenGLWindow.

Véase también QOpenGLWindow.

Documentación de las funciones miembro

[override virtual protected] void QPaintDeviceWindow::paintEvent(QPaintEvent *event)

Reimplementa: QWindow::paintEvent(QPaintEvent *ev).

Maneja eventos de pintura pasados en el parámetro event.

La implementación por defecto no hace nada. Reimplemente esta función para pintar. Si es necesario, el área sucia es recuperable desde event.

[slot] void QPaintDeviceWindow::update()

Marca toda la ventana como sucia y programa un repintado.

Nota: Las llamadas posteriores a esta función antes del siguiente evento de pintado serán ignoradas.

Nota: Para ventanas no expuestas, la actualización se aplaza hasta que la ventana vuelva a estar expuesta.

Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        paintDeviceWindow, qOverload<>(&QPaintDeviceWindow::update));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        paintDeviceWindow, [receiver = paintDeviceWindow]() { receiver->update(); });
Para más ejemplos y enfoques, vea conectarse a ranuras sobrecargadas.

void QPaintDeviceWindow::update(const QRect &rect)

Marca la rect de la ventana como sucia y programa un repintado.

Nota: Las siguientes llamadas a esta función antes del siguiente evento de pintado serán ignoradas, pero rect se añade a la región a actualizar.

Nota: Para ventanas no expuestas la actualización se aplaza hasta que la ventana vuelva a estar expuesta.

void QPaintDeviceWindow::update(const QRegion &region)

Marca la region de la ventana como sucia y programa un repintado.

Nota: Las siguientes llamadas a esta función antes del siguiente evento de pintado serán ignoradas, pero region se añade a la región a actualizar.

Nota: Para ventanas no expuestas la actualización se aplaza hasta que la ventana vuelva a estar expuesta.

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