Dialog QML Type

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

Import Statement: import Qt.labs.platform 1.0
开始支持版本: Qt 5.8
基类:

QtObject

派生类:

ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog

属性

信号

方法

详细描述

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.

Note: Types in Qt.labs modules are not guaranteed to remain compatible in future versions.

属性

[default] data : list<Object>

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:

ConstantDescription
Qt.NonModalThe dialog is not modal and does not block input to other windows.
Qt.WindowModalThe 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.ApplicationModalThe 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 or an Item that has a window is found.


result : int

This property holds the result code.

Standard result codes:

ConstantValue
Dialog.Accepted
Dialog.Rejected

Note: 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().

Note: This signal is not emitted when closing the dialog with close().

参见 rejected().


void rejected()

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

Note: This signal is not emitted when closing the dialog with close().

参见 accepted().


成员

void accept()

Closes the dialog and emits the accepted() signal.

参见 reject().


void close()

Closes the dialog.

参见 visible and open().


void done(int result)

Closes the dialog and sets the result.

参见 accept(), reject(), and result.


void open()

Opens the dialog.

参见 visible and close().


void reject()

Closes the dialog and emits the rejected() signal.

参见 accept().