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 bietet eine gemeinsame QML-API für plattformeigene Dialoge.
Um einen nativen Dialog anzuzeigen, konstruieren Sie eine Instanz einer der konkreten Dialog-Implementierungen, setzen die gewünschten Eigenschaften und rufen open() auf. Dialog gibt accepted() oder rejected() aus, wenn der Benutzer mit dem Dialog fertig ist.
Hinweis: Es ist nicht garantiert, dass Typen in Qt.labs-Modulen in zukünftigen Versionen kompatibel bleiben.
Dokumentation der Eigenschaften
data : list<QtObject> [default]
Diese Standardeigenschaft enthält die Liste aller Objekte, die als Unterobjekte des Dialogs deklariert sind.
flags : Qt::WindowFlags
Diese Eigenschaft enthält die Fensterkennzeichen des Dialogs. Der Standardwert ist Qt.Dialog.
modality : Qt::WindowModality
Diese Eigenschaft enthält die Modalität des Dialogs. Der Standardwert ist Qt.WindowModal.
Verfügbare Werte:
| Konstante | Beschreibung |
|---|---|
Qt.NonModal | Das Dialogfeld ist nicht modal und blockiert keine Eingaben in anderen Fenstern. |
Qt.WindowModal | Das Dialogfeld ist modal für eine einzelne Fensterhierarchie und blockiert Eingaben für sein Elternfenster, alle Großelternfenster und alle Geschwister seiner Eltern- und Großelternfenster. |
Qt.ApplicationModal | Das Dialogfeld ist modal für die Anwendung und blockiert Eingaben in allen Fenstern. |
parentWindow : Window
Diese Eigenschaft enthält das übergeordnete Fenster des Dialogs.
Wenn nicht explizit festgelegt, wird das Fenster automatisch aufgelöst, indem die QML-Elternobjekte durchlaufen werden, bis ein Window oder ein Item gefunden wird, das ein Fenster hat.
result : int
Diese Eigenschaft enthält den Ergebniscode.
Standard-Ergebniscodes:
| Konstante | Wert |
|---|---|
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 Dialogs.
visible : bool
Diese Eigenschaft gibt die Sichtbarkeit des Dialogs an. Der Standardwert ist false.
Siehe auch open() und close().
Signal-Dokumentation
void accepted()
Dieses Signal wird ausgegeben, wenn der Dialog entweder interaktiv oder durch den Aufruf von accept() akzeptiert wurde.
Hinweis: Dieses Signal wird nicht ausgegeben, wenn der Dialog mit close() geschlossen wird.
Hinweis: Der entsprechende Handler ist onAccepted.
Siehe auch rejected().
void rejected()
Dieses Signal wird ausgegeben, wenn der Dialog entweder interaktiv oder durch den Aufruf von reject() abgelehnt wurde.
Hinweis: Dieses Signal wird nicht ausgegeben, wenn der Dialog mit close() geschlossen wird.
Hinweis: Der entsprechende Handler ist onRejected.
Siehe auch accepted().
Dokumentation der Methode
void accept()
Schließt den Dialog und gibt das Signal accepted() aus.
Siehe auch reject().
void close()
Schließt das Dialogfeld.
Siehe auch visible und open().
void done(int result)
Schließt den Dialog und setzt die result.
Siehe auch accept(), reject(), und result.
void open()
Öffnet das Dialogfeld.
Siehe auch visible und close().
void reject()
Schließt den Dialog und gibt 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.
