Класс QErrorMessage

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

QErrorMessage::QErrorMessage(QWidget *parent = Q_NULLPTR)

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

QErrorMessage::~QErrorMessage()

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

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

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

[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().