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 と同様に、ダイアログは3つのセクションで構成されています：header contentItem とfooter の3つのセクションで構成されています。

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

デフォルトでは、ダイアログはfocus を持ちます。

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

Dialogの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も参照してください 。