Dialog QML Type

標準的なボタンとタイトルを備えたポップアップダイアログ。ユーザーとの短時間のやり取りに使用されます。詳細...

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

プロパティ

• footer : Item
• header : Item
• implicitFooterHeight : real (since QtQuick.Controls 2.5 (Qt 5.12))
• implicitFooterWidth : real (since QtQuick.Controls 2.5 (Qt 5.12))
• implicitHeaderHeight : real (since QtQuick.Controls 2.5 (Qt 5.12))
• implicitHeaderWidth : real (since QtQuick.Controls 2.5 (Qt 5.12))
• result : int (since QtQuick.Controls 2.3 (Qt 5.10))
• standardButtons : enumeration
• title : string

信号

• accepted()
• applied() (since QtQuick.Controls 2.3 (Qt 5.10))
• discarded() (since QtQuick.Controls 2.3 (Qt 5.10))
• helpRequested() (since QtQuick.Controls 2.3 (Qt 5.10))
• rejected()
• reset() (since QtQuick.Controls 2.3 (Qt 5.10))

方法

• void accept()
• void done(int result) (since QtQuick.Controls 2.3 (Qt 5.10))
• void reject()
• AbstractButton standardButton(StandardButton button) (since QtQuick.Controls 2.3 (Qt 5.10))

詳細説明

ダイアログは、主に短期的なタスクやユーザーとの簡潔なやり取りに使用されるポップアップです。ApplicationWindow やPage と同様に、Dialog は 3 つのセクション（header 、contentItem 、footer ）で構成されています。

padding のプロパティは、contentItemにのみ影響します。ヘッダー、contentItem、フッター間のスペースを調整するには、spacing プロパティを使用します。

デフォルトでは、ダイアログには `focus` が設定されています。

ダイアログのタイトルとボタン

ダイアログのtitle は、デフォルトでダイアログのheader として割り当てられる、スタイル固有のタイトルバーによって表示されます。

ダイアログの標準ボタンは、デフォルトでダイアログのfooter として割り当てられているDialogButtonBox によって管理されます。ダイアログのstandardButtons プロパティは、ボタンボックスの対応するプロパティに転送されます。さらに、ボタンボックスのaccepted()およびrejected()シグナルは、Dialog内の対応するシグナルに接続されています。

Dialog {
    id: dialog
    title: "Title"
    standardButtons: Dialog.Ok | Dialog.Cancel

    onAccepted: console.log("Ok clicked")
    onRejected: console.log("Cancel clicked")
}

モーダルダイアログ

modal ダイアログは、ダイアログの下にある他のコンテンツへの入力をブロックします。モーダルダイアログが開かれている間、ユーザーはダイアログとの操作を完了し、ダイアログを閉じてからでないと、同じウィンドウ内の他のコンテンツにアクセスすることはできません。

Dialog {
    id: dialog
    modal: true
    standardButtons: Dialog.Ok
}

モーダルでないダイアログ

モーダルでないダイアログとは、ダイアログ周辺の他のコンテンツとは独立して動作するダイアログのことです。モーダルでないダイアログが開かれている間、ユーザーはダイアログと、同じウィンドウ内の他のコンテンツの両方と対話することができます。

Dialog {
    id: dialog
    modal: false
    standardButtons: Dialog.Ok
}

「 DialogButtonBox 」 および「ポップアップコントロール」も参照してください 。

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

footer : Item

このプロパティは、ダイアログのフッター項目を保持します。フッター項目は下部に配置され、ダイアログの幅に合わせてサイズが調整されます。デフォルト値はnull です。

headerも参照してください 。

header : Item

このプロパティは、ダイアログのヘッダー項目を保持します。ヘッダー項目は最上部に配置され、ダイアログの幅に合わせてサイズが調整されます。デフォルト値は `null` です。

footerも参照してください 。

implicitFooterHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

このプロパティは、暗黙的なフッターの高さを保持します。

値は `footer && footer.visible ? footer.implicitHeight : 0` に等しくなります。

このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

implicitFooterWidth およびimplicitHeaderHeightも参照してください 。

implicitFooterWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

このプロパティは、暗黙的なフッターの幅を保持します。

値は `footer && footer.visible ? footer.implicitWidth : 0` に等しくなります。

このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

implicitFooterHeight およびimplicitHeaderWidthも参照してください 。

implicitHeaderHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

このプロパティには、暗黙的なヘッダーの高さが格納されます。

その値は `header && header.visible ? header.implicitHeight : 0` に等しくなります。

このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

implicitHeaderWidth およびimplicitFooterHeightも参照してください 。

implicitHeaderWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

このプロパティは、暗黙的なヘッダーの幅を保持します。

その値は `header && header.visible ? header.implicitWidth : 0` に等しくなります。

このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

implicitHeaderHeight およびimplicitFooterWidthも参照してください 。

result : int [since QtQuick.Controls 2.3 (Qt 5.10)]

このプロパティには結果コードが格納されます。

標準の結果コード：

このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

accept()、reject()、およびdone()も参照してください 。

standardButtons : enumeration

このプロパティには、ダイアログで使用される標準ボタンの組み合わせが格納されています。

Dialog {
    id: dialog
    title: "Title"
    standardButtons: Dialog.Ok | Dialog.Cancel

    onAccepted: console.log("Ok clicked")
    onRejected: console.log("Cancel clicked")
}

ボタンは、ユーザーのプラットフォームに応じて適切な順序で配置されます。

使用可能なフラグ:

DialogButtonBoxも参照してください 。

title : string

このプロパティには、ダイアログのタイトルが格納されます。

このタイトルは、ダイアログのヘッダーに表示されます。

Dialog {
    title: qsTr("About")

    Label {
        text: "Lorem ipsum..."
    }
}

シグナルのドキュメント

accepted()

このシグナルは、対話的に、またはaccept()を呼び出すことによってダイアログが承認されたときに発火します。

関連項目： rejected()。

[since QtQuick.Controls 2.3 (Qt 5.10)] applied()

このシグナルは、Dialog.Apply の標準ボタンがクリックされたときに発生します。

このシグナルは、QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

discarded() およびreset()も参照してください 。

[since QtQuick.Controls 2.3 (Qt 5.10)] discarded()

このシグナルは、Dialog.Discard の標準ボタンがクリックされたときに発生します。

このシグナルは、QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

reset() およびapplied()も参照してください 。

[since QtQuick.Controls 2.3 (Qt 5.10)] helpRequested()

このシグナルは、Dialog.Help の標準ボタンがクリックされたときに発生します。

このシグナルは、QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

accepted() およびrejected()も参照してください 。

rejected()

このシグナルは、対話的に、あるいはreject()を呼び出すことによってダイアログが拒否されたときに発生します。

関連項目:accepted()も参照してください 。

[since QtQuick.Controls 2.3 (Qt 5.10)] reset()

このシグナルは、Dialog.Reset の標準ボタンがクリックされたときに発生します。

このシグナルは、QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

discarded() およびapplied()も参照してください 。

メソッドのドキュメント

void accept()

accepted() シグナルを発信し、ダイアログを閉じます。

reject() およびdone()も参照してください 。

[since QtQuick.Controls 2.3 (Qt 5.10)] void done(int result)

1. result を設定します。
2. 結果がDialog.Accepted かDialog.Rejected かによって、それぞれaccepted()またはrejected()を発行します。
3. closed() を発火します。

このメソッドは、QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

accept()、reject()、およびresultも参照してください 。

void reject()

rejected() シグナルを発行し、ダイアログを閉じます。

accept() およびdone()も参照してください 。

[since QtQuick.Controls 2.3 (Qt 5.10)] AbstractButton standardButton(StandardButton button)

指定された標準button を返します。存在しない場合はnull を返します。

このメソッドは、QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

standardButtonsも参照してください 。