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