MessageDialog QML Type

ネイティブのメッセージダイアログ。詳細...

この型は Qt Labs Platform 6.9 以降、非推奨となっています。新しいコードでの使用は強く推奨しません。

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• buttons : flags
• detailedText : string
• informativeText : string
• text : string

信号

• abortClicked()
• applyClicked()
• cancelClicked()
• clicked(button)
• closeClicked()
• discardClicked()
• helpClicked()
• ignoreClicked()
• noClicked()
• noToAllClicked()
• okClicked()
• openClicked()
• resetClicked()
• restoreDefaultsClicked()
• retryClicked()
• saveAllClicked()
• saveClicked()
• yesClicked()
• yesToAllClicked()

詳細説明

代わりにQtQuick.Dialogs MessageDialog を使用してください。

MessageDialog 型は、ネイティブプラットフォームのメッセージダイアログ用の QML API を提供します。

メッセージダイアログは、ユーザーに情報を通知したり、質問をしたりするために使用されます。 メッセージダイアログは、状況についてユーザーに警告するためのプライマリtext 、警告の詳細説明やユーザーへの質問を行うためのinformative text 、およびユーザーが要求した場合にさらに多くのデータを提供するためのオプションのdetailed text を表示します。また、メッセージボックスには、ユーザーの応答を受け付けるために、設定可能な一連のbuttons を表示することもできます。

メッセージダイアログを表示するには、MessageDialogのインスタンスを作成し、必要なプロパティを設定してから、open()を呼び出します。

MessageDialog {
    buttons: MessageDialog.Ok
    text: "The document has been modified."
}

ユーザーがメッセージダイアログを閉じるには、OK ボタンをクリックする必要があります。モーダルなメッセージダイアログは、メッセージが閉じられるまでGUIの他の操作をブロックします。

単にイベントをユーザーに通知するだけでなく、その対応についてユーザーに確認を求めるという、より精巧なアプローチもあります。質問内容をinformative text プロパティに格納し、buttons プロパティに、ユーザーの応答として希望するボタンのセットを指定します。ボタンは、ビット単位のOR演算子を使用して値を組み合わせることで指定されます。ボタンの表示順序はプラットフォームに依存します。

MessageDialog {
    text: "The document has been modified."
    informativeText: "Do you want to save your changes?"
    buttons: MessageDialog.Ok | MessageDialog.Cancel

    onAccepted: document.save()
}

clicked() シグナルは、どのボタンがクリックされたかという情報を渡します。

ネイティブのプラットフォームメッセージダイアログは、現在以下のプラットフォームで利用可能です：

• Android
• iOS
• macOS

Qt Labs Platform モジュールは、ネイティブの実装が利用できないプラットフォームにおいて、フォールバックとしてQt Widgets を使用します。したがって、Qt Labs Platform モジュールの型を使用するアプリケーションは、QtWidgets にリンクし、QGuiApplication の代わりにQApplication を使用する必要があります。

QtWidgets ライブラリに対してリンクするには、qmakeプロジェクトファイルに以下を追加してください:

QT += widgets

main() 内でQApplication のインスタンスを作成します:

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

「QtQuick.Dialogs::MessageDialog」も参照してください 。

プロパティのドキュメント

buttons : flags

このプロパティには、メッセージダイアログで使用されるボタンの組み合わせが格納されています。デフォルト値はMessageDialog.NoButton です。

使用可能なフラグ:

clicked()も参照してください 。

detailedText : string

このプロパティには、詳細エリアに表示されるテキストが格納されます。

「 text 」および「informativeText 」も参照してください 。

informativeText : string

このプロパティには、メッセージについてより詳しい説明を提供する説明文が格納されます。

説明文は、text を補足して、ユーザーにより多くの情報を提供するために使用できます。

「 text 」および「detailedText 」も参照してください 。

text : string

このプロパティには、メッセージダイアログに表示されるテキストが格納されます。

informativeText およびdetailedTextも参照してください 。

シグナルのドキュメント

abortClicked()

このシグナルは、Abort がクリックされたときに発生します。

applyClicked()

このシグナルは、Apply がクリックされたときに発生します。

cancelClicked()

このシグナルは、Cancel がクリックされたときに発せられます。

clicked(button)

このシグナルは、ダイアログbutton がクリックされたときに発生します。

「buttons」も参照してください 。

closeClicked()

このシグナルは、Close がクリックされたときに発生します。

discardClicked()

このシグナルは、Discard がクリックされたときに発火します。

helpClicked()

このシグナルは、Help がクリックされたときに発生します。

ignoreClicked()

このシグナルは、Ignore がクリックされたときに発生します。

noClicked()

このシグナルは、No がクリックされたときに発生します。

noToAllClicked()

このシグナルは、No To All がクリックされたときに発生します。

okClicked()

このシグナルは、Ok がクリックされたときに発生します。

openClicked()

このシグナルは、Open がクリックされたときに発生します。

resetClicked()

このシグナルは、Reset がクリックされたときに発生します。

restoreDefaultsClicked()

このシグナルは、Restore Defaults がクリックされたときに発生します。

retryClicked()

このシグナルは、Retry がクリックされたときに発生します。

saveAllClicked()

このシグナルは、Save All がクリックされたときに発生します。

saveClicked()

このシグナルは、Save がクリックされたときに発生します。

yesClicked()

このシグナルは、Yes がクリックされたときに発生します。

yesToAllClicked()

このシグナルは、Yes To All がクリックされたときに発生します。