En esta página

QSplashScreen Class

El widget QSplashScreen ofrece una pantalla de bienvenida que se puede mostrar durante el inicio de la aplicación. Más información...

Encabezado: #include <QSplashScreen>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QWidget

Funciones públicas

QSplashScreen(const QPixmap &pixmap = QPixmap(), Qt::WindowFlags f = Qt::WindowFlags())
QSplashScreen(QScreen *screen, const QPixmap &pixmap = QPixmap(), Qt::WindowFlags f = Qt::WindowFlags())
virtual ~QSplashScreen()
void finish(QWidget *mainWin)
QString message() const
const QPixmap pixmap() const
void repaint()
void setPixmap(const QPixmap &pixmap)

Ranuras públicas

void clearMessage()
void showMessage(const QString &message, int alignment = Qt::AlignLeft, const QColor &color = Qt::black)

Señales

void messageChanged(const QString &message)

Funciones protegidas

virtual void drawContents(QPainter *painter)

Funciones protegidas reimplementadas

virtual bool event(QEvent *e) override
virtual void mousePressEvent(QMouseEvent *) override

Descripción detallada

Una pantalla de inicio es un widget que suele mostrarse al iniciar una aplicación. Las pantallas de inicio se utilizan a menudo en aplicaciones cuyo tiempo de arranque es prolongado (por ejemplo, aplicaciones de bases de datos o de red que tardan en establecer conexiones) para indicar al usuario que la aplicación se está cargando.

La pantalla de inicio aparece en el centro de la pantalla. Puede resultar útil añadir la bandera « Qt::WindowStaysOnTopHint » a las banderas de ventana del widget de la pantalla de inicio si se desea que esta permanezca por encima de todas las demás ventanas del escritorio.

Algunos gestores de ventanas de X11 no admiten el indicador «permanecer en primer plano». Una solución consiste en configurar un temporizador que llame periódicamente a raise() en la pantalla de inicio para simular el efecto de «permanecer en primer plano».

El uso más habitual es mostrar una pantalla de bienvenida antes de que el widget principal aparezca en pantalla. Esto se ilustra en el siguiente fragmento de código, en el que se muestra una pantalla de bienvenida y se realizan algunas tareas de inicialización antes de que aparezca la ventana principal de la aplicación:

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QPixmap pixmap(":/splash.png");
    QSplashScreen splash(pixmap);
    splash.show();
    app.processEvents();
    //...
    QMainWindow window;
    window.show();
    splash.finish(&window);
    return app.exec();
}

El usuario puede ocultar la pantalla de inicio haciendo clic sobre ella con el ratón. Para que el manejo del ratón funcione, llama a ` QApplication::processEvents()` periódicamente durante el inicio.

A veces resulta útil actualizar la pantalla de inicio con mensajes, por ejemplo, para anunciar conexiones establecidas o módulos cargados a medida que se inicia la aplicación:

QPixmap pixmap(":/splash.png");
QSplashScreen *splash = new QSplashScreen(pixmap);
splash->show();

... // Loading some items
splash->showMessage("Loaded modules");

QCoreApplication::processEvents();

... // Establishing connections
splash->showMessage("Established connections");

QCoreApplication::processEvents();

QSplashScreen permite hacerlo mediante la función ` showMessage()`. Si deseas realizar tu propio dibujo, puedes obtener un puntero al mapa de píxeles utilizado en la pantalla de inicio con ` pixmap()`. Como alternativa, puedes crear una subclase de `QSplashScreen` y reimplementar ` drawContents()`.

En caso de tener varias pantallas, también es posible mostrar la pantalla de inicio en una pantalla distinta a la principal. Por ejemplo:

QScreen *screen = QGuiApplication::screens().at(1);
QPixmap pixmap(":/splash.png");
QSplashScreen splash(screen, pixmap);
splash.show();

Documentación de las funciones miembro

[explicit] QSplashScreen::QSplashScreen(const QPixmap &pixmap = QPixmap(), Qt::WindowFlags f = Qt::WindowFlags())

Crea una pantalla de inicio que muestre pixmap.

No debería ser necesario configurar los indicadores del widget, f, salvo quizá Qt::WindowStaysOnTopHint.

QSplashScreen::QSplashScreen(QScreen *screen, const QPixmap &pixmap = QPixmap(), Qt::WindowFlags f = Qt::WindowFlags())

Esta función te permite especificar la pantalla en la que se mostrará la pantalla de bienvenida. El uso habitual de este constructor es cuando tienes varias pantallas y prefieres que la pantalla de bienvenida se muestre en una pantalla distinta a la principal. En ese caso, pasa el valor adecuado a screen.

Esta es una función sobrecargada.

[virtual noexcept] QSplashScreen::~QSplashScreen()

Destructor.

[slot] void QSplashScreen::clearMessage()

Elimina el mensaje que se muestra en la pantalla de inicio

Véase también showMessage().

[virtual protected] void QSplashScreen::drawContents(QPainter *painter)

Dibuja el contenido de la pantalla de inicio utilizando el programa « painter ». La implementación predeterminada dibuja el mensaje pasado por la función showMessage(). Reimplementa esta función si deseas dibujar tu propio contenido en la pantalla de inicio.

[override virtual protected] bool QSplashScreen::event(QEvent *e)

Reimplementa: ` QWidget::event(QEvent *event)`.

void QSplashScreen::finish(QWidget *mainWin)

Hace que la pantalla de inicio espere a que se muestre el widget mainWin antes de llamar a close() sobre sí misma.

QString QSplashScreen::message() const

Devuelve el mensaje que se muestra actualmente en la pantalla de inicio.

Véase también showMessage() y clearMessage().

[signal] void QSplashScreen::messageChanged(const QString &message)

Esta señal se emite cuando cambia el mensaje de la pantalla de bienvenida. « message » es el nuevo mensaje y es una cadena nula cuando se ha eliminado el mensaje.

Véase también showMessage() y clearMessage().

[override virtual protected] void QSplashScreen::mousePressEvent(QMouseEvent *)

Reimplementa: ` QWidget::mousePressEvent(QMouseEvent *event)`.

const QPixmap QSplashScreen::pixmap() const

Devuelve el mapa de píxeles que se utiliza en la pantalla de inicio. La imagen no contiene ningún texto dibujado mediante las llamadas a showMessage().

Véase también setPixmap().

void QSplashScreen::repaint()

Esto sobrescribe la función ` QWidget::repaint()`. Se diferencia de la función de repintado estándar en que también llama a ` QCoreApplication::processEvents()` para garantizar que se muestren las actualizaciones, incluso cuando no haya ningún bucle de eventos activo.

void QSplashScreen::setPixmap(const QPixmap &pixmap)

Establece el mapa de píxeles que se utilizará como imagen de la pantalla de inicio en pixmap.

Véase también pixmap().

[slot] void QSplashScreen::showMessage(const QString &message, int alignment = Qt::AlignLeft, const QColor &color = Qt::black)

Dibuja el texto « message » en la pantalla de inicio con el color color y alinea el texto según los indicadores de alignment. Esta función llama a repaint() para garantizar que la pantalla de inicio se actualice inmediatamente. De este modo, el mensaje se mantiene actualizado con lo que está haciendo la aplicación (por ejemplo, cargar archivos).

Véase también Qt::Alignment, clearMessage() y message().

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