Dialog QML Type

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

import 语句：	import QtQuick.Dialogs
Since:	Qt 6.2
继承：	QtObject
继承者：	ColorDialog , FileDialog , FolderDialog , FontDialog ，和 MessageDialog

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

特性

data : list<QtObject>
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. For the non-native dialog, see Dialog .

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 () 或 rejected () when the user is done with the dialog.

特性文档编制

[default] data : list < QtObject >

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 () 和 close ().

信号文档编制

void accepted ()

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

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

另请参阅 rejected ().

void rejected ()

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

This signal is also emitted when closing the dialog with close ().

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

另请参阅 accepted ().

方法文档编制

void accept ()

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

另请参阅 reject ().

void close ()

Closes the dialog and emits either the accepted () 或 rejected () 信号。

另请参阅 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 ().