Auf dieser Seite

Dialog QML Type

Die Basisklasse für native Dialoge. Mehr...

Import Statement: import Qt.labs.platform
Inherits:

QtObject

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

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:

KonstanteBeschreibung
Qt.NonModalDer Dialog ist nicht modal und blockiert die Eingabe in anderen Fenstern nicht.
Qt.WindowModalDer 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.ApplicationModalDer 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:

KonstanteBeschreibung
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.