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

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

data : list<QtObject>
flags : Qt::WindowFlags
modality : Qt::WindowModality
parentWindow : Window
result : int
title : string
visible : bool

Signale

void accepted()
void rejected()

Methoden

void accept()
void close()
void done(int result)
void open()
void reject()

Detaillierte Beschreibung

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.

Eigenschaft Dokumentation

data : list<QtObject> [default]

Diese Standardeigenschaft enthält die Liste aller Objekte, die als Kinder des Dialogs deklariert sind.

flags : Qt::WindowFlags

Diese Eigenschaft enthält die Fenster-Flags 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`	Der Dialog ist modal für die Anwendung und blockiert Eingaben für alle Fenster.

parentWindow : Window

Diese Eigenschaft enthält das übergeordnete Fenster des Dialogs.

Wenn es nicht explizit gesetzt ist, 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 Standard-Schaltflä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() angenommen 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 den Dialog.

Siehe auch visible und open().

void done(int result)

Schließt den Dialog und setzt das Signal result.

Siehe auch accept(), reject(), und result.

void open()

Öffnet das Dialogfeld.

Siehe auch visible und close().

void reject()

Schließt das Dialogfeld und gibt das Signal rejected() aus.

Siehe auch accept().

© 2025 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.