このページでは

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() を呼び出します。

注意: これは内部型であり、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 である。

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()も参照してください

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