Back to Qt.io
Contact Us Blog Download Qt

Dialog QML Type

標準的なボタンとタイトルを持つポップアップダイアログ。もっと見る...

Import Statement: import QtQuick.Controls
Inherits:

Popup

プロパティ

信号

方法

  • 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 とポップアップコントロールも参照してください 。

プロパティ Documentation

このプロパティは、ダイアログフッター項目を保持します。フッター項目は一番下に配置され、ダイアログの幅にリサイズされる。デフォルト値はnull です。

注 :DialogButtonBox をダイアログフッターとして割り当てると、自動的にそのaccepted() とrejected() のシグナルが Dialog のそれぞれのシグナルに接続されます。

注： DialogButtonBox 、ToolBar 、TabBar をダイアログフッターとして割り当てると、それぞれのDialogButtonBox::position 、ToolBar::position 、TabBar::position プロパティが自動的にFooter に設定されます。

headerも参照してください 。


header : Item

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

注 :DialogButtonBox をダイアログヘッダーとして割り当てると、自動的にそのaccepted() とrejected() のシグナルが Dialog のそれぞれのシグナルに接続されます。

注： DialogButtonBox 、ToolBar 、TabBar をダイアログヘッダーとして割り当てると、自動的にそれぞれのDialogButtonBox::position 、ToolBar::position 、TabBar::position プロパティがHeader に設定されます。

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)]

このプロパティは結果コードを保持します。

標準の結果コード：

定数説明
Dialog.Acceptedダイアログは受け入れられた。
Dialog.Rejectedダイアログは拒否されました。

このプロパティは 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")
}

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

可能なフラグ

定数説明
Dialog.OkAcceptRole で定義された "OK "ボタン。
Dialog.OpenAcceptRole で定義された「開く」ボタン。
Dialog.SaveAcceptRole で定義された「保存」ボタン。
Dialog.CancelRejectRole で定義された「キャンセル」ボタン。
Dialog.CloseRejectRole で定義された「閉じる」ボタン。
Dialog.Discardプラットフォームによって異なるが、DestructiveRole で定義された「破棄」または「保存しない」ボタン。
Dialog.ApplyApplyRole で定義された「適用」ボタン。
Dialog.ResetResetRole で定義された「リセット」ボタン。
Dialog.RestoreDefaultsResetRole で定義されている「デフォルトに戻す」ボタン。
Dialog.HelpHelpRole で定義された「ヘルプ」ボタン。
Dialog.SaveAllAcceptRole で定義された「すべて保存」ボタン。
Dialog.YesYesRole で定義された「はい」ボタン。
Dialog.YesToAllYesRole で定義された「Yes to All」ボタン。
Dialog.NoNoRole で定義された「いいえ」ボタン。
Dialog.NoToAllNoRole で定義された「No to All」ボタン。
Dialog.AbortRejectRole で定義された「中止」ボタン。
Dialog.RetryAcceptRole で定義される「再試行」ボタン。
Dialog.IgnoreAcceptRole で定義された「無視」ボタン。
Dialog.NoButton無効ボタン。

DialogButtonBoxも参照してください 。


title : string

このプロパティはダイアログのタイトルを保持します。

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

Dialog {
    title: qsTr("About")

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

シグナル ドキュメント

accepted()

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

注: このシグナルは、close() でダイアログを閉じるとき、またはvisible をfalse に設定するときには発行されません。

注意： 対応するハンドラはonAccepted です。

rejected()も参照してください 。


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

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

注: 対応するハンドラはonApplied です。

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

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


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

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

注: 対応するハンドラはonDiscarded です。

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

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


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

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

注: 対応するハンドラはonHelpRequested です。

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

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


rejected()

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

注意: このシグナルは、close() でダイアログを閉じるときや、visible をfalse に設定するときには発せられません。

注意: 対応するハンドラはonRejected です。

accepted()も参照してください 。


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

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

注: 対応するハンドラはonReset です。

このシグナルは 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も参照してください 。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.