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