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