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
Detaillierte Beschreibung
Der Typ Dialog bietet eine gemeinsame QML-API für native Plattformdialoge. Für den nicht-nativen Dialog, siehe Dialog.
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: Dies ist ein interner Typ, der nicht in QML erstellt werden kann.
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.
Sofern 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.
popupType : enumeration [since 6.10]
Diese Eigenschaft kann verwendet werden, um die popupType des nicht-nativen Schnelldialogs zu ändern.
Die verfügbaren Werte sind:
| Konstante | Beschreibung |
|---|---|
Popup.Item | Das Dialogfeld erscheint als Element im Fenster des nächstgelegenen übergeordneten Elements. |
Popup.Window | Das Dialogfeld wird in einem eigenen Fenster angezeigt. |
Popup.Native | Dieser Wert wird nicht unterstützt. Stattdessen wird Popup.Window verwendet. |
Hinweis: Diese Eigenschaft hat keinen Effekt, wenn ein nativer Dialog verwendet wird.
Diese Eigenschaft wurde in Qt 6.10 eingeführt.
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: 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.
Dieses Signal wird auch beim Schließen des Dialogs mit close() ausgegeben.
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 den Dialog und sendet entweder das Signal accepted() oder rejected().
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.
