Dialog QML 类型

原生对话框的基类。更多...

导入语句	import QtQuick.Dialogs
自	Qt 6.2
继承	QtObject
由以下类继承	ColorDialog, FileDialog, FolderDialog, FontDialog, 和 MessageDialog

所有成员列表，包括继承成员

属性

data : list<QtObject>
flags : Qt::WindowFlags
modality : Qt::WindowModality
parentWindow : Window
result : int
title : string
visible : bool

信号

void accepted()
void rejected()

方法

void accept()
void close()
void done(int result)
void open()
void reject()

详细说明

Dialog 类型提供了原生平台对话框的常见 QML API。有关非原生对话框，请参阅 Dialog。

要显示原生对话框，构造一个Dialog的具体实现实例，设置所需的属性，并调用 open 方法。当用户完成对话框操作时，Dialog 会发出 accepted() 或 rejected()。

属性文档

data : list<QtObject> [默认]

此默认属性包含定义为对话框子对象的全部对象列表。

flags : Qt::WindowFlags

此属性包含对话框的窗口标志。默认值为 Qt.Dialog。

modality : Qt::WindowModality

此属性包含对话框的模式。默认值是 Qt.WindowModal。

可用的值

常量	描述
`Qt.NonModal`	对话框不是模态的，不阻止其他窗口的输入。
`Qt.WindowModal`	该对话框对单个窗口层次结构是模态的，并阻止对父窗口、所有祖父母的窗口以及父和祖父母窗口的兄弟窗口的输入。
`Qt.ApplicationModal`	该对话框对应用程序是模态的，并阻止对所有窗口的输入。

parentWindow : Window

此属性持有对话框的父窗口。

除非明确设置，否则窗口将通过迭代 QML 父对象直到找到 Window 或具有窗口的 Item 来自动解析。

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()。