Класс QErrorMessage

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

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

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

• 8 открытых функций, унаследованных от QDialog
• 214 открытых функций, унаследованных от QWidget
• 34 открытых функций, унаследованных от QObject
• 14 открытых функций, унаследованных от QPaintDevice

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

• 5 открытых слотов, унаследованных от QDialog
• 19 открытых слотов, унаследованных от QWidget
• 1 открытый слот, унаследованный от QObject

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

• 5 статических открытых членов, унаследованных от QWidget
• 10 статических открытых членов, унаследованных от QObject

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

• 6 защищённых функций, унаследованных от QDialog
• 35 защищённых функций, унаследованных от QWidget
• 9 защищённых функций, унаследованных от QObject
• 1 защищённая функция, унаследованная от QPaintDevice

Дополнительные унаследованные члены

• 2 свойства, унаследованные от QDialog
• 59 свойств, унаследованных от QWidget
• 1 свойства, унаследованного от QObject
• 3 сигналов, унаследованных от QDialog
• 3 сигналов, унаследованных от QWidget
• 2 сигналов, унаследованных от QObject
• 1 открытой переменной, унаследованной от QObject
• 6 защищённых функций, унаследованных от QDialog
• 35 защищённых функций, унаследованных от QWidget
• 9 защищённых функций, унаследованных от QObject
• 1 защищённая функция, унаследованная от QPaintDevice
• 1 защищённый слот, унаследованный от QWidget
• 2 защищённых переменных, унаследованных от QObject
• 1 защищённый тип, унаследованный от QPaintDevice

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

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

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

Для приложений, выпускаемых в производство, класс можно использовать для отображения сообщений, которые пользователю нужно увидеть только один раз. Для использования QErrorMessage таким образом, создайте диалоговое окно обычным способом и отобразите его, вызвав слот showMessage() или подключив к нему сигналы.

Статическая функция qtHandler() устанавливает обработчик сообщений с помощью qInstallMessageHandler() и создаёт QErrorMessage, который отображает сообщения qDebug(), qWarning() и qFatal(). Это очень полезно в средах, где нет консоли для отображения предупреждений и сообщений об ошибках.

В обоих случаях QErrorMessage будет добавлять ожидающие сообщения в очередь и отображать их в порядке, при этом каждое новое сообщение будет отображаться, как только пользователь примет предыдущее. Как только пользователь укажет, что сообщение не должно отображаться снова, оно автоматически пропускается, и диалоговое окно отобразит следующее соответствующее сообщение в очереди.

Пример стандартных диалоговых окон демонстрирует использование QErrorMessage, а также других встроенных диалоговых окон Qt.

См. также QMessageBox, QStatusBar::showMessage() и Пример стандартных диалоговых окон.

Документация по членам функций

QErrorMessage::QErrorMessage(QWidget *parent = nullptr)

Создаёт и устанавливает окно обработчика ошибок с заданным parent.

[virtual] QErrorMessage::~QErrorMessage()

Удаляет диалоговое окно сообщений об ошибках.

[override virtual protected] void QErrorMessage::changeEvent(QEvent *e)

Переопределено из QWidget::changeEvent().

[override virtual protected] void QErrorMessage::done(int a)

Переопределено из QDialog::done().

[static] QErrorMessage *QErrorMessage::qtHandler()

Возвращает указатель на объект QErrorMessage, который выводит стандартные сообщения Qt. Эта функция создаёт такой объект, если его ещё нет.

[slot] void QErrorMessage::showMessage(const QString &message)

Отображает указанное сообщение, message, и возвращается немедленно. Если пользователь запросил, чтобы сообщение больше не отображалось, эта функция ничего не делает.

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

[slot] void QErrorMessage::showMessage(const QString &message, const QString &type)

Это перегруженная функция.

Отображает указанное сообщение, message, и возвращается немедленно. Если пользователь запросил, чтобы сообщения типа type больше не отображались, эта функция ничего не делает.

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

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

См. такжеshowMessage().