内容

• 特性
• 信号
• 方法
• 详细描述

Dialog QML Type

The base class of native dialogs. 更多...

import 语句：	import QtQuick.Dialogs
Since:	Qt 6.2
继承：	QtObject
继承者：	FileDialog and FontDialog

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

特性

• data : list<Object>
• flags : Qt::WindowFlags
• modality : Qt::WindowModality
• parentWindow : Window
• result : StandardCode
• title : string
• visible : bool

信号

• void accepted ()
• void rejected ()

方法

• void accept ()
• void close ()
• void done (StandardCode result )
• void open ()
• void reject ()

详细描述

The Dialog type provides common QML API for native platform dialogs.

To show a native dialog, construct an instance of one of the concrete Dialog implementations, set the desired properties, and call open() . Dialog emits accepted() or rejected() when the user is done with the dialog.

特性文档编制

[default] data : list < 对象 >

This default property holds the list of all objects declared as children of the dialog.

flags : Qt::WindowFlags

This property holds the window flags of the dialog. The default value is Qt.Dialog .

modality : Qt::WindowModality

This property holds the modality of the dialog. The default value is Qt.WindowModal .

Available values:

常量	描述
Qt.NonModal	The dialog is not modal and does not block input to other windows.
Qt.WindowModal	The dialog is modal to a single window hierarchy and blocks input to its parent window, all grandparent windows, and all siblings of its parent and grandparent windows.
Qt.ApplicationModal	The dialog is modal to the application and blocks input to all windows.

parentWindow : Window

This property holds the parent window of the dialog.

Unless explicitly set, the window is automatically resolved by iterating the QML parent objects until a Window 或 Item that has a window is found.

result : StandardCode

This property holds the result code.

Standard result codes:

常量	值
Dialog.Accepted
Dialog.Rejected

注意： MessageDialog sets the result to the value of the clicked standard button instead of using the standard result codes.

title : string

This property holds the title of the dialog.

visible : bool

This property holds the visibility of the dialog. The default value is false .

另请参阅 open() and close() .

信号文档编制

void accepted ()

This signal is emitted when the dialog has been accepted either interactively or by calling accept() .

注意： This signal is not emitted when closing the dialog with close() .

注意： 相应处理程序是 onAccepted .

另请参阅 rejected() .

void rejected ()

This signal is emitted when the dialog has been rejected either interactively or by calling reject() .

注意： This signal is not emitted when closing the dialog with close() .

注意： 相应处理程序是 onRejected .

另请参阅 accepted() .

方法文档编制

void accept ()

Closes the dialog and emits the accepted() 信号。

另请参阅 reject() .

void close ()

Closes the dialog.

另请参阅 visible and open() .

void done ( StandardCode result )

Closes the dialog and sets the result .

另请参阅 accept() , reject() ，和 result .

void open ()

Opens the dialog.

另请参阅 visible and close() .

void reject ()

Closes the dialog and emits the rejected() 信号。

另请参阅 accept() .