QErrorMessage Class

QErrorMessage クラスは、エラーメッセージ表示ダイアログを提供します。詳細...

ヘッダ #include <QErrorMessage>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
継承: QDialog

パブリック関数

QErrorMessage(QWidget *parent = nullptr)
virtual ~QErrorMessage()

パブリックスロット

void showMessage(const QString &message)
void showMessage(const QString &message, const QString &type)

静的パブリックメンバ

QErrorMessage *qtHandler()

再実装された保護された関数

virtual void changeEvent(QEvent *e) override
virtual void done(int a) override

詳細説明

エラーメッセージウィジェットは、テキストラベルとチェックボックスから構成されます。チェックボックスは、今後同じエラーメッセージを再度表示するかどうかをユーザが制御できるようにするもので、通常、適切なローカル言語に翻訳された "Show this message again" というテキストが表示されます。

プロダクション・アプリケーションでは、このクラスを使用して、ユーザが一度だけ見る必要のあるメッセージを表示することができます。QErrorMessage をこのように使用するには、通常の方法でダイアログを作成し、showMessage() スロットを呼び出すか、シグナルを接続してダイアログを表示します。

静的なqtHandler ()関数は、qInstallMessageHandler ()を使用してメッセージ・ハンドラをインストールし、qDebug ()、qWarning ()、qFatal ()メッセージを表示するQErrorMessageを作成します。これは、警告やエラー・メッセージを表示するコンソールがない環境で最も便利です。

どちらの場合も QErrorMessage は保留中のメッセージをキューに入れ、順番に表示します。ユーザがメッセージを再度表示しないように指定すると、そのメッセージは自動的にスキップされ、ダイアログはキュー内の次の適切なメッセージを表示します。

標準ダイアログの例では、Qt 組み込みの他のダイアログと同様に QErrorMessage を使用する方法を示しています。

QMessageBoxQStatusBar::showMessage()、Standard Dialogs Exampleも参照してください

メンバ関数のドキュメント

[explicit] QErrorMessage::QErrorMessage(QWidget *parent = nullptr)

与えられたparent でエラーハンドラウィンドウを構築し、インストールする。

ダイアログのデフォルトwindow modality はプラットフォームに依存する。ウィンドウのモダリティは、showMessage() を呼び出す前にsetWindowModality() でオーバーライドできます。

[virtual noexcept] 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()

デフォルトの Qt メッセージを出力するQErrorMessage オブジェクトへのポインタを返します。この関数は、そのようなオブジェクトがまだない場合、作成します。

このオブジェクトはQLoggingCategory::defaultCategory() のログメッセージのみを出力します。

このオブジェクトはすべてのメッセージを元のメッセージハンドラに転送します。

qInstallMessageHandlerも参照して ください。

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

与えられたメッセージを表示し、message 、すぐに戻る。ユーザがメッセージを再度表示しないように要求した場合、この関数は何もしません。

通常、メッセージはすぐに表示されます。しかし、保留中のメッセー ジがある場合は、後で表示されるようにキューに入れられます。

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

これはオーバーロードされた関数である。

与えられたメッセージmessage を表示し、すぐに戻ります。ユーザが、type のタイプのメッセージを再度表示しないように要求した場合、この関数は何もしません。

通常、メッセージはすぐに表示されます。しかし、保留中のメッセージがある場合は、後で表示されるようにキューに入れられます。

showMessage()も参照してください

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.