Ejemplo de ventana rasterizada
Este ejemplo muestra cómo crear una aplicación mínima basada en « QWindow » utilizando « QPainter » para el renderizado.
Punto de entrada de la aplicación
int main(int argc, char **argv)
{
QGuiApplication app(argc, argv);
RasterWindow window;
window.show();
return app.exec();
}El punto de entrada de una aplicación basada en « QWindow » es la clase « QGuiApplication ». Esta gestiona el flujo de control y la configuración principal de la aplicación GUI. Pasamos los argumentos de la línea de comandos, que pueden utilizarse para seleccionar determinadas opciones de sistema.
A partir de ahí, creamos nuestra instancia de ventana y, a continuación, llamamos a la función ` QWindow::show()` para indicar al sistema de ventanas que esta ventana debe mostrarse ahora en pantalla.
Una vez hecho esto, entramos en el bucle de eventos de la aplicación para que esta pueda ejecutarse.
Declaración de RasterWindow
#include <QtGui>
#include <QScopedPointer>
class RasterWindow : public QWindow
{
Q_OBJECT
public:
explicit RasterWindow(QWindow *parent = nullptr);
virtual void render(QPainter *painter);
public slots:
void renderLater();
void renderNow();
protected:
bool event(QEvent *event) override;
void resizeEvent(QResizeEvent *event) override;
void exposeEvent(QExposeEvent *event) override;
private:
QScopedPointer<QBackingStore> m_backingStore;
};Empezamos incluyendo el encabezado ` <QtGui> `. Esto significa que podemos utilizar todas las clases del módulo ` Qt GUI `. Las clases también se pueden incluir individualmente si se prefiere.
La clase RasterWindow es una subclase directa de QWindow y proporciona un constructor que permite que la ventana sea una subventana de otra QWindow. Las QWindows sin padre aparecen en el sistema de ventanas como ventanas de nivel superior.
La clase declara un ` QBackingStore `, que es lo que utilizamos para gestionar el búfer de fondo de la ventana para gráficos basados en ` QPainter `.
La ventana rasterizada también se reutiliza en otros ejemplos y añade algunas funciones auxiliares, como renderLater().
Implementación de RasterWindow
RasterWindow::RasterWindow(QWindow *parent)
: QWindow(parent)
, m_backingStore(new QBackingStore(this))
{
setGeometry(100, 100, 300, 200);
}En el constructor creamos el backingstore y le pasamos la instancia de ventana que debe gestionar. También establecemos la geometría inicial de la ventana.
void RasterWindow::exposeEvent(QExposeEvent *)
{
if (isExposed())
renderNow();
}Poco después de llamar a ` QWindow::show()` en una ventana creada, se llamará a la función virtual ` QWindow::exposeEvent()` para notificarnos que la exposición de la ventana en el sistema de ventanas ha cambiado. El evento contiene la subregión expuesta, pero como de todos modos vamos a dibujar la ventana completa cada vez, no hacemos uso de ello.
La función QWindow::isExposed() nos indicará si la ventana está visible o no. Necesitamos esto, ya que exposeEvent también se invoca cuando la ventana queda oculta en el sistema de ventanas. Si la ventana está visible, llamamos a renderNow() para dibujarla inmediatamente. Queremos dibujarla de inmediato para poder presentar al sistema algún contenido visual.
void RasterWindow::resizeEvent(QResizeEvent *resizeEvent)
{
m_backingStore->resize(resizeEvent->size());
}Se garantiza que el evento de cambio de tamaño se invoca antes de que la ventana se muestre en pantalla y también se invocará cada vez que se cambie el tamaño de la ventana mientras está en pantalla. Utilizamos esto para ajustar el tamaño del búfer de fondo y aplazar el renderizado hasta el evento «expose» correspondiente o siguiente.
void RasterWindow::renderNow()
{
if (!isExposed())
return;
QRect rect(0, 0, width(), height());
m_backingStore->beginPaint(rect);
QPaintDevice *device = m_backingStore->paintDevice();
QPainter painter(device);
painter.fillRect(0, 0, width(), height(), QGradient::NightFade);
render(&painter);
painter.end();
m_backingStore->endPaint();
m_backingStore->flush(rect);
}La función `renderNow` configura lo necesario para que una ` QWindow ` renderice su contenido utilizando ` QPainter`. Dado que las ventanas ocultas no serán visibles, interrumpimos el proceso si la ventana no está expuesta en el sistema de ventanas. Esto puede ocurrir, por ejemplo, cuando otra ventana oculta por completo esta ventana.
Comenzamos el dibujo llamando a ` QBackingStore::beginPaint()` en la región que queremos dibujar. A continuación, obtenemos el ` QPaintDevice ` del búfer de fondo y creamos un ` QPainter ` para renderizar en ese dispositivo de pintura.
Para evitar que queden rastros del renderizado anterior y empezar con un búfer limpio, llenamos todo el búfer con el color blanco. A continuación, llamamos a la función virtual `render()`, que se encarga del dibujo propiamente dicho de esta ventana.
Una vez finalizado el dibujo, llamamos a endPaint() para indicar que hemos terminado de renderizar y presentamos el contenido en el búfer trasero mediante QBackingStore::flush().
void RasterWindow::render(QPainter *painter)
{
painter->drawText(QRectF(0, 0, width(), height()), Qt::AlignCenter, QStringLiteral("QWindow"));
}La función render contiene el código de dibujo de la ventana. En este ejemplo mínimo, solo dibujamos la cadena «QWindow » en el centro.
Renderizado asíncrono
void RasterWindow::renderLater()
{
requestUpdate();
}Hemos visto algunos casos en los que era necesario volver a dibujar la ventana de inmediato. Sin embargo, hay situaciones en las que esto no es deseable, sino que es preferible que la aplicación vuelva al bucle de eventos y programe la actualización para más tarde. Lo conseguimos solicitando una actualización mediante QWindow::requestUpdate(), que se ejecutará cuando el sistema esté listo para volver a dibujar la ventana.
bool RasterWindow::event(QEvent *event)
{
if (event->type() == QEvent::UpdateRequest) {
renderNow();
return true;
}
return QWindow::event(event);
}Reimplementamos la función virtual QObject::event() para gestionar el evento de actualización. Cuando se produce el evento, llamamos a renderNow() para renderizar la ventana de inmediato.
© 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.