Dialog QML Type
Die Basisklasse für native Dialoge. Mehr...
| Import Statement: | import QtQuick.Dialogs |
| Since: | Qt 6.2 |
| Inherits: | |
| Inherited By: | ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog |
Eigenschaften
- data : list<QtObject>
- flags : Qt::WindowFlags
- modality : Qt::WindowModality
- parentWindow : Window
- popupType : enumeration
(since 6.10) - result : int
- title : string
- visible : bool
Signale
Methoden
Ausführliche Beschreibung
Der Typ „Dialog“ stellt eine gemeinsame QML-API für native Plattformdialoge bereit. Informationen zu nicht-nativen Dialogen finden Sie unter Dialog.
Um einen nativen Dialog anzuzeigen, erstellen Sie eine Instanz einer der konkreten „Dialog“-Implementierungen, legen Sie die gewünschten Eigenschaften fest und rufen Sie „ open()“ auf. Der Dialog löst „ accepted()“ oder „ rejected()“ aus, sobald der Benutzer den Dialog geschlossen hat.
Hinweis: Dies ist ein interner Typ, der in QML nicht erstellt werden kann.
Dokumentation zu den Eigenschaften
data : list<QtObject> [default]
Diese Standardeigenschaft enthält die Liste aller Objekte, die als untergeordnete Elemente des Dialogfelds deklariert wurden.
flags : Qt::WindowFlags
Diese Eigenschaft enthält die Fensterflags des Dialogfelds. Der Standardwert lautet „ Qt.Dialog “.
modality : Qt::WindowModality
Diese Eigenschaft gibt die Modalität des Dialogfelds an. Der Standardwert ist „ Qt.WindowModal “.
Mögliche Werte:
| Konstante | Beschreibung |
|---|---|
Qt.NonModal | Der Dialog ist nicht modal und blockiert die Eingabe in anderen Fenstern nicht. |
Qt.WindowModal | Der Dialog ist für eine einzelne Fensterhierarchie modal und blockiert die Eingabe in sein übergeordnetes Fenster, alle übergeordneten Fenster sowie alle gleichrangigen Fenster seines übergeordneten Fensters und der übergeordneten Fenster. |
Qt.ApplicationModal | Der Dialog ist für die Anwendung modal und blockiert die Eingabe in alle Fenster. |
parentWindow : Window
Diese Eigenschaft enthält das übergeordnete Fenster des Dialogfelds.
Sofern nicht explizit festgelegt, wird das Fenster automatisch ermittelt, indem die übergeordneten QML-Objekte durchlaufen werden, bis ein „ Window “ oder ein „ Item “ gefunden wird, das über ein Fenster verfügt.
popupType : enumeration [since 6.10]
Mit dieser Eigenschaft kann die „ popupType “ des nicht-nativen Schnelldialogs geändert werden.
Die verfügbaren Werte sind:
| Konstante | Beschreibung |
|---|---|
Popup.Item | Der Dialog wird als Element im Fenster des nächstübergeordneten Elements angezeigt. |
Popup.Window | Der Dialog wird in einem eigenen Fenster angezeigt. |
Popup.Native | Dieser Wert wird nicht unterstützt. Stattdessen wird „ Popup.Window “ verwendet.Hinweis: Diese Eigenschaft hat bei Verwendung eines nativen Dialogfelds keine Auswirkung. |
Diese Eigenschaft wurde in Qt 6.10 eingeführt.
result : int
Diese Eigenschaft enthält den Ergebniscode.
Standard-Ergebniscodes:
| Konstante | Beschreibung |
|---|---|
Dialog.Accepted | |
Dialog.Rejected | Hinweis: „ MessageDialog “ setzt das Ergebnis auf den Wert der angeklickten Standardschaltfläche, anstatt die Standard-Ergebniscodes zu verwenden. |
title : string
Diese Eigenschaft enthält den Titel des Dialogfelds.
visible : bool
Diese Eigenschaft legt fest, ob der Dialog sichtbar ist. Der Standardwert lautet „ false “.
Siehe auch „ open()“ und „ close()“.
Signal-Dokumentation
void accepted()
Dieses Signal wird ausgelöst, wenn der Dialog entweder interaktiv oder durch den Aufruf von accept() akzeptiert wurde.
Hinweis: Der entsprechende Handler ist ` onAccepted`.
Siehe auch ` rejected()`.
void rejected()
Dieses Signal wird ausgelöst, wenn der Dialog entweder interaktiv oder durch den Aufruf von ` reject()` geschlossen wurde.
Dieses Signal wird ebenfalls ausgelöst, wenn der Dialog mit ` close()` geschlossen wird.
Hinweis: Der entsprechende Handler ist ` onRejected`.
Siehe auch ` accepted()`.
Methodendokumentation
void accept()
Schließt das Dialogfeld und löst das Signal „ accepted()“ aus.
Siehe auch „ reject()“.
void close()
Schließt das Dialogfeld und löst entweder das Signal „ accepted()“ oder „ rejected()“ aus.
Siehe auch „ visible “ und „ open “ ().
void done(int result)
Schließt den Dialog und legt die Eigenschaft „ result “ fest.
Siehe auch „ accept()“, „ reject()“ und „ result “.
void open()
Öffnet das Dialogfeld.
Siehe auch visible und close().
void reject()
Schließt das Dialogfeld und löst das Signal „ rejected()“ aus.
Siehe auch „ accept()“.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
