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

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

• アンドロイド
• 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 がクリックされたときに発せられる。