Back to Qt.io
Contact Us Blog Download Qt

Dialog QML Type

ネイティブダイアログの基本クラスです。詳細...

Import Statement: import QtQuick.Dialogs
Since: Qt 6.2
Inherits:

QtObject

Inherited By:

ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog

プロパティ

信号

方法

詳細な説明

Dialog型はネイティブプラットフォームダイアログに共通のQML APIを提供します。非ネイティブダイアログについてはDialog を参照してください。

ネイティブダイアログを表示するには、具体的なDialog実装のインスタンスを作成し、必要なプロパティを設定し、open （）を呼び出します。ユーザーがダイアログを終了すると、Dialogはaccepted() またはrejected() を発行します。

プロパティ Documentation

data : list<QtObject> [default]

このデフォルトのプロパティは、ダイアログの子として宣言されたすべてのオブジェクトのリストを保持します。


flags : Qt::WindowFlags

このプロパティはダイアログのウィンドウフラグを保持する。デフォルト値はQt.Dialog である。


modality : Qt::WindowModality

このプロパティはダイアログのモダリティを保持します。デフォルト値はQt.WindowModal です。

利用可能な値

定数説明
Qt.NonModalダイアログはモーダルではなく、他のウィンドウへの入力をブロックしない。
Qt.WindowModalダイアログは単一のウィンドウ階層に対してモーダルで、その親ウィンドウ、すべての祖父母ウィンドウ、およびその親と祖父母ウィンドウのすべての兄弟ウィンドウへの入力をブロックします。
Qt.ApplicationModalダイアログはアプリケーションに対してモーダルであり、すべてのウィンドウへの入力をブロックする。

parentWindow : Window

このプロパティはダイアログの親ウィンドウを保持する。

明示的に設定されない限り、ウィンドウは、ウィンドウを持つWindow またはItem が見つかるまで、QMLの親オブジェクトを反復することによって自動的に解決されます。


result : int

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

標準的な結果コードです：

定数値
Dialog.Accepted
Dialog.Rejected

注: MessageDialog は、標準結果コードを使用する代わりに、クリックされた標準ボタンの値を結果に設定します。


title : string

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


visible : bool

このプロパティはダイアログの可視性を保持します。デフォルト値はfalse です。

open() およびclose()も参照してください 。


シグナル ドキュメント

void accepted()

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

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

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


void rejected()

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

このシグナルは、close() でダイアログを閉じるときにも発せられます。

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

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


メソッドの説明

void accept()

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

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


void close()

ダイアログを閉じ、accepted() またはrejected() シグナルを送出します。

visible およびopen() も参照 。


void done(int result)

ダイアログを閉じ、result を設定します。

accept()、reject()、result も参照 。


void open()

ダイアログを開く。

visible およびclose() も参照して ください。


void reject()

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

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


© 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.