Класс QErrorMessage
Класс QErrorMessage предоставляет диалоговое окно для отображения сообщений об ошибках. Подробнее...
| Заголовок: | #include <QErrorMessage> |
| CMake: | find_package(Qt6 COMPONENTS Widgets REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Наследует: | QDialog |
Открытые функции
| QErrorMessage(QWidget *parent = nullptr) | |
| virtual | ~QErrorMessage() |
Открытые слоты
| void | showMessage(const QString &message, const QString &type) |
| void | showMessage(const QString &message) |
Статические открытые члены
| QErrorMessage * | qtHandler() |
Переопределённые защищённые функции
| virtual void | changeEvent(QEvent *e) override |
| virtual void | done(int a) override |
Подробное описание
Виджет сообщений об ошибках состоит из текстовой метки и флажка. Флажок позволяет пользователю управлять тем, будет ли то же сообщение об ошибке отображаться снова в будущем, обычно отображая текст «Показать это сообщение снова», переведённый на соответствующий язык.
Для приложений, предназначенных для выпуска, класс можно использовать для отображения сообщений, которые пользователю нужно увидеть только один раз. Для использования QErrorMessage таким образом создайте диалоговое окно обычным способом и отобразите его, вызвав слот showMessage() или подключив сигналы к нему.
Статическая функция qtHandler() устанавливает обработчик сообщений с помощью qInstallMessageHandler() и создаёт QErrorMessage, который отображает сообщения qDebug(), qWarning() и qFatal(). Это наиболее полезно в средах, где нет консоли для отображения предупреждений и сообщений об ошибках.
В обоих случаях QErrorMessage будет очередировать ожидающие сообщения и отображать их в порядке, причём каждое новое сообщение отображается сразу после того, как пользователь принял предыдущее. После того, как пользователь указал, что сообщение больше не должно отображаться, оно автоматически пропускается, и диалоговое окно отобразит следующее соответствующее сообщение в очереди.
Пример стандартных диалоговых окон демонстрирует, как использовать QErrorMessage, а также другие встроенные диалоговые окна Qt.
См. также QMessageBox, QStatusBar::showMessage() и Пример стандартных диалоговых окон.
Документация по функциям-членам
QErrorMessage::QErrorMessage(QWidget *parent = nullptr)
Создаёт и устанавливает окно обработчика ошибок с заданным parent.
[slot] void QErrorMessage::showMessage(const QString &message, const QString &type)
Это перегруженная функция.
Отображает указанное сообщение, message, и возвращается немедленно. Если пользователь запросил, чтобы сообщения типа type не отображались снова, эта функция ничего не делает.
Обычно сообщение отображается немедленно. Однако, если есть ожидающие сообщения, оно будет помещено в очередь для отображения позже.
См. также showMessage().
[slot] void QErrorMessage::showMessage(const QString &message)
Отображает заданное сообщение, message, и возвращается немедленно. Если пользователь запросил, чтобы сообщение не отображалось снова, эта функция ничего не делает.
Обычно сообщение отображается немедленно. Однако, если есть ожидающие сообщения, оно будет помещено в очередь для отображения позже.
[virtual] QErrorMessage::~QErrorMessage()
Удаляет диалоговое окно сообщений об ошибках.
[override virtual protected] void QErrorMessage::changeEvent(QEvent *e)
Переопределяет: QWidget::changeEvent(QEvent *event).
[override virtual protected] void QErrorMessage::done(int a)
Переопределяет: QDialog::done(int r).
[static] QErrorMessage *QErrorMessage::qtHandler()
Возвращает указатель на объект QErrorMessage, который выводит стандартные сообщения Qt. Эта функция создаёт такой объект, если он ещё не существует.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qerrormessage.html
