MessageDialog QML Type

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

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

プロパティ

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

シグナル

• buttonClicked(QPlatformDialogHelper::StandardButton button, QPlatformDialogHelper::ButtonRole role)

詳細な説明

MessageDialog型はメッセージダイアログのためのQML APIを提供します。

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

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

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

メッセージ・ダイアログを閉じるには、OK ボタンをクリックする必要があります。

ユーザーにイベントを警告するだけでなく、より手の込んだアプローチとして、ユーザーにそのイベントに対して何をすべきかを尋ねることもできます。質問を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()
}

利用可能性

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

• アンドロイド
• iOS
• macOS

Qt Quick Dialogs は、ネイティブな実装が利用できないプラットフォームでは、フォールバックとして Qt Quick の実装を使用します。

プロパティ Documentation

シグナル・ドキュメント

MessageDialog {
    id: dialog
    text: qsTr("The document has been modified.")
    informativeText: qsTr("Do you want to save your changes?")
    buttons: MessageDialog.Ok | MessageDialog.Cancel
    onButtonClicked: function (button, role) {
        switch (button) {
        case MessageDialog.Ok:
            document.save()
            break;
        }
    }
}