Класс QErrorMessage

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

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

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

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

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

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

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

• 5 статических открытых членов, унаследованных от QWidget
• 11 статических открытых членов, унаследованных от 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 = 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().