Класс QErrorMessage

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

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

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

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

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

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

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

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

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

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

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

• 2 свойства, унаследованные от QDialog
• 59 свойств, унаследованных от QWidget
• 1 свойство, унаследованное от QObject
• 3 сигналов, унаследованных от QDialog
• 3 сигналов, унаследованных от QWidget
• 2 сигналов, унаследованных от QObject
• 6 защищенных функций, унаследованных от 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 = 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().