Класс QErrorMessage

Класс QErrorMessage предоставляет диалоговое окно для отображения сообщений об ошибках. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Открытые слоты

Статические открытые члены

Переопределенные защищенные функции

Подробное описание

Виджет сообщений об ошибках состоит из текстовой метки и флажка. Флажок позволяет пользователю управлять тем, будет ли то же сообщение об ошибке отображаться снова в будущем, обычно отображая текст «Показать это сообщение снова» переведённый на соответствующий язык.

Для приложений в производстве класс можно использовать для отображения сообщений, которые пользователю нужно видеть только один раз. Для использования 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 больше не отображались, эта функция ничего не делает.

Обычно сообщение отображается немедленно. Однако, если есть ожидающие сообщения, оно будет помещено в очередь для отображения позже.

Эта функция была введена в Qt 4.5.

См. также 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. Эта функция создаёт такой объект, если его ещё нет.