このページでは

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.