Dialog QML Type
The base class of native dialogs. More...
| Import Statement: | import Qt.labs.platform 1.1 |
| Since: | Qt 5.8 |
| Inherits: | |
| Inherited By: | ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog |
Properties
- data : list<Object>
- flags : Qt::WindowFlags
- modality : Qt::WindowModality
- parentWindow : Window
- result : int
- title : string
- visible : bool
Signals
Methods
Detailed Description
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.
Property Documentation
[default] data : list<Object> |
This default property holds the list of all objects declared as children of the dialog.
This property holds the window flags of the dialog. The default value is Qt.Dialog.
This property holds the modality of the dialog. The default value is Qt.WindowModal.
Available values:
| Constant | Description |
|---|---|
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 |
result : int |
This property holds the result code.
Standard result codes:
| Constant | Value |
|---|---|
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 |
Signal Documentation
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().
Note: The corresponding handler is onAccepted.
See also 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().
Note: The corresponding handler is onRejected.
See also accepted().
Method Documentation
Closes the dialog and emits the accepted() signal.
See also reject().
void done(int result) |
Closes the dialog and emits the rejected() signal.
See also accept().