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.

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); }); [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); }); 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.