QErrorMessage Class

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

Header: #include <QErrorMessage>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Inherits: 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)

再リンプルメント: (QEvent *event):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()も参照してください

©2024 The Qt Company Ltd. 本文書に含まれる寄稿文書の著作権は、各所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。