Dialog QML Type
Die Basisklasse für native Dialoge. Mehr...
| Import Statement: | import Qt.labs.platform |
| Inherits: | |
| Inherited By: | ColorDialog, FileDialog, FolderDialog, FontDialog, and MessageDialog |
| Status: | Deprecated since 6.11 |
Dieser Typ ist seit Qt Labs Platform 6.11 veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- data : list<QtObject>
- flags : Qt::WindowFlags
- modality : Qt::WindowModality
- parentWindow : Window
- result : int
- title : string
- visible : bool
Signale
Methoden
Ausführliche Beschreibung
Verwenden Sie stattdessen „ QtQuick.Dialogs Dialog “.
Der Typ „Dialog“ stellt eine einheitliche QML-API für native Plattformdialoge bereit.
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, wenn der Benutzer den Dialog geschlossen hat.
Hinweis: Es kann nicht garantiert werden, dass die Typen in Qt.labs-Modulen in zukünftigen Versionen kompatibel bleiben.
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 lautet „ 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.
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 das Dialogfeld 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()` bestätigt wurde.
Hinweis: Dieses Signal wird nicht ausgelöst, wenn der Dialog mit ` close()` geschlossen wird.
Hinweis: Der zugehörige 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.
Hinweis: Dieses Signal wird nicht 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.
Siehe auch visible und open().
void done(int result)
Schließt das Dialogfeld 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.