Класс 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.1/qerrormessage.html
