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 ダイアログは、ネイティブな実装が利用できないプラットフォームでは、フォールバックとしてQt Quick の実装を使用します。

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

buttons : flags

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

可能なフラグ

buttonClicked()も参照 。

detailedText : string

このプロパティは、詳細領域に表示されるテキストを保持する。

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

informativeText : string

このプロパティは、メッセージのより詳細な説明を提供する情報テキストを保持する。

インフォメーティブ・テキストは、text を拡張し、ユーザーに詳細な情報を提供するために使用できます。

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

text : string

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

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

シグナル・ドキュメント

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

このシグナルは、指定されたrole を持つbutton がクリックされたときに発せられます。

このシグナルにハンドラを与えることで、任意のカスタムボタンが押されたときに応答することができます。button の引数はどのボタンがクリックされたかを表し、role の引数はそのボタンの機能的な役割を表します。

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;
        }
    }
}

buttonsも参照してください 。