MessageDialog QML Type

ネイティブメッセージダイアログ。もっと見る...

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

• 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()

詳細な説明

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() シグナルは、どのボタンがクリックされたかの情報を渡します。

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

• アンドロイド
• 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();
}

プロパティ Documentation

シグナル・ドキュメント