En esta página

QErrorMessage Class

La clase QErrorMessage proporciona un cuadro de diálogo para mostrar mensajes de error. Más información...

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

Funciones públicas

QErrorMessage(QWidget *parent = nullptr)
virtual ~QErrorMessage()

Ranuras públicas

void showMessage(const QString &message)
void showMessage(const QString &message, const QString &type)

Miembros públicos estáticos

QErrorMessage *qtHandler()

Funciones protegidas reimplementadas

virtual void changeEvent(QEvent *e) override
virtual void done(int a) override

Descripción detallada

Un widget de mensaje de error consta de una etiqueta de texto y una casilla de selección. La casilla de selección permite al usuario controlar si se volverá a mostrar el mismo mensaje de error en el futuro; normalmente muestra el texto «Mostrar este mensaje de nuevo» traducido al idioma local correspondiente.

En aplicaciones de producción, la clase se puede utilizar para mostrar mensajes que el usuario solo necesita ver una vez. Para utilizar QErrorMessage de esta forma, se crea el cuadro de diálogo de la forma habitual y se muestra llamando a la ranura showMessage() o conectando señales a ella.

La función estática ` qtHandler()` instala un gestor de mensajes mediante ` qInstallMessageHandler()` y crea un `QErrorMessage` que muestra mensajes del tipo ` qDebug()`, ` qWarning()` y ` qFatal()`. Esto resulta especialmente útil en entornos en los que no se dispone de una consola para mostrar mensajes de advertencia y de error.

En ambos casos, `QErrorMessage` pondrá en cola los mensajes pendientes y los mostrará en orden, de modo que cada nuevo mensaje se mostrará tan pronto como el usuario haya aceptado el mensaje anterior. Una vez que el usuario haya indicado que un mensaje no debe volver a mostrarse, este se omitirá automáticamente y el cuadro de diálogo mostrará el siguiente mensaje correspondiente de la cola.

El ejemplo «Diálogos estándar» muestra cómo utilizar QErrorMessage, así como otros diálogos integrados de Qt.

Cuadro de diálogo con un mensaje de error relacionado con la red

Véase también ` QMessageBox` , ` QStatusBar::showMessage()` y el ejemplo «Diálogos estándar».

Documentación de las funciones de miembro

[explicit] QErrorMessage::QErrorMessage(QWidget *parent = nullptr)

Crea e instala una ventana de gestión de errores con el parent especificado.

El valor predeterminado de « window modality » del cuadro de diálogo depende de la plataforma. La modalidad de la ventana se puede anular mediante « setWindowModality()» antes de llamar a « showMessage()».

[virtual noexcept] QErrorMessage::~QErrorMessage()

Cierra el cuadro de diálogo del mensaje de error.

[override virtual protected] void QErrorMessage::changeEvent(QEvent *e)

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

[override virtual protected] void QErrorMessage::done(int a)

Reimplementa: ` QDialog::done` (int r).

[static] QErrorMessage *QErrorMessage::qtHandler()

Devuelve un puntero a un objeto ` QErrorMessage ` que muestra los mensajes predeterminados de Qt. Esta función crea dicho objeto, si aún no existe uno.

El objeto solo mostrará los mensajes de registro de QLoggingCategory::defaultCategory().

El objeto reenviará todos los mensajes al gestor de mensajes original.

Véase también qInstallMessageHandler.

[slot] void QErrorMessage::showMessage(const QString &message)

Muestra el mensaje indicado, « message », y vuelve inmediatamente. Si el usuario ha solicitado que el mensaje no vuelva a mostrarse, esta función no realiza ninguna acción.

Normalmente, el mensaje se muestra de inmediato. Sin embargo, si hay mensajes pendientes, se pondrá en cola para mostrarse más tarde.

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

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        errorMessage, qOverload(&QErrorMessage::showMessage));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        errorMessage, [receiver = errorMessage](const QString &message) { receiver->showMessage(message); });
Para ver más ejemplos y formas de hacerlo, consulta la sección «Conexión a ranuras sobrecargadas».

[slot] void QErrorMessage::showMessage(const QString &message, const QString &type)

Muestra el mensaje indicado, message, y vuelve inmediatamente. Si el usuario ha solicitado que los mensajes del tipo type no se vuelvan a mostrar, esta función no realiza ninguna acción.

Normalmente, el mensaje se muestra de inmediato. Sin embargo, si hay mensajes pendientes, se pondrá en cola para mostrarse más tarde.

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

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        errorMessage, qOverload(&QErrorMessage::showMessage));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        errorMessage, [receiver = errorMessage](const QString &message, const QString &type) { receiver->showMessage(message, type); });
Para ver más ejemplos y enfoques, consulta la sección sobre cómo conectarse a ranuras sobrecargadas.

Véase también ` showMessage()`.

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