Dialog QML Type
ネイティブダイアログの基本クラスです。詳細...
| Import Statement: | import QtQuick.Dialogs |
| Since: | Qt 6.2 |
| Inherits: | |
| Inherited By: | ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog |
プロパティ
- data : list<QtObject>
- flags : Qt::WindowFlags
- modality : Qt::WindowModality
- parentWindow : Window
- popupType : enumeration
(since 6.10) - result : int
- title : string
- visible : bool
信号
方法
詳細な説明
Dialog型はネイティブプラットフォームダイアログに共通のQML APIを提供します。非ネイティブダイアログについてはDialog を参照してください。
ネイティブダイアログを表示するには、具体的なDialog実装のインスタンスを作成し、必要なプロパティを設定し、open ()を呼び出します。ユーザーがダイアログを終了すると、Dialogはaccepted() またはrejected() を呼び出します。
注意: これは内部型であり、QMLで作成することはできません。
プロパティのドキュメント
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の親オブジェクトを反復することにより自動的に解決されます。
popupType : enumeration [since 6.10]
このプロパティは、非ネイティブクイックダイアログのpopupType を変更するために使用することができます。
利用可能な値は以下の通りです:
| 定数 | 説明 |
|---|---|
Popup.Item | ダイアログは、最も近い親アイテムのウィンドウのアイテムとして表示されます。 |
Popup.Window | この値はサポートされていません。 |
Popup.Native | この値はサポートされていません。代わりにPopup.Window が使用されます。 |
注意: このプロパティは、ネイティブダイアログを使用している場合には効果がありません。
このプロパティは Qt 6.10 で導入されました。
result : int
このプロパティは結果コードを保持する。
標準的な結果コード:
| 定数 | 値 |
|---|---|
Dialog.Accepted | |
Dialog.Rejected |
注: MessageDialog は、標準結果コードを使用する代わりに、クリックされた標準ボタンの値に結果を設定します。
title : string
このプロパティはダイアログのタイトルを保持する。
visible : bool
このプロパティはダイアログの可視性を保持する。デフォルト値はfalse である。
シグナル・ドキュメント
void accepted()
このシグナルは、対話的に、あるいはaccept() を呼び出すことによって、ダイアログが受け入れられたときに発せられる。
注意: 対応するハンドラはonAccepted です。
rejected()も参照してください 。
void rejected()
このシグナルは、対話的に、またはreject() を呼び出すことによって、ダイアログが拒否されたときに発せられる。
このシグナルは、close() でダイアログを閉じるときにも発せられます。
注意: 対応するハンドラはonRejected です。
accepted()も参照してください 。
メソッドのドキュメント
void accept()
ダイアログを閉じ、accepted() シグナルを発する。
reject()も参照してください 。
void close()
ダイアログを閉じ、accepted() またはrejected() シグナルを発する。
void done(int result)
ダイアログを閉じ、result 。
void open()
ダイアログを開く。
void reject()
ダイアログを閉じ、rejected() シグナルを発する。
accept()も参照してください 。
© 2026 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.